Google Workspace-Abo aktualisieren oder verlängern

Apps Script

• Ein Google Workspace-Abo. Informationen zum Erstellen eines Abos finden Sie unter Abo erstellen.

• Ein Apps Script-Projekt:
  • Verwenden Sie Ihr Google Cloud-Projekt anstelle des Standardprojekts, das automatisch von Apps Script erstellt wird.
  • Für alle Bereiche, die Sie zum Konfigurieren des OAuth-Zustimmungsbildschirms hinzugefügt haben, müssen Sie die Bereiche auch der Datei appsscript.json in Ihrem Apps Script-Projekt hinzufügen. Wenn Sie beispielsweise den Bereich chat.messages angegeben haben, fügen Sie Folgendes hinzu:

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

  • Aktivieren Sie den erweiterten Dienst Google Workspace Events.

• Erfordert die Authentifizierung und einen geeigneten Autorisierungsbereich für jeden Ereignistyp im Abo:

  • Für die Nutzerauthentifizierung sind ein oder mehrere Bereiche erforderlich, die mindestens einen der Ereignistypen für das Abo unterstützen. Informationen zum Identifizieren eines Bereichs finden Sie unter Bereiche nach Ereignistyp.
  • Wenn Sie als Chat-App ein Chat-Ereignis abonnieren möchten, ist eine App-Authentifizierung mit einmaliger Administratorgenehmigung erforderlich. Das Abonnieren eines Chat-Ereignisses als Chat-App ist in der Entwicklervorschau verfügbar.

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. Informationen zum Erstellen eines Abos finden Sie unter Abo erstellen.

• Erfordert die Authentifizierung und einen geeigneten Autorisierungsbereich für jeden Ereignistyp im Abo:

  • Für die Nutzerauthentifizierung sind ein oder mehrere Bereiche erforderlich, die mindestens einen der Ereignistypen für das Abo unterstützen. Informationen zum Identifizieren eines Bereichs finden Sie unter Bereiche nach Ereignistyp.
  • Wenn Sie als Chat-App ein Chat-Ereignis abonnieren möchten, ist eine App-Authentifizierung mit einmaliger Administratorgenehmigung erforderlich. Das Abonnieren eines Chat-Ereignisses als Chat-App ist in der Entwicklervorschau verfügbar.

Apps Script

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

   function updateSubscription() {
     // The name of the subscription to update.
     const name = 'subscriptions/SUBSCRIPTION_ID';
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.patch({
       ttl: '0s',
     }, name);
     console.log(response);
   }
   

   Ersetzen Sie Folgendes:

   • SUBSCRIPTION_ID: Die ID des Abos. Sie haben folgende Möglichkeiten, die ID abzurufen:
     • Der Wert des Felds uid.
     • Die ID des Ressourcennamens, der im Feld name dargestellt wird. Wenn der Ressourcenname beispielsweise subscriptions/subscription-123 lautet, verwenden Sie subscription-123.

2. Führen Sie die Funktion updateSubscription in Ihrem Apps Script-Projekt aus, um das Google Workspace-Abo zu aktualisieren.

Python

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

   """Update subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = [SCOPES]
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'ttl': {'seconds': 0},
   }
   NAME = 'subscriptions/SUBSCRIPTION_ID'
   response = (
       service.subscriptions()
       .patch(name=NAME, updateMask='ttl', body=BODY)
       .execute()
   )
   print(response)
   

   Ersetzen Sie Folgendes:

   • SCOPES: Ein oder mehrere OAuth-Bereiche, die jeden Ereignistyp für das Abo unterstützen. Als Array von Strings formatiert. Wenn Sie mehrere Bereiche angeben möchten, trennen Sie sie durch Kommas. Beispiel: 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
   • SUBSCRIPTION_ID: Die ID des Abos. Sie haben folgende Möglichkeiten, die ID abzurufen:
     • Der Wert des Felds uid.
     • Die ID des Ressourcennamens, der im Feld name dargestellt wird. Wenn der Ressourcenname beispielsweise subscriptions/subscription-123 lautet, verwenden Sie subscription-123.

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

3. Führen Sie Folgendes in Ihrem Terminal aus, um das Google Workspace-Abo zu aktualisieren:

   python3 update_subscription.py

Python

  """Update subscription."""

  from google.oauth2 import service_account
  from apiclient.discovery import build

  # Specify required scopes.
  SCOPES = [SCOPES]

  # Specify service account details.
  CREDENTIALS = (
      service_account.Credentials.from_service_account_file('credentials.json')
      .with_scopes(SCOPES)
  )

  # Call the Workspace Events API using the service endpoint.
  service = build(
      'workspaceevents',
      'v1beta',
      credentials=CREDENTIALS,
      discoveryServiceUrl='https://workspaceevents.googleapis.com/$discovery/rest?version=v1beta&labels=DEVELOPER_PREVIEW&key=API_KEY',
  )

  BODY = {
      'ttl': {'seconds': 0},
  }
  NAME = 'subscriptions/SUBSCRIPTION_ID'
  response = (
      service.subscriptions()
      .patch(name=NAME, updateMask='ttl', body=BODY)
      .execute()
  )
  print(response)