Gestire gli scambi di dati

In qualità di amministratore di Analytics Hub, puoi eseguire le seguenti attività:

Creare, aggiornare, visualizzare, condividere ed eliminare scambi di dati.
Creare, aggiornare, eliminare e condividere schede.
Gestire gli amministratori di Analytics Hub, gli amministratori delle schede, i publisher, gli abbonati e i visualizzatori.

Per impostazione predefinita, uno scambio di dati è privato e solo gli utenti o i gruppi che hanno accesso a quella piattaforma possono visualizzare o sottoscrivere i dati. Tuttavia, se vuoi che le schede vengano rilevate e sottoscritte da utenti Google Cloud (allAuthenticatedUsers), puoi richiedere di rendere pubblico il tuo scambio di dati.

Prima di iniziare

Per iniziare a utilizzare Analytics Hub, devi abilitare l'API Analytics Hub all'interno del tuo progetto Google Cloud.

Autorizzazioni obbligatorie

Per abilitare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):

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

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per abilitare l'API Analytics Hub:

roles/serviceusage.serviceUsageAdmin

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Autorizzazioni e ruoli predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub:

Console

Vai all'API Analytics Hub per il tuo progetto Google Cloud e abilitala.

Attivare l'API Analytics Hub

gcloud

Esegui il comando gcloud services allow:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

Per gestire gli scambi di dati, devi disporre del ruolo Amministratore Analytics Hub (roles/analyticshub.admin). Per saperne di più, consulta Ruolo Amministratore Analytics Hub. Per scoprire come concedere questo ruolo ad altri utenti, consulta Creare amministratori di Analytics Hub.

Crea uno scambio di dati

Per creare uno scambio di dati:

Console

Vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Fai clic su Crea piattaforma di scambio pubblicitario.
Nella finestra di dialogo Crea scambio, seleziona un progetto e una regione per il tuo scambio di dati. Non puoi aggiornare il progetto e la regione dopo aver creato lo scambio di dati.
In Nome visualizzato, inserisci un nome per lo scambio di dati.
(Facoltativo) Inserisci i valori nei seguenti campi:
- Contatto principale: inserisci l'URL o l'indirizzo email del contatto principale per lo scambio di dati.
- Descrizione: inserisci una descrizione per lo scambio di dati.
Fai clic su Create Exchange (Crea Exchange).
(Facoltativo) Nella sezione Autorizzazioni di Exchange, segui questi passaggi:
1. Inserisci gli indirizzi email nei seguenti campi per concedere i ruoli utente di Analytics Hub:
  - Amministratori: a questi utenti viene assegnato il ruolo Amministratore di Analytics Hub.
  - Publisher: a questi utenti viene assegnato il ruolo Publisher di Analytics Hub. Per informazioni sulle attività che gli editori possono eseguire, consulta Gestione delle schede.
  - Abbonati: a questi utenti viene assegnato il ruolo Abbonato Analytics Hub. Per informazioni sulle attività che gli abbonati possono eseguire, consulta la sezione Visualizzare e abbonarsi alle schede.
  - Visualizzatori: a questi utenti viene assegnato il ruolo Visualizzatore Analytics Hub. Gli spettatori possono visualizzare le schede.
2. Per salvare le autorizzazioni, fai clic su Imposta autorizzazioni.
Se non hai impostato le autorizzazioni per lo scambio di dati, fai clic su Salta.

API

Utilizza il metodo projects.locations.dataExchanges.create.

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

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui vuoi creare lo scambio di dati.
LOCATION: la località dello scambio di dati. Per ulteriori informazioni sulle località che supportano Analytics Hub, consulta Regioni supportate.
DATAEXCHANGE_ID: l'ID per lo scambio di dati.

Nel corpo della richiesta, fornisci i dettagli relativi allo scambio di dati. Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli dello scambio di dati.

Per ulteriori informazioni sulle attività che puoi eseguire negli scambi di dati utilizzando le API, consulta i metodi di projects.locations.dataExchanges.

Aggiorna uno scambio di dati

Per aggiornare uno scambio di dati, segui questi passaggi:

Console

Vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Nell'elenco degli scambi di dati, fai clic su quello che vuoi aggiornare.
Fai clic su Modifica piattaforma di scambio pubblicitario.
Nella finestra di dialogo Modifica piattaforma di scambio pubblicitario, aggiorna i seguenti campi:
- Nome visualizzato
- Contatto principale
- Description
Fai clic su Salva.

API

Utilizza il metodo projects.locations.dataExchanges.patch.

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

Sostituisci UPDATEMASK con l'elenco dei campi che vuoi aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole; ad esempio, per aggiornare il nome visualizzato e il contatto principale per uno scambio di dati, inserisci displayName,primaryContact.

Nel corpo della richiesta, specifica i valori aggiornati per i seguenti campi:

Nome visualizzato
Descrizione
Documentazione
Icona
Contatto principale

Per ulteriori informazioni sulle attività che puoi eseguire negli scambi di dati utilizzando le API, consulta i metodi di projects.locations.dataExchanges.

Visualizza scambi di dati

Per visualizzare tutti gli scambi di dati nella tua organizzazione a cui hai accesso, segui questi passaggi:

Console

Vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Visualizzare l'elenco degli scambi di dati all'interno della tua organizzazione Google Cloud.

API

Utilizza il metodo organizations.locations.dataExchanges.list.

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

Sostituisci quanto segue:

ORGANIZATION_ID: l'ID organizzazione. Per saperne di più, vedi Ottenere l'ID organizzazione.
LOCATION: la località per la quale vuoi elencare gli scambi di dati esistenti.

Condividere uno scambio di dati

Se il publisher di Analytics Hub appartiene a un'organizzazione diversa da quella contenente lo scambio di dati, non può visualizzare lo scambio di dati in Analytics Hub. Devi condividere un link allo scambio di dati con il publisher.

Vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Nell'elenco degli scambi di dati, fai clic su Altre opzioni.
Fai clic su Copia link condivisione.

Consentire agli utenti di accedere a uno scambio di dati

Per consentire agli utenti di accedere a uno scambio di dati, devi impostare il criterio IAM per quello scambio. Per informazioni sui ruoli utente IAM predefiniti, consulta Ruoli utente di Analytics Hub. Per farlo, segui questi passaggi:

Console

Nella console Google Cloud, vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Fai clic sul nome dello scambio di dati per cui vuoi impostare le autorizzazioni.
Fai clic su Imposta autorizzazioni.
Per aggiungere entità, fai clic su Aggiungi entità.
Nel campo Nuove entità, aggiungi gli indirizzi email a cui vuoi concedere l'accesso.
In Seleziona un ruolo, tieni il puntatore del mouse su Analytics Hub, quindi seleziona uno dei seguenti ruoli di Identity and Access Management (IAM):
- Amministratore Analytics Hub
- Publisher Analytics Hub
- Amministratore scheda Analytics Hub
- Abbonato ad Analytics Hub
- Visualizzatore Analytics Hub
Fai clic su Salva.

API

Leggi la norma esistente con il metodo getIamPolicy per la scheda utilizzando il metodo projects.locations.dataExchanges.getIamPolicy:
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto, ad esempio my-project-1.
- LOCATION: la località dello scambio di dati.
- DATAEXCHANGE_ID: l'ID dello scambio di dati.
Analytics Hub restituisce il criterio corrente.
Per aggiungere o rimuovere i membri e i ruoli IAM (Identity and Access Management) associati, modifica il criterio con un editor di testo. Utilizza il seguente formato per aggiungere membri:
- user:test-user@gmail.com
- group:admins@example.com
- serviceAccount:test123@example.domain.com
- domain:example.domain.com
Ad esempio, per concedere il ruolo roles/analyticshub.subscriber a group:subscribers@example.com, aggiungi la seguente associazione al criterio:
```
{
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}
```
Scrivi il criterio aggiornato utilizzando il metodo projects.locations.dataExchanges.setIamPolicy. Nel corpo della richiesta, fornisci il criterio IAM aggiornato del passaggio precedente.
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
```
Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli della scheda.

Crea amministratori Analytics Hub

Per gestire gli scambi di dati, devi creare amministratori di Analytics Hub. Per creare amministratori di piattaforme di scambio pubblicitario, devi concedere agli utenti il ruolo Amministratore di Analytics Hub (roles/analyticshub.admin) a livello di progetto o di scambio di dati.

Se vuoi che gli amministratori gestiscano tutti gli scambi di dati di un progetto, concedi il ruolo Amministratore Analytics Hub per il progetto. Se vuoi che gli amministratori gestiscano uno specifico scambio di dati, concedi il ruolo Amministratore Analytics Hub per lo scambio di dati in questione.

Rendere pubblico uno scambio di dati

Per impostazione predefinita, uno scambio di dati è privato e solo gli utenti o i gruppi che hanno accesso a questa piattaforma possono visualizzare o iscriversi alle sue schede. Tuttavia, puoi scegliere di rendere pubblico uno scambio di dati. Le schede negli scambi di dati pubblici possono essere rilevate e sottoscritte da utenti Google Cloud (allAuthenticatedUsers).

Per rendere pubblica uno scambio di dati:

Per consentire a allAuthenticatedUsers di visualizzare le schede, devi concedere all'utente il ruolo Visualizzatore Analytics Hub a livello di scambio di dati.
Per consentire a allAuthenticatedUsers di iscriversi alle schede, devi concedere all'utente il ruolo Sottoscrittore Analytics Hub a livello di scambio di dati.
Richiedi a Google di rendere pubblico lo scambio di dati. Dopo che Google approva la richiesta, tutti gli utenti di Google Cloud (allAuthenticatedUsers) possono visualizzare le schede pubbliche nello scambio di dati in questione.

Eliminare uno scambio di dati

Quando uno scambio di dati viene eliminato, vengono eliminate anche tutte le schede al suo interno. Tuttavia, i set di dati condivisi e collegati non vengono eliminati. Inoltre, quando un progetto viene eliminato, gli scambi di dati al suo interno non vengono eliminati. Devi eliminare questi scambi di dati prima di eliminare il progetto. Se elimini uno scambio di dati, l'operazione non potrà essere annullata.

Per eliminare uno scambio di dati:

Console

Vai alla pagina Analytics Hub.

Vai ad Analytics Hub
Nell'elenco degli scambi di dati, fai clic sullo scambio di dati che vuoi eliminare.
Fai clic su Elimina piattaforma di scambio pubblicitario.
Nella finestra di dialogo Vuoi eliminare lo scambio?, conferma l'eliminazione digitando delete.
Fai clic su Elimina.

API

Utilizza il metodo projects.locations.dataExchanges.delete.

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

Per ulteriori informazioni sulle attività che puoi eseguire negli scambi di dati utilizzando le API, consulta i metodi di projects.locations.dataExchanges.

Passaggi successivi

Scopri di più sulla gestione delle schede.
Scopri come concedere i ruoli utente ad Analytics Hub.
Scopri come visualizzare e iscriversi alle schede.
Scopri di più sull'audit logging di Analytics Hub.