Method: users.sections.position

Changes the sort order of a section. For details, see Create & organize sections in Google Chat.

Requires user authentication with the authorization scope:

  • https://www.googleapis.com/auth/chat.users.sections

HTTP request

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The resource name of the section to position.

Format: users/{user}/sections/{section}

Request body

The request body contains data with the following structure:

JSON representation 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
Fields
Union field position. Required. The new position of the section. position can be only one of the following:
sortOrder

integer

Optional. The absolute position of the section in the list of sections. The position must be greater than 0. If the position is greater than the number of sections, the section will be appended to the end of the list. This operation inserts the section at the given position and shifts the original section at that position, and those below it, to the next position.
relativePosition

enum (Position)

Optional. The relative position of the section in the list of sections.

Response body

Response message for positioning a section.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "section": {
    object (Section)
  }
}
Fields
section

object (Section)

The updated section.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chat.users.sections

For more information, see the Authorization guide.

Position

The position of the section.

Enums
POSITION_UNSPECIFIED Unspecified position.
START Start of the list of sections.
END End of the list of sections.