In diesem Leitfaden wird erläutert, wie Sie die
patch
Methode für die Section Ressource der Google Chat API verwenden, um einen benutzerdefinierten Bereich in Google Chat zu 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
- Ein Google Workspace-Konto für Unternehmen oder Enterprise mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen.
- OAuth-Zustimmungsbildschirm konfigurieren.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Python Cloud-Clientbibliothek.
-
Erstellen Sie OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung. Wenn Sie das Beispiel in diesem
Leitfaden ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.jsonin Ihrem lokalen Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Abschnitt aktualisieren
Wenn Sie einen Abschnitt mit Nutzerauthentifizierung aktualisieren möchten, übergeben Sie Folgendes in Ihrer Anfrage:
- Geben Sie den Autorisierungsbereich
chat.users.sectionsan. - Rufen Sie die
UpdateSectionMethode auf. - Geben Sie im Anfragetext eine
Section-Ressource und eine Feldmaske an:- Legen Sie
namedes zu aktualisierenden Abschnitts fest. - Legen Sie
displayNameauf den neuen Namen für den Abschnitt fest. - Legen Sie
updateMaskaufdisplayNamefest.
- Legen Sie
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)
Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:
SECTION_NAME: Der Ressourcenname des Abschnitts. Sie können den Ressourcennamen abrufen, indem Sie dieListSectionsMethode aufrufen.NEW_SECTION_DISPLAY_NAME: Der neue Name für den Abschnitt.
Die Chat API gibt die aktualisierte Instanz von
Section zurück.
Weitere Informationen
- Abschnitt erstellen
- Abschnitt löschen
- Position eines Abschnitts ändern
- Abschnitte auflisten
- Bereiche in einem Abschnitt auflisten
- Bereich in einen anderen Abschnitt verschieben