Administra intercambios de datos

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

Crea, actualiza, visualiza, comparte y borra intercambios de datos.
Crear, actualizar, borrar y compartir fichas.
Administrar los administradores de Analytics Hub, los administradores de fichas, los publicadores, los suscriptores y los visualizadores.

De forma predeterminada, un intercambio de datos es privado y solo los usuarios o grupos que tienen acceso a ese intercambio pueden ver los datos o suscribirse a ellos. Sin embargo, si quieres que los usuarios de Google Cloud (allAuthenticatedUsers) descubran fichas y se suscriban a ellas, puedes solicitar hacer público tu intercambio de datos.

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:

Consola

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 los intercambios de datos, debes tener el rol Analytics Hub Admin (roles/analyticshub.admin). Para obtener más información, consulta el rol Analytics Hub Admin. Para obtener información sobre cómo otorgar este rol a otros usuarios, consulta Crea administradores de Analytics Hub.

Crea un intercambio de datos

Para crear un intercambio de datos, sigue estos pasos:

Consola

Ve a la página Analytics Hub.

Ir a Analytics Hub
Haz clic en Crear intercambio.
En el cuadro de diálogo Crear intercambio, selecciona un Proyecto y una Región para tu intercambio de datos. No puedes actualizar el proyecto y la región después de crear el intercambio de datos.
En Nombre visible, ingresa un nombre para tu intercambio de datos.
Opcional: Ingresa valores en los siguientes campos:
- Contacto principal: Ingresa la URL o la dirección de correo electrónico del contacto principal para el intercambio de datos.
- Descripción: Ingresa una descripción para el intercambio de datos.
Haz clic en Crear intercambio.
Opcional: En la sección Permisos del intercambio, realiza los siguientes pasos:
1. Ingresa las direcciones de correo electrónico en los siguientes campos para otorgar los roles de usuario de Analytics Hub:
  - Administradores: A estos usuarios se les asigna el rol Analytics Hub Admin.
  - Publicadores: A estos usuarios se les asigna el rol Analytics Hub Publisher. Para obtener información sobre las tareas que pueden realizar los publicadores, consulta Administra fichas.
  - Suscriptores: A estos usuarios se les asigna el rol Analytics Hub Subscriber. Si deseas obtener información sobre las tareas que pueden realizar los suscriptores, consulta Visualiza fichas y suscríbete a ellas.
  - Visualizadores: A estos usuarios se les asigna el rol Analytics Hub Viewer. Los visualizadores pueden ver fichas.
2. Para guardar los permisos, haz clic en Establecer permisos.
Si no estableciste permisos para tu intercambio de datos, haz clic en Omitir.

API

Usa el método projects.locations.dataExchanges.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto en el que deseas crear el intercambio de datos.
LOCATION: la ubicación de tu intercambio de datos. Para obtener más información sobre las ubicaciones compatibles con Analytics Hub, consulta Regiones admitidas.
DATAEXCHANGE_ID: El ID de tu intercambio de datos.

En el cuerpo de la solicitud, proporciona los detalles del intercambio de datos. Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles del intercambio de datos.

Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges.

Actualiza un intercambio de datos

Para actualizar un intercambio de datos, sigue estos pasos:

Consola

Ve a la página Analytics Hub.

Ir a Analytics Hub
En la lista de intercambios de datos, haz clic en el intercambio de datos que desees actualizar.
Haz clic en Editar intercambio.
En el diálogo Editar intercambio, actualiza los siguientes campos:
- Nombre visible
- Contacto principal
- Descripción
Haz clic en Guardar.

API

Usa el método projects.locations.dataExchanges.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

Reemplaza UPDATEMASK por la lista de campos que deseas actualizar. Si deseas actualizar varios valores, usa una lista separada por comas. Por ejemplo, para actualizar el nombre visible y el contacto principal de un intercambio de datos, ingresa displayName,primaryContact.

En el cuerpo de la solicitud, especifica los valores actualizados para los siguientes campos:

Nombre visible
Descripción
Documentación
Ícono
Contacto principal

Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges.

Ve los intercambios de datos

Para ver todos los intercambios de datos de tu organización a los que tienes acceso, sigue estos pasos:

Consola

Ve a la página Analytics Hub.

Ir a Analytics Hub
Consulta la lista de intercambios de datos dentro de tu organización de Google Cloud.

API

Usa el método organizations.locations.dataExchanges.list.

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Reemplaza lo siguiente:

ORGANIZATION_ID: El ID de la organización. Para obtener más información, consulta Obtén el ID de tu organización.
LOCATION: La ubicación para la que deseas enumerar los intercambios de datos existentes.

Comparte un intercambio de datos

Si el publicador de Analytics Hub pertenece a una organización diferente a la que contiene el intercambio de datos, el publicador no puede ver el intercambio de datos en Analytics Hub. Debes compartir un vínculo del intercambio de datos con el publicador.

Ve a la página Analytics Hub.

Ir a Analytics Hub
En la lista de intercambios de datos, haz clic en Más opciones.
Haz clic en Copiar vínculo para compartir.

Otorga a los usuarios acceso a un intercambio de datos

Para otorgar a los usuarios acceso a un intercambio de datos, debes establecer la política de IAM para ese intercambio. Para obtener información sobre los roles de usuario predefinidos de IAM, consulta Roles de los usuarios de Analytics Hub. Para hacerlo, sigue estos pasos:

Consola

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

Ir a Analytics Hub
Haz clic en el nombre del intercambio de datos para el que deseas establecer permisos.
Haz clic en Establecer permisos.
Para agregar principales, haz clic en Agregar principal.
En el campo Principales nuevos, agrega los correos electrónicos a los que desees otorgar acceso.
En Selecciona un rol, mantén el puntero sobre Analytics Hub y, luego, selecciona una de los siguientes roles de Identity and Access Management (IAM):
- Administrador de Analytics Hub
- Publicador de Analytics Hub
- Administrador de fichas de Analytics Hub
- Suscriptor de Analytics Hub
- Visualizador de Analytics Hub
Haz clic en Guardar.

API

Lee la política existente con el método getIamPolicy de la lista mediante el método projects.locations.dataExchanges.getIamPolicy:
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
```
Reemplaza lo siguiente:
- PROJECT_ID: es el ID del proyecto, por ejemplo, my-project-1.
- LOCATION: la ubicación de tu intercambio de datos.
- DATAEXCHANGE_ID: el ID del intercambio de datos.
Analytics Hub muestra la política actual.
Para agregar o quitar miembros y sus roles asociados de Identity and Access Management (IAM), edita la política con un editor de texto. Usa el siguiente formato para agregar miembros:
- user:test-user@gmail.com
- group:admins@example.com
- serviceAccount:test123@example.domain.com
- domain:example.domain.com
Por ejemplo, para otorgar la función roles/analyticshub.subscriber a group:subscribers@example.com, agrega la siguiente vinculación a la política:
```
{
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}
```
Escribe la política actualizada mediante el método projects.locations.dataExchanges.setIamPolicy. En el cuerpo de la solicitud, proporciona la política de IAM actualizada del paso anterior.
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
```
En el cuerpo de la solicitud, proporciona los detalles de la ficha. Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles de la ficha.

Crea administradores de Analytics Hub

Para administrar intercambios de datos, debes crear administradores de Analytics Hub. Para crear administradores de intercambio, debes otorgar a los usuarios el rol Analytics Hub Admin (roles/analyticshub.admin) a nivel de proyecto o de intercambio de datos.

Si quieres que los administradores gestionen todos los intercambios de datos de un proyecto, otorga el rol Analytics Hub Admin para ese proyecto. Si deseas que los administradores gestionen un intercambio de datos específico, otorga el rol Analytics Hub Admin para ese intercambio de datos.

Haz que un intercambio de datos sea público

De forma predeterminada, un intercambio de datos es privado y solo los usuarios o grupos que tienen acceso a ese intercambio pueden ver sus fichas o suscribirse a ellas. Sin embargo, puedes optar por hacer público un intercambio de datos. Los usuarios de Google Cloud (allAuthenticatedUsers) pueden descubrir las fichas en los intercambios de datos públicos y suscribirse a ellas.

Para hacer público un intercambio de datos, sigue estos pasos:

Para permitir que los usuarios allAuthenticatedUsers vean fichas, debes otorgarles el rol Analytics Hub Viewer a nivel de intercambio de datos.
Para permitir que allAuthenticatedUsers se suscriban a las fichas, debes otorgarles el rol Analytics Hub Subscriber a nivel de intercambio de datos.
Solicita a Google hacer público el intercambio de datos. Después de que Google aprueba la solicitud, todos los usuarios de Google Cloud (allAuthenticatedUsers) pueden ver las listas públicas de ese intercambio de datos.

Borra un intercambio de datos

Cuando se borra un intercambio de datos, también se borran todas las fichas que contiene. Sin embargo, los conjuntos de datos compartidos y los vinculados no se borran. Además, cuando se borra un proyecto, no se borran los intercambios de datos dentro de él. Debes borrar estos intercambios de datos antes de borrar el proyecto. Si borras un intercambio de datos, no podrás deshacerlo.

Para borrar un intercambio de datos, sigue estos pasos:

Consola

Ve a la página Analytics Hub.

Ir a Analytics Hub
En la lista de intercambios de datos, haz clic en el intercambio de datos que deseas borrar.
Haz clic en Borrar intercambio.
En el cuadro de diálogo ¿Borrar intercambio?, escribe delete para confirmar la eliminación.
Haz clic en Borrar.

API

Usa el método projects.locations.dataExchanges.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges.

¿Qué sigue?

Obtén información sobre cómo administrar fichas.
Obtén información sobre cómo otorgar roles de usuario de Analytics Hub.
Obtén información sobre cómo ver fichas y suscribirte a ellas.
Obtén más información sobre el registro de auditoría de Analytics Hub.