Method: users.sections.position | Google Chat | Google for Developers (original) (raw)

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

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

Parameters
name	string Required. The resource name of the section to position.Format: users/{user}/sections/{section}

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 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.

Requires the following OAuth scope:

For more information, see the Authorization guide.

The position of the section.