Google Chat API . users . sections . items

close()

Close httplib2 connections.

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists items in a section. Only spaces can be section items. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections` - `https://www.googleapis.com/auth/chat.users.sections.readonly`

Args:
  parent: string, Required. The parent, which is the section resource name that owns this collection of section items. Only supports listing section items for the calling user. When you're filtering by space, use the wildcard `-` to search across all sections. For example, `users/{user}/sections/-`. Format: `users/{user}/sections/{section}` (required)
  filter: string, Optional. A query filter. Currently only supports filtering by space. For example, `space = spaces/{space}`. Invalid queries are rejected with an `INVALID_ARGUMENT` error.
  pageSize: integer, Optional. The maximum number of section items to return. The service may return fewer than this value. If unspecified, at most 10 section items will be returned. The maximum value is 100. If you use a value more than 100, it's automatically changed to 100. Negative values return an `INVALID_ARGUMENT` error.
  pageToken: string, Optional. A page token, received from a previous list section items call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for listing section items.
  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  "sectionItems": [ # The section items from the specified section.
    { # A user's defined section item. This is used to represent section items, such as spaces, grouped under a section.
      "name": "A String", # Identifier. The resource name of the section item. Format: `users/{user}/sections/{section}/items/{item}`
      "space": "A String", # Optional. The space resource name. Format: `spaces/{space}`
    },
  ],
}

list_next()

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.
        

move(name, body=None, x__xgafv=None)

Moves an item from one section to another. For example, if a section contains spaces, this method can be used to move a space to a different section. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections`

Args:
  name: string, Required. The resource name of the section item to move. Format: `users/{user}/sections/{section}/items/{item}` (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for moving a section item across sections.
  "targetSection": "A String", # Required. The resource name of the section to move the section item to. Format: `users/{user}/sections/{section}`
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for moving a section item.
  "sectionItem": { # A user's defined section item. This is used to represent section items, such as spaces, grouped under a section. # The updated section item.
    "name": "A String", # Identifier. The resource name of the section item. Format: `users/{user}/sections/{section}/items/{item}`
    "space": "A String", # Optional. The space resource name. Format: `spaces/{space}`
  },
}