Administrar suscripciones

Como suscriptor de Analytics Hub, puedes realizar las siguientes tareas:

  • Suscríbete a una ficha.
  • Enumera tus suscripciones actuales en un proyecto determinado.
  • Borra una suscripción.

Como publicador de Analytics Hub, puedes realizar las siguientes tareas:

  • Visualiza todas las suscripciones a tu ficha.
  • Revoca el acceso a una suscripción específica.

Una suscripción es un recurso regionalizado que reside en el proyecto del suscriptor. Las suscripciones almacenan información relevante sobre el suscriptor y representan el contrato entre el publicador y el suscriptor.

Antes de comenzar

Para comenzar a usar Analytics Hub, debes habilitar la API de Analytics Hub dentro de tu proyecto de Google Cloud.

Permisos necesarios

Para habilitar la API de Analytics Hub, necesitas los siguientes permisos de Identity and Access Management (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

El siguiente rol predefinido de IAM incluye los permisos que necesitas para habilitar la API de Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

Para obtener más información de los roles de IAM en BigQuery, consulta Funciones y permisos predefinidos.

Habilita la API de Analytics Hub

Para habilitar la API de Analytics Hub, haz lo siguiente:

Console

Ve a la API de Analytics Hub para tu proyecto de Google Cloud y habilítala.

Habilita la API de Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Permisos necesarios

Para administrar las suscripciones, debes tener uno de los siguientes roles de Analytics Hub:

  • Rol propietario de la suscripción de Analytics Hub (roles/analyticshub.subscriptionOwner), que te permite administrar las suscripciones que creas.

Para obtener más información, consulta los roles de los usuarios de Analytics Hub.

Flujo de trabajo del suscriptor

Los suscriptores pueden realizar las siguientes acciones con las suscripciones.

Suscríbete a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Suscríbete a fichas.

Enumerar suscripciones

Para mostrar una lista de todas las suscripciones, sigue estos pasos.

API

Para ver tus suscripciones actuales en un proyecto determinado, usa el método projects.locations.subscriptions.list.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto que contiene las suscripciones que deseas enumerar.

  • LOCATION: la ubicación para la que deseas enumerar las suscripciones existentes.

Flujo de trabajo del publicador

Los publicadores pueden realizar las siguientes acciones con suscripciones. Para obtener más información sobre la administración de suscripciones a fichas, consulta Administra fichas.

Enumerar suscripciones

Para mostrar una lista de todas las suscripciones, sigue estos pasos.

Console

  1. En la consola de Google Cloud, ve a la página Analytics Hub.

    Ir a Analytics Hub

    Aparecerá una página que enumera todos los intercambios de datos a los que puedes acceder.

  2. Haz clic en el nombre del intercambio de datos en el que deseas enumerar las suscripciones.

  3. Haz clic en la pestaña Suscripciones para ver todas las suscripciones a las fichas dentro del intercambio de datos.

API

Para enumerar las suscripciones de las fichas en un intercambio de datos en particular, usa el método projects.locations.dataExchanges.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto de Data Exchange para el que deseas enumerar las suscripciones que deseas quitar.
  • LOCATION: la ubicación del intercambio de datos.
  • DATAEXCHANGE_ID: el ID del intercambio de datos para el que deseas enumerar las suscripciones.

Quita una suscripción

Console

  1. En la consola de Google Cloud, ve a la página Analytics Hub.

    Ir a Analytics Hub

    Aparecerá una página que enumera todos los intercambios de datos a los que puedes acceder.

  2. Haz clic en el nombre del intercambio de datos en el que deseas crear la ficha.

  3. Haz clic en la pestaña Suscripciones para ver todas las suscripciones al intercambio de datos.

  4. Selecciona la casilla de verificación junto a las suscripciones que deseas quitar o selecciona todas las suscripciones.

  5. Haz clic en Quitar suscripciones.

API

Para borrar una suscripción, usa el método projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto de la suscripción que deseas quitar.
  • LOCATION: la ubicación de la suscripción.
  • SUBSCRIPTION_ID: el ID de la suscripción que deseas quitar.

Limitaciones

Las suscripciones están sujetos a las siguientes limitaciones:

  • Los conjuntos de datos vinculados creados antes del 25 de julio de 2023 no se reabastecen. Solo las suscripciones creadas después del 25 de julio de 2023 funcionan con los métodos de la API.

¿Qué sigue?