v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1330180264.7 KB
users

Updates a section. Only sections of type CUSTOM_SECTION can be updated. For details, see Create and organize sections in Google Chat. Requires user authentication with the authorization scope: - https://www.googleapis.com/auth/chat.users.sections

patch/v1/{+name}

Path parameters

namestring required

Identifier. Resource name of the section. For system sections, the section ID is a constant string: - DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages - DEFAULT_SPACES: users/{user}/sections/default-spaces - DEFAULT_APPS: users/{user}/sections/default-apps Format: users/{user}/sections/{section}

Query parameters

updateMaskstring

Required. The mask to specify which fields to update. Currently supported field paths: - display_name

updateMaskstring

Required. The field paths to update. Separate multiple values with commas or use * to update all field paths. Currently supported field paths: - text - attachment - cards (Requires app authentication.) - cards_v2 (Requires app authentication.) - accessory_widgets (Requires app authentication.) - quoted_message_metadata (Only allows removal of the quoted message.)

Request body

sortOrderinteger

Output only. The order of the section in relation to other sections. Sections with a lower sort_order value appear before sections with a higher value.

namestring

Identifier. Resource name of the section. For system sections, the section ID is a constant string: - DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages - DEFAULT_SPACES: users/{user}/sections/default-spaces - DEFAULT_APPS: users/{user}/sections/default-apps Format: users/{user}/sections/{section}

type'SECTION_TYPE_UNSPECIFIED' | 'CUSTOM_SECTION' | 'DEFAULT_DIRECT_MESSAGES' | 'DEFAULT_SPACES' | 'DEFAULT_APPS'

Required. The type of the section.

displayNamestring

Optional. The section's display name. Only populated for sections of type CUSTOM_SECTION. Supports up to 80 characters. Required when creating a CUSTOM_SECTION.

Response

Successful response