Abschnitt aktualisieren

In diesem Leitfaden wird erläutert, wie Sie mit der Methode patch für die Ressource Section der Google Chat API einen benutzerdefinierten Bereich in Google Chat aktualisieren.

Es können nur Abschnitte vom Typ CUSTOM_SECTION aktualisiert werden. Weitere Informationen finden Sie unter Abschnitte in Google Chat erstellen und organisieren.

Vorbereitung

Python

Abschnitt aktualisieren

Wenn Sie einen Abschnitt mit Nutzerauthentifizierung aktualisieren möchten, übergeben Sie Folgendes in Ihrer Anfrage:

  • Geben Sie den chat.users.sections-Autorisierungsbereich an.
  • Rufen Sie die Methode UpdateSection auf.
  • Geben Sie im Anfragetext eine Section-Ressource und eine Feldmaske an:
    • Legen Sie die name des zu aktualisierenden Abschnitts fest.
    • Setzen Sie displayName auf den neuen Namen für den Abschnitt.
    • Setzen Sie updateMask auf displayName.

Im folgenden Beispiel wird ein Abschnitt aktualisiert:

Python

from google.cloud import chat_v1
from google.protobuf import field_mask_pb2

def update_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.UpdateSectionRequest(
        section=chat_v1.Section(
            name="SECTION_NAME",
            display_name="NEW_SECTION_DISPLAY_NAME"
        ),
        update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
    )

    # Make the request
    response = client.update_section(request=request)

    print(response)

Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie Folgendes:

  • SECTION_NAME: Der Ressourcenname des Abschnitts. Sie können den Ressourcennamen abrufen, indem Sie die Methode ListSections aufrufen.
  • NEW_SECTION_DISPLAY_NAME: Der neue Name für den Abschnitt.

Die Chat API gibt die aktualisierte Instanz von Section zurück.