In diesem Leitfaden wird erläutert, wie Sie mit der
create
Methode für die Section Ressource der Google Chat API einen neuen
benutzerdefinierten Bereich in Google Chat erstellen.
Mit Abschnitten können Nutzer ihre Unterhaltungen gruppieren und die Liste der Bereiche anpassen, die im Navigationsbereich von Google Chat angezeigt 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 Cloud-Clientbibliothek für Python.
-
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.
Abschnitte erstellen
Wenn Sie einen Abschnitt mit Nutzerauthentifizierung erstellen möchten, übergeben Sie Folgendes in Ihrer Anfrage:
- Geben Sie den Autorisierungsbereich
chat.users.sectionsan. - Rufen Sie die
CreateSectionMethode auf. - Geben Sie im Anfragetext eine
Section-Ressource an:- Setzen Sie
displayNameauf einen Namen für den Abschnitt (bis zu 80 Zeichen). - Setzen Sie
typeaufCUSTOM_SECTION.
- Setzen Sie
Im folgenden Beispiel wird ein Abschnitt erstellt:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
Ersetzen Sie die folgenden Platzhalter, um dieses Beispiel auszuführen:
SECTION_DISPLAY_NAME: Der Name des neuen Abschnitts.
Die Chat API gibt eine Instanz von
Section zurück, die Details zum erstellten Abschnitt enthält.
Weitere Informationen
- Abschnitte aktualisieren
- Abschnitte löschen
- Position eines Abschnitts ändern
- Abschnitte auflisten
- Bereiche in einem Abschnitt auflisten
- Bereich in einen anderen Abschnitt verschieben