Orkut API . communityMessages

Instance Methods

delete(communityId, topicId, messageId)

Moves a message of the community to the trash folder.

insert(communityId, topicId, body)

Adds a message to a given community topic.

list(communityId, topicId, pageToken=None, hl=None, maxResults=None)

Retrieves the messages of a topic of a community.

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

delete(communityId, topicId, messageId)
Moves a message of the community to the trash folder.

Args:
  communityId: integer, The ID of the community whose message will be moved to the trash folder. (required)
  topicId: string, The ID of the topic whose message will be moved to the trash folder. (required)
  messageId: string, The ID of the message to be moved to the trash folder. (required)
insert(communityId, topicId, body)
Adds a message to a given community topic.

Args:
  communityId: integer, The ID of the community the message should be added to. (required)
  topicId: string, The ID of the topic the message should be added to. (required)
  body: object, The request body. (required)
    The object takes the form of:

{
    "body": "A String", # The body of the message.
    "kind": "orkut#communityMessage", # Identifies this resource as a community message. Value: "orkut#communityMessage"
    "links": [ # List of resources for the community message.
      { # Links to resources related to the parent object.
        "href": "A String", # URL of the link.
        "type": "A String", # Media type of the link.
        "rel": "A String", # Relation between the resource and the parent object.
        "title": "A String", # Title of the link.
      },
    ],
    "author": { # The creator of the message. If ommited, the message is annonimous.
      "url": "A String", # The URL of the author who posted the comment [not yet implemented]
      "image": { # Image data about the author.
        "url": "A String", # A URL that points to a thumbnail photo of the author.
      },
      "displayName": "A String", # The name of the author, suitable for display.
      "id": "A String", # Unique identifier of the person who posted the comment. This is the person's OpenSocial ID.
    },
    "id": "A String", # The ID of the message.
    "addedDate": "A String", # The timestamp of the date when the message was added, in RFC 3339 format.
    "isSpam": True or False, # Whether this post was marked as spam by the viewer, when he/she is not the community owner or one of its moderators.
    "subject": "A String", # The subject of the message.
  }


Returns:
  An object of the form:

    {
      "body": "A String", # The body of the message.
      "kind": "orkut#communityMessage", # Identifies this resource as a community message. Value: "orkut#communityMessage"
      "links": [ # List of resources for the community message.
        { # Links to resources related to the parent object.
          "href": "A String", # URL of the link.
          "type": "A String", # Media type of the link.
          "rel": "A String", # Relation between the resource and the parent object.
          "title": "A String", # Title of the link.
        },
      ],
      "author": { # The creator of the message. If ommited, the message is annonimous.
        "url": "A String", # The URL of the author who posted the comment [not yet implemented]
        "image": { # Image data about the author.
          "url": "A String", # A URL that points to a thumbnail photo of the author.
        },
        "displayName": "A String", # The name of the author, suitable for display.
        "id": "A String", # Unique identifier of the person who posted the comment. This is the person's OpenSocial ID.
      },
      "id": "A String", # The ID of the message.
      "addedDate": "A String", # The timestamp of the date when the message was added, in RFC 3339 format.
      "isSpam": True or False, # Whether this post was marked as spam by the viewer, when he/she is not the community owner or one of its moderators.
      "subject": "A String", # The subject of the message.
    }
list(communityId, topicId, pageToken=None, hl=None, maxResults=None)
Retrieves the messages of a topic of a community.

Args:
  communityId: integer, The ID of the community which messages will be listed. (required)
  topicId: string, The ID of the topic which messages will be listed. (required)
  pageToken: string, A continuation token that allows pagination.
  hl: string, Specifies the interface language (host language) of your user interface.
  maxResults: integer, The maximum number of messages to include in the response.

Returns:
  An object of the form:

    {
    "nextPageToken": "A String", # The value of pageToken query parameter in community_messages.list request to get the next page, if there are more to retrieve.
    "kind": "orkut#communityMessageList", # Identifies this resource as a collection of community messages. Value: "orkut#communityMessageList"
    "items": [ # List of messages retrieved.
      {
          "body": "A String", # The body of the message.
          "kind": "orkut#communityMessage", # Identifies this resource as a community message. Value: "orkut#communityMessage"
          "links": [ # List of resources for the community message.
            { # Links to resources related to the parent object.
              "href": "A String", # URL of the link.
              "type": "A String", # Media type of the link.
              "rel": "A String", # Relation between the resource and the parent object.
              "title": "A String", # Title of the link.
            },
          ],
          "author": { # The creator of the message. If ommited, the message is annonimous.
            "url": "A String", # The URL of the author who posted the comment [not yet implemented]
            "image": { # Image data about the author.
              "url": "A String", # A URL that points to a thumbnail photo of the author.
            },
            "displayName": "A String", # The name of the author, suitable for display.
            "id": "A String", # Unique identifier of the person who posted the comment. This is the person's OpenSocial ID.
          },
          "id": "A String", # The ID of the message.
          "addedDate": "A String", # The timestamp of the date when the message was added, in RFC 3339 format.
          "isSpam": True or False, # Whether this post was marked as spam by the viewer, when he/she is not the community owner or one of its moderators.
          "subject": "A String", # The subject of the message.
        },
    ],
    "prevPageToken": "A String", # The value of pageToken query parameter in community_messages.list request to get the previous page, if there are more to retrieve.
    "lastPageToken": "A String", # The value of pageToken query parameter in community_messages.list request to get the last page.
    "firstPageToken": "A String", # The value of pageToken query parameter in community_messages.list request to get the first page.
  }
list_next(previous_request, previous_response)
Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.