Enumerar suscripciones a Google Workspace

En esta página, se explica cómo enumerar las suscripciones a Google Workspace con el método subscriptions.list().

Cuando llamas a este método con la autenticación de usuario, el método muestra una lista de suscripciones autorizadas por el usuario. Cuando usas la autenticación de apps, el método puede mostrar una lista que contenga cualquier suscripción a la app.

Requisitos previos

Apps Script

  • 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.

  • Requiere autenticación:

    • Para la autenticación de usuarios, requiere un alcance que admita al menos uno de los tipos de eventos de la suscripción. Para identificar un alcance, consulta Permisos por tipo de evento.
    • Para la autenticación de apps, requiere el permiso chat.bot (solo apps de Google Chat).

Enumera las suscripciones autorizadas por un usuario

Para mostrar las suscripciones, debes filtrar por al menos un tipo de evento. También puedes filtrar tu consulta por uno o más recursos de destino. Para obtener más información sobre los filtros de consulta compatibles, consulta la documentación del método list().

En la siguiente muestra de código, se muestra un array de objetos Subscription filtrados por tipo de evento y recurso de destino. Cuando se autentica como un usuario, el método solo muestra una lista de suscripciones que el usuario autorizó a crear la aplicación.

Para mostrar una lista de suscripciones para un tipo de evento y un recurso de destino especificados, haz lo siguiente:

Apps Script

  1. En tu proyecto de Apps Script, crea un nuevo archivo de secuencia de comandos llamado listSubscriptions y agrega el siguiente código:

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

    Reemplaza lo siguiente:

    • EVENT_TYPE: Es un tipo de evento con un formato conforme a la especificación de CloudEvents. Por ejemplo, para filtrar suscripciones que reciben eventos sobre membresías nuevas a un espacio de Google Chat, google.workspace.chat.message.v1.created.
    • TARGET_RESOURCE: Es un recurso de destino, con el formato de su nombre completo de recurso. Por ejemplo, para filtrar por suscripciones de un espacio de Google Chat, usa //chat.googleapis.com/spaces/SPACE_ID, donde spaces/SPACE_ID representa el campo name del recurso Space.

  2. Para mostrar una lista de suscripciones, ejecuta la función listSubscriptions en tu proyecto de Apps Script.

Python

  1. En tu directorio de trabajo, crea un archivo llamado list_subscriptions.py y agrega el siguiente código:

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

    Reemplaza lo siguiente:

    • SCOPE: Es un alcance de OAuth que admite al menos un tipo de evento de la suscripción. Por ejemplo, si tu suscripción recibe eventos en un espacio de Chat actualizado, https://www.googleapis.com/auth/chat.spaces.readonly.
    • EVENT_TYPE: Es un tipo de evento con un formato conforme a la especificación de CloudEvents. Por ejemplo, para filtrar suscripciones que reciben eventos sobre membresías nuevas a un espacio de Google Chat, google.workspace.chat.message.v1.created.
    • TARGET_RESOURCE: Es un recurso de destino, con el formato de su nombre completo de recurso. Por ejemplo, para filtrar por suscripciones de un espacio de Google Chat, usa //chat.googleapis.com/spaces/SPACE_ID, donde spaces/SPACE_ID representa el campo name del recurso Space.

  2. 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.

  3. Para mostrar una lista de suscripciones, ejecuta el siguiente comando en tu terminal:

    python3 list_subscriptions.py

La API de Google Workspace Events muestra un array paginado de objetos Subscription que coinciden con el filtro de tu consulta.