En esta página, se explica cómo renovar una suscripción a Google Workspace con el método subscriptions.update()
. Puedes usar este método para actualizar la fecha de vencimiento de una suscripción, incluida su renovación por el tiempo de vencimiento máximo posible.
Apps Script
- Una suscripción a Google Workspace Para crear una, consulta Cómo crear una suscripción.
Se requiere la autenticación del usuario con uno o más permisos que admiten todos los tipos de eventos de la suscripción.
- Un proyecto de Apps Script:
- Usa tu proyecto de Google Cloud en lugar del predeterminado que Apps Script crea automáticamente.
- Si agregaste permisos para configurar la pantalla de consentimiento de OAuth, también debes agregarlos al archivo
appsscript.json
en tu proyecto de Apps Script. Por ejemplo:
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
- Habilita el servicio avanzado
Google Workspace Events
.
Python
- Python 3.6 o superior
- La herramienta de administración de paquetes pip
- Las bibliotecas cliente de Google más recientes para Python. Para instalarlos o actualizarlos, ejecuta el siguiente comando en tu interfaz de línea de comandos:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Una suscripción a Google Workspace Para crear una, consulta Cómo crear una suscripción.
Se requiere la autenticación del usuario con uno o más permisos que admiten todos los tipos de eventos de la suscripción.
Renueva una suscripción a Google Workspace
En esta sección, usarás el método subscriptions.update()
de la API de Google Workspace Events para renovar una suscripción hasta su fecha de vencimiento máxima. Para especificar la fecha y hora de vencimiento máxima, actualiza el campo ttl
del recurso Subscription
a 0
.
El tiempo de vencimiento máximo depende de los datos de recursos que se incluyan en la carga útil del evento. Para obtener más información sobre los plazos de vencimiento, consulta Datos de eventos para eventos de Google Workspace.
Sigue estos pasos para renovar una suscripción a Google Workspace:
Apps Script
En tu proyecto de Apps Script, crea un nuevo archivo de secuencia de comandos llamado
updateSubscription
y agrega el siguiente código: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); }
Reemplaza lo siguiente:
Para actualizar la suscripción a Google Workspace, ejecuta la función
updateSubscription
en tu proyecto de Apps Script.
Python
En tu directorio de trabajo, crea un archivo llamado
update_subscription.py
y agrega el siguiente código:"""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('client_secrets.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)
Reemplaza lo siguiente:
SCOPES
: Uno o más permisos de OAuth que admiten cada tipo de evento para la suscripción. Tiene el formato de un array de cadenas. Para enumerar varios permisos, sepáralos con comas. Por ejemplo,'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
.SUBSCRIPTION_ID
: Es el ID de la suscripción. Para obtener el ID, puedes usar cualquiera de las siguientes opciones:
En el directorio de trabajo, asegúrate de haber almacenado las credenciales de tu ID de cliente de OAuth y de haber asignado el nombre
client_secrets.json
al archivo. En la muestra de código, se usa este archivo JSON para autenticarse con Google Workspace y obtener credenciales de usuario. Para obtener instrucciones, consulta Cómo crear credenciales de ID de cliente de OAuth.Para actualizar la suscripción a Google Workspace, ejecuta lo siguiente en tu terminal:
python3 update_subscription.py
Subscription
.
Para obtener detalles sobre el recurso Subscription
actualizado, usa el método operations.get()
y especifica el recurso Operation
que muestra la solicitud subscriptions.update()
. De lo contrario, si especificas un recurso Operation
de una versión anterior de la suscripción, la respuesta estará vacía.