GrooveSpaces.Read Operation
The Read operation reads the visible workspaces for the Groove identity. (See Accessing Workspaces Exclusively Through Web Services for information on visible and invisible workspaces.) If you specify a workspace type, the operation returns only workspaces of that type. If you do not specify a type, the operation returns information about all workspaces except for Groove File Sharing workspaces. To access both visible and invisible workspaces, use the Read2 operation.
HTTP Post URL
The HTTP Post URL targets the service for the identity. This URI is provided by the GrooveAccounts.Read2 operation in the Identity.Spaces element.
Input Message Header
GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.
Input Message Parameters
<SpaceType />
Element | Data type | Description |
---|---|---|
SpaceType |
|
URN that specifies the workspace type. If you specify an empty string, the operation reads the generic Groove workspaces. |
SpaceType URN values | Description |
---|---|
urn:groove.net:Groove.Core.Tools.System.TelespaceTypes.Generic |
Generic Groove workspace; this is the default value. |
urn:groove.net:Groove.Core.Tools.System.TelespaceTypes.GFS |
Groove File Sharing workspace. |
Output Message Header
GrooveResponseHeader specifies the Response key.
Return Value
<ReadResult>
<!-- Array of --> <Space />
</ReadResult>
Element | Data type | Description |
---|---|---|
ReadResult |
Array of Space |
Describes the workspace. The ReadResult array can contain zero or more Space elements. |
Remarks
Note that if you are getting information about Groove File Sharing workspaces, the return value contains an empty string for the Tools element. You cannot access the GrooveTools service or a GrooveFiles service in a Groove File Sharing workspace.
See Also
Reference
GrooveSpaces Web Service
GrooveSpaces.ReadSpace Operation