Google Workspace-Abos auflisten

Apps Script

• Ein Google Workspace-Abo. Informationen zum Erstellen eines Abos findest du unter Abo erstellen.

• Erfordert die Nutzerauthentifizierung mit einem oder mehreren Bereichen, die alle Ereignistypen für das Abo unterstützen.

• Ein Apps Script-Projekt:
  • Verwenden Sie Ihr Google Cloud-Projekt anstelle des automatisch von Apps Script erstellten Standardprojekts.
  • Alle Bereiche, die Sie zum Konfigurieren des OAuth-Zustimmungsbildschirms hinzugefügt haben, müssen Sie auch der Datei appsscript.json in Ihrem Apps Script-Projekt hinzufügen. Beispiel:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • Aktivieren Sie den erweiterten Dienst Google Workspace Events.

Python

• Python 3.6 oder höher
• Das Paketverwaltungstool pip
• Die neuesten Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl in der Befehlszeile aus, um sie zu installieren oder zu aktualisieren:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• Ein Google Workspace-Abo. Wie Sie ein Abo erstellen, erfahren Sie unter Abo erstellen.

• Authentifizierung erforderlich:

  • Für die Nutzerauthentifizierung ist ein Umfang erforderlich, der mindestens einen der Ereignistypen für das Abo unterstützt. Informationen zum Identifizieren eines Gültigkeitsbereichs finden Sie unter Gültigkeitsbereich nach Ereignistyp.
  • Für die App-Authentifizierung ist der Bereich chat.bot erforderlich (nur Google Chat-Apps).

Apps Script

1. Erstellen Sie in Ihrem Apps Script-Projekt eine neue Scriptdatei mit dem Namen listSubscriptions und fügen Sie den folgenden Code hinzu:

   function listSubscriptions() {
     // Filter for event type (required).
     const eventType = 'EVENT_TYPE';
   
     // Filter for target resource (optional).
     const targetResource = 'TARGET_RESOURCE';
   
     const filter = `event_types:"${eventType}" AND target_resource="${targetResource}"`
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.list({ filter });
     console.log(response);
   }
   

   Ersetzen Sie Folgendes:

   • EVENT_TYPE: Ein Ereignistyp, der gemäß der CloudEvents-Spezifikation formatiert ist. Beispiel: Sie möchten nach Abos filtern, die Ereignisse zu neuen Mitgliedschaften in einem Google Chat-Gruppenbereich erhalten, google.workspace.chat.message.v1.created.
   • TARGET_RESOURCE: Eine Zielressource, die als vollständiger Ressourcenname formatiert ist. Wenn Sie beispielsweise nach Abos für einen Google Chat-Bereich filtern möchten, verwenden Sie //chat.googleapis.com/spaces/SPACE_ID, wobei spaces/SPACE_ID für das Feld name der Ressource Space steht.

2. Wenn Sie Abos auflisten möchten, führen Sie die Funktion listSubscriptions in Ihrem Apps Script-Projekt aus.

Python

1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen list_subscriptions.py und fügen Sie den folgenden Code hinzu:

   """List subscriptions."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['SCOPE']
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   # Filter for event type (required).
   EVENT_TYPE = 'EVENT_TYPE'
   
   # Filter for target resource (optional).
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   FILTER = f'event_types:"{EVENT_TYPE}" AND target_resource="{TARGET_RESOURCE}"'
   response = service.subscriptions().list(filter=FILTER).execute()
   print(response)
   

   Ersetzen Sie Folgendes:

   • SCOPE: Ein OAuth-Bereich, der mindestens einen Ereignistyp aus dem Abo unterstützt. Beispiel: Ihr Abo empfängt Ereignisse einen aktualisierten Chatbereich https://www.googleapis.com/auth/chat.spaces.readonly.
   • EVENT_TYPE: Ein Ereignistyp, der gemäß der CloudEvents-Spezifikation formatiert ist. Beispiel: Sie möchten nach Abos filtern, die Ereignisse zu neuen Mitgliedschaften in einem Google Chat-Gruppenbereich erhalten, google.workspace.chat.message.v1.created.
   • TARGET_RESOURCE: Eine Zielressource, die als vollständiger Ressourcenname formatiert ist. Wenn Sie beispielsweise nach Abos für einen Google Chat-Bereich filtern möchten, verwenden Sie //chat.googleapis.com/spaces/SPACE_ID, wobei spaces/SPACE_ID für das Feld name der Ressource Space steht.

2. Achten Sie darauf, dass Sie Ihre Anmeldedaten für die OAuth-Client-ID in Ihrem Arbeitsverzeichnis gespeichert und die Datei client_secrets.json genannt haben. Im Codebeispiel wird diese JSON-Datei verwendet, um sich bei Google Workspace zu authentifizieren und Nutzeranmeldedaten abzurufen. Eine Anleitung dazu finden Sie unter Anmeldedaten mit OAuth-Client-ID erstellen.

3. Führen Sie im Terminal den folgenden Befehl aus, um Abos aufzulisten:

   python3 list_subscriptions.py