Aggiornare o rinnovare un abbonamento a Google Workspace

Apps Script

• Un abbonamento a Google Workspace. Per crearne uno, consulta Creare un abbonamento.

• Un progetto Apps Script:
  • Utilizza il tuo progetto Google Cloud anziché quello predefinito creato automaticamente da Apps Script.
  • Per tutti gli ambiti che hai aggiunto per configurare la schermata per il consenso OAuth, devi aggiungere anche gli ambiti al file appsscript.json nel tuo progetto Apps Script. Ad esempio, se hai specificato l'ambito chat.messages, aggiungi quanto segue:

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

  • Attiva il servizio avanzato Google Workspace Events.

• Richiede l'autenticazione e un ambito di autorizzazione appropriato per ogni tipo di evento nell'abbonamento:

  • Per l'autenticazione utente, richiede uno o più ambiti che supportino almeno uno dei tipi di eventi per l'abbonamento. Per identificare un ambito, vedi Ambiti per tipo di evento.
  • Per iscriversi a un evento di Chat come app di chat, è richiesta l'autenticazione dell'app con l'approvazione una tantum dell'amministratore. L'iscrizione a un evento di Chat come app Chat è disponibile in Anteprima per sviluppatori.

Python

• Python 3.6 o versioni successive
• Lo strumento di gestione pacchetti pip
• Le librerie client Google più recenti per Python. Per installarli o aggiornarli, esegui il seguente comando nell'interfaccia a riga di comando:

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

• Un abbonamento a Google Workspace. Per crearne uno, consulta Creare un abbonamento.

• Richiede l'autenticazione e un ambito di autorizzazione appropriato per ogni tipo di evento nell'abbonamento:

  • Per l'autenticazione utente, richiede uno o più ambiti che supportino almeno uno dei tipi di eventi per l'abbonamento. Per identificare un ambito, vedi Ambiti per tipo di evento.
  • Per iscriversi a un evento di Chat come app di chat, è richiesta l'autenticazione dell'app con l'approvazione una tantum dell'amministratore. L'iscrizione a un evento di Chat come app Chat è disponibile in Anteprima per sviluppatori.

Apps Script

1. Nel tuo progetto Apps Script, crea un nuovo file di script denominato updateSubscription e aggiungi il seguente codice:

   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);
   }
   

   Sostituisci quanto segue:

   • SUBSCRIPTION_ID: l'ID dell'abbonamento. Per ottenere l'ID, puoi utilizzare uno dei seguenti metodi:
     • Il valore del campo uid.
     • L'ID del nome della risorsa rappresentato nel campo name. Ad esempio, se il nome della risorsa è subscriptions/subscription-123, utilizza subscription-123.

2. Per aggiornare l'abbonamento a Google Workspace, esegui la funzione updateSubscription nel tuo progetto Apps Script.

Python

1. Nella directory di lavoro, crea un file denominato update_subscription.py e aggiungi il seguente codice:

   """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)
   

   Sostituisci quanto segue:

   • SCOPES: uno o più ambiti OAuth che supportano ogni tipo di evento per l'abbonamento. Formattato come array di stringhe. Per elencare più ambiti, separali con le virgole. Ad esempio: 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
   • SUBSCRIPTION_ID: l'ID dell'abbonamento. Per ottenere l'ID, puoi utilizzare uno dei seguenti metodi:
     • Il valore del campo uid.
     • L'ID del nome della risorsa rappresentato nel campo name. Ad esempio, se il nome della risorsa è subscriptions/subscription-123, utilizza subscription-123.

2. Nella directory di lavoro, assicurati di aver memorizzato le credenziali dell'ID client OAuth e di aver denominato il file credentials.json. L'esempio di codice utilizza questo file JSON per l'autenticazione con Google Workspace e per ottenere le credenziali utente. Per istruzioni, vedi Creare le credenziali dell'ID client OAuth.

3. Per aggiornare l'abbonamento a Google Workspace, esegui questo comando nel terminale:

   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)