Questa pagina spiega come riattivare un abbonamento a Google Workspace sospeso
risolvendo o risolvendo i problemi relativi agli errori e chiamando il metodo
subscriptions.reactivate
.
Gli abbonamenti a Google Workspace vengono sospesi ogni volta che un errore impedisce all'abbonamento di ricevere eventi. Ad esempio, un abbonamento viene sospeso quando non è possibile trovare la risorsa di destinazione o l'endpoint di notifica. Dopo aver risolto eventuali errori relativi all'abbonamento, puoi riattivarlo per tornare a ricevere eventi.
Puoi scoprire di più su un abbonamento sospeso nei seguenti modi:
- La tua app riceve un evento del ciclo di vita relativo alla sospensione. Se l'abbonamento viene sospeso a causa di un errore con il relativo endpoint, potresti non ricevere un evento del ciclo di vita.
- Utilizza i metodi
subscriptions.get
osubscriptions.list
per verificare se il campostate
dell'abbonamento è impostato suSUSPENDED
. - Ricevi una notifica di mancato recapito all'endpoint di notifica. Per scoprire di più sul monitoraggio degli errori di recapito agli argomenti Google Cloud Pub/Sub, vedi Gestire gli errori dei messaggi.
Gli abbonamenti riattivati mantengono la data di scadenza originale. Per estendere la data di scadenza di un abbonamento, vedi Aggiornare o rinnovare un abbonamento a Google Workspace.
Apps Script
- Un abbonamento a Google Workspace. Per crearne uno, consulta Creare un abbonamento.
Richiede l'autenticazione dell'utente con uno o più ambiti che supportano tutti i tipi di eventi per l'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'ambitochat.messages
, aggiungi quanto segue: - Attiva
il servizio avanzato
Google Workspace Events
.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages" ]
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 dell'utente con uno o più ambiti che supportano tutti i tipi di eventi per l'abbonamento.
Identificare e risolvere gli errori
Per identificare l'errore relativo a un abbonamento, esamina il campo
suspensionReason
dell'abbonamento. Puoi trovare questo campo quando ricevi un evento
del ciclo di vita relativo
alla sospensione o utilizzando
il metodo subscriptions.get
per esaminare tutti i campi dell'abbonamento.
La seguente tabella mostra i possibili errori per un abbonamento e, se possibile, come risolverli. Se non riesci a risolvere l'errore, puoi eliminare l'abbonamento o attendere la sua scadenza. L'API Google Workspace Events elimina automaticamente gli abbonamenti scaduti.
Errore | Descrizione | Modi per risolvere il problema |
---|---|---|
|
L'utente autorizzante ha revocato la concessione di uno o più ambiti OAuth necessari per l'abbonamento. | Ottieni un altro token di accesso. Per maggiori dettagli, vedi Ottenere un token di accesso dal server di autorizzazione Google. |
|
La risorsa di destinazione per l'abbonamento è stata eliminata. | Se la risorsa viene ripristinata, chiama il metodo reactivate . In caso contrario, non è necessario alcun intervento, in quanto non puoi riattivare un
abbonamento senza la risorsa di destinazione originale. |
|
L'utente che ha autorizzato non ha più accesso alla risorsa per l'abbonamento. | Non occorre alcun intervento. Non puoi riattivare l'abbonamento perché l'utente che lo ha autorizzato non può accedere alla risorsa di destinazione. |
|
L'applicazione Google Workspace non ha accesso per inviare eventi all'endpoint di notifica. | Concedi l'accesso al service account per l'applicazione Google Workspace
che fornisce gli eventi. Service account:
Per gli argomenti Pub/Sub, concedi il ruolo di Publisher Pub/Sub ( roles/pubsub.publisher)
) al service account. |
|
L'endpoint di notifica non esiste o non è stato trovato. | Controlla che l'endpoint sia ancora attivo e funzionante. Per risolvere i problemi relativi agli argomenti Pub/Sub, consulta la documentazione per la risoluzione dei problemi. |
|
L'endpoint di notifica non ha ricevuto eventi a causa di una quota insufficiente o del raggiungimento della limitazione della frequenza. | Richiedi un aumento della quota. |
Riattivare un abbonamento
Dopo aver risolto l'errore che ha sospeso l'abbonamento, puoi utilizzare
il metodo reactivate
per consentire all'abbonamento di ricevere di nuovo gli eventi. Il metodo
verifica che tutti gli errori siano stati risolti e modifica il campo state
del tuo abbonamento da SUSPENDED
a ACTIVE
.
Per riattivare un abbonamento a Google Workspace:
Apps Script
Nel tuo progetto Apps Script, crea un nuovo file di script denominato
reactivateSubscription
e aggiungi il seguente codice:function reactivateSubscription() { // The name of the subscription to reactivate. const name = 'subscriptions/SUBSCRIPTION_ID'; // Call the Workspace Events API using the advanced service. const response = WorkspaceEvents.Subscriptions.reactivate({}, name); console.log(response); }
Sostituisci quanto segue:
Per riattivare l'abbonamento a Google Workspace, esegui la funzione
reactivateSubscription
nel tuo progetto Apps Script.
Python
Nella directory di lavoro, crea un file denominato
reactivate_subscription.py
e aggiungi il seguente codice:"""Reactivate 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, ) NAME = 'subscriptions/SUBSCRIPTION_ID' response = service.subscriptions().reactivate(name=NAME).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:
Nella directory di lavoro, assicurati di aver archiviato 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.Per riattivare l'abbonamento a Google Workspace, esegui il comando seguente nel terminale:
python3 reactivate_subscription.py
Subscription
.
Se la richiesta non va a buon fine, consulta la sezione seguente per risolvere ulteriori errori.
Risolvere più errori
Se hai risolto l'errore che ha sospeso l'abbonamento e il metodo
reactivate
non funziona, potrebbe essersi verificato un altro errore dopo la
sospensione dell'abbonamento.
Per identificare altri errori, esamina l'output della richiesta non riuscita. L'output contiene eventuali errori ancora presenti.
Quando l'abbonamento presenta più errori, il valore del campo suspensionReason
utilizza sempre l'errore originale che ha sospeso l'abbonamento.