GrooveMessages.Read Operation
The Read operation reads all messages in the requested category in the message store for the account. The returned messages may be associated with any of the account's identities. The returned messages always include headers. Optionally, they may also include the contents and attachments. The content is returned as plain text.
HTTP Post URL
The HTTP Post URL targets the service for the account. This URI is returned by the GrooveAccounts.Read2 operation in the Messages 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
<Read>
<IncludeContent />
<IncludeAttachments />
<MarkMessagesOpened />
<Category />
</Read>
Element | Data type | Description |
---|---|---|
IncludeContent |
|
Include the content of each returned message. |
IncludeAttachments |
|
Include the attachment of each returned message. |
MarkMessagesOpened |
|
If true, changes the category of New messages to Opened. This change is made immediately after the messages are read. Thus messages that were New at the time of the command are returned as New, not Opened, but if you read the messages again they will be marked as Opened. Messages with the Sent or Opened category are not affected. |
Category |
An enumerated value that specifies the messages to retrieve. Can be one of the following categories:
|
Output Message Header
GrooveResponseHeader specifies the Response key.
Return Value
<ReadResult>
<!-- Array of --> <Message />
</ReadResult>
Element | Data type | Description |
---|---|---|
ReadResult |
Array of Message |
Messages returned. The ReadResult array can contain zero or more Message elements. |
Remarks
The retrieved messages can be marked as being opened by setting MarkMessageOpened to True. To retrieve a single message by its URI, see ReadMessage.
Note
User code should make no assumptions about the order of the returned messages. The order is implementation-dependent and may change in future releases.
Note
In the WSDL definition for this operation, the IncludeContent, IncludeAttachments, MarkMessagesOpened, and Category parameters are defined as optional parameters. Because of a limitation in the way Groove Web Services handle optional parameters, you should always specify these optional parameters. If you do omit one parameter, you must also omit all parameters that follow the omitted one. In the .NET proxy code, you specify that optional parameters are include by setting the IncludeContentSpecified, IncludeAttachmentsSpecified, MarkMessagesOpenedSpecified, and CategorySpecified parameters to true.