In diesem Leitfaden wird erläutert, wie Sie die Methode get
für die Ressource membership
verwenden.
der Google Chat API, um Details zu einer Mitgliedschaft in einem Gruppenbereich zu erhalten.
Die
Membership
-Ressource
gibt an, ob ein menschlicher Nutzer oder die Google Chat App
Teil eines Leerzeichens oder fehlt.
Authentifizierung mit App-Authentifizierung Ermöglicht einer Chat-App, Mitgliedschaften aus Gruppenbereichen zu erhalten, die sie hat Zugriff in Google Chat (z. B. Gruppenbereiche, in denen der Nutzer Mitglied ist), aber ausgeschlossen Chat-App-Mitgliedschaft, einschließlich ihrer eigenen. Authentifizierung mit Nutzerauthentifizierung gibt Mitgliedschaften aus Gruppenbereichen zurück, auf die der authentifizierte Nutzer Zugriff hat.
Vorbereitung
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Python Google API-Clientbibliothek
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
<ph type="x-smartling-placeholder">
- </ph>
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales Verzeichnis. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
Details zu einer Mitgliedschaft aufrufen
Wenn Sie Details zu einer Mitgliedschaft in Google Chat erhalten möchten, geben Sie in Ihrem Anfrage:
- Mit
app authentication (App-Authentifizierung): Geben Sie
den Autorisierungsbereich
chat.bot
. Mit Nutzerauthentifizierung Geben Sie die Autorisierungchat.memberships.readonly
oderchat.memberships
an Umfang. Wählen Sie als Best Practice den restriktivsten Bereich aus, der immer noch dass Ihre App funktioniert. - Rufen Sie die Methode
get
-Methode ammembership
-Ressource. - Übergeben Sie die
name
der Mitgliedschaft, um Zugriff zu erhalten. Den Namen der Mitgliedschaft erhalten Sie vom Mitgliedschaft in Google Chat.
So kannst du eine Mitgliedschaft bei Nutzerauthentifizierung:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_membership_get.py
. Fügen Sie den folgenden Code in
chat_membership_get.py
ein:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a specified membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().get( # The membership to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
Ersetzen Sie im Code Folgendes:
SPACE
: ein Name für den Gruppenbereich, den Sie über die Methodespaces.list
in der Chat API oder über die URL eines Gruppenbereichs.MEMBER
: ein Name der Mitgliedschaft, den Sie abrufen können aus der Methodespaces.members.list
in der Chat API.
Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_membership_get.py
Die Chat API gibt eine Instanz von
membership
mit Angaben zur angegebenen Mitgliedschaft.
Weitere Informationen
- Mitglieder in einem Gruppenbereich auflisten
- Nutzer oder die Chat-App zu einem Gruppenbereich einladen oder hinzufügen
- Mitgliedschaft eines Nutzers in einem Google Chat-Bereich aktualisieren
- Einen Nutzer oder eine Chat-App aus einem Gruppenbereich entfernen