Hi,

I've been using the Google Provisioning API since 1.1.3.0 when we were using 
Email Lists rather than Groups. The Email List methods were deprecated in 
favour of Groups, but as far as I can tell the .NET developer's guide is 
misleading when it comes to retrieving group information. I've seen posts 
from 2009 regarding the mythical GroupFeed object in .NET and either it 
still hasn't been implemented in the API (or at least I can't find it) or 
the documentation has been incorrect or at least misleading all this time. 
For example consider the sections on retrieving a group 
(AppsService.Groups.RetrieveGroup), all groups for a member 
(AppsService.Groups.RetrieveGroups) and all groups in a domain 
(AppsService.Groups.RetrieveAllGroups), the guide states:

"Retrieving a Group
To retrieve information about a group using the .NET client library, call 
the following method. We assume service is an authenticated AppsService 
object. This method returns a GroupFeed XML response, which the .NET client 
library converts to a GroupFeed object."

"Retrieving all Groups for a Member
To retrieve all of the groups that a user is a recipient of, you can call 
the following method in the .NET client library. We assume service is an 
authenticated AppsService object. This method returns a GroupFeed XML 
response, which the .NET client library converts to a GroupFeed object."

"Retrieving all Groups in a Domain
To retrieve all of the groups in a domain, you can call the following method 
in the .NET client library. We assume service is an authenticated 
AppsService object. This method returns a GroupFeed XML response, which the 
.NET client library converts to a GroupFeed object."

This sounds like there should be a Google.<blah blah blah>.GroupFeed type, 
and if that was the intention then the documentation is incorrect. However 
if the author intended "GroupFeed object" to refer to a theoretical instance 
of the actual generic types then I'd say it was misleading.

Also, all of these methods are portrayed as returning the same type which is 
not the case. Only the RetrieveGroups and RetrieveAllGroups methods return a 
feed object, more precisely a Google.GData.Apps.AppsExtendedFeed object. The 
RetrieveGroup method returns a Google.GData.Apps.AppsExtendedEntry object.

So I'm asking if the documentation could be corrected/made clear with 
respect to these points and perhaps either explain how group information is 
retrieved from these AppsExtended objects or link to somewhere that does? 
I'm sure this would help developers in future.

Regards,
David McMurray.

-- 
You received this message because you are subscribed to the Google Groups 
"Google Apps Domain Information and Management APIs" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/google-apps-mgmt-apis/-/iaWQqmDSbIYJ.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/google-apps-mgmt-apis?hl=en.

Reply via email to