Method: users.sections.patch

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

HTTP request

PATCH https://chat.googleapis.com/v1/{section.name=users/*/sections/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
section.name

string

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

Parameters
updateMask

string (FieldMask format)

Required. The mask to specify which fields to update.

Currently supported field paths:

  • displayName

Request body

The request body contains an instance of Section .

Response body

If successful, the response body contains an instance of Section .

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authorization guide.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026年04月01日 UTC.