Gestire gli scambi di dati

In qualità di amministratore di Analytics Hub, puoi eseguire le seguenti operazioni 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, publisher, abbonati e spettatori.

Per impostazione predefinita, uno scambio di dati è privato e solo gli utenti o i gruppi che hanno accesso a quella piattaforma di scambio pubblicitario possono visualizzare o sottoscrivere i dati. Tuttavia, se vuoi che le schede vengano scoperte e a cui gli utenti di Google Cloud (allAuthenticatedUsers) si iscrivano, puoi richiedere di rendere pubblico lo 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 attivare 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 autorizzazioni necessarie per abilitare l'API Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

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

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub, segui questi passaggi:

Console

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

Abilitare l'API Analytics Hub

gcloud

Esegui gcloud services abilita :

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

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

Creare uno scambio di dati

Per creare uno scambio di dati:

Console

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic su Crea della piattaforma di scambio pubblicitario.

  3. Nella finestra di dialogo Crea scambio, seleziona un progetto e una regione. per lo scambio di dati. Non puoi aggiornare il progetto e la regione dopo per creare lo scambio di dati.

  4. In Nome visualizzato, inserisci un nome per lo scambio di dati.

  5. (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.

  6. Per attivare la rilevabilità pubblica, fai clic sul pulsante di attivazione/disattivazione Rilevabilità pubblica. Una volta che uno scambio è rilevabile pubblicamente, tutte le schede dello scambio vengono visualizzate e possono essere cercate nel catalogo. Se attivi la rilevabilità pubblica, devi configurare le autorizzazioni della piattaforma di scambio pubblicitario. A causa di ereditarietà delle autorizzazioni, per impostazione predefinita tutte le schede avranno lo stesso tipo di rilevabilità pubblica dello scambio. Pertanto, gli scambi pubblici non possono avere schede private, mentre gli scambi privati possono avere schede pubbliche (ad esempio, puoi impostare il tipo di rilevabilità pubblica a livello di singola scheda). Il progetto in cui stai creando lo scambio di dati deve avere un account di fatturazione e un'organizzazione associati.

  7. Fai clic su Create Exchange (Crea piattaforma di scambio pubblicitario).

  8. (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:

    2. Per salvare le autorizzazioni, fai clic su Imposta autorizzazioni.

  9. 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 maggiori 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 dello scambio di dati. Se la richiesta riesce, il corpo della risposta contiene i dettagli dello scambio di dati.

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

Aggiornare uno scambio di dati

Per aggiornare uno scambio di dati:

Console

  1. Vai alla pagina Hub di analisi.

    Vai ad Analytics Hub

  2. Nell'elenco degli scambi di dati, fai clic su uno scambio di dati a cui vuoi aggiornamento.

  3. Fai clic su Modifica scambio.

  4. Nella finestra di dialogo Modifica piattaforma di scambio pubblicitario, aggiorna i seguenti campi:

    • Nome visualizzato
    • Contatto principale
    • Descrizione
    • Rilevabilità pubblica
      • Se attivi la visibilità pubblica, assegna il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers.
      • Se disattivi la rilevabilità pubblica, rimuovi Analytics Hub Ruolo Visualizzatore (roles/analyticshub.viewer) da allUsers o allAuthenticatedUsers. Gli scambi pubblici non possono avere schede private, mentre quelli privati possono avere schede pubbliche.

  5. 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 di 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 di 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
  • Rilevabilità pubblica

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

Visualizzare gli scambi di dati

Per visualizzare tutti gli scambi di dati della tua organizzazione a cui hai accesso:

Console

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Visualizza 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 scoprire di più, consulta Ottenere l'ID organizzazione.
  • LOCATION: la località per cui vuoi elencare i scambi di dati esistenti.

Condividere uno scambio di dati

Se il publisher di Analytics Hub appartiene a un'organizzazione diversa da quella che contiene 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.

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Nell'elenco degli scambi di dati, fai clic su Altre opzioni.

  3. Fai clic su Copia link di condivisione.

Concedere agli utenti l'accesso a uno scambio di dati

Per consentire agli utenti di accedere a uno scambio di dati, devi impostare il criterio IAM per lo scambio di dati. Per informazioni sulle impostazioni predefinite Ruoli utente IAM, consulta Ruoli utente Analytics Hub. Per farlo, segui questi passaggi:

Console

  1. Nella console Google Cloud, vai alla pagina di Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio dati per cui vuoi impostare le autorizzazioni.

  3. Fai clic su Imposta autorizzazioni.

  4. Per aggiungere entità, fai clic su Aggiungi entità.

  5. Nel campo Nuove entità, aggiungi le email a cui vuoi concedere l'accesso.

  6. In Seleziona un ruolo, posiziona il cursore del mouse su Analytics Hub e poi seleziona uno dei seguenti ruoli di Identity and Access Management (IAM):

    • Amministratore Analytics Hub
    • Publisher Analytics Hub
    • Analytics Hub Listing Admin
    • Abbonato ad Analytics Hub
    • Analytics Hub Viewer

  7. Fai clic su Salva.

API

  1. Leggi la norma esistente con il metodo getIamPolicy delle schede utilizzando il projects.locations.dataExchanges.getIamPolicy :

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

    Sostituisci quanto segue:

    • PROJECT_ID: il progetto ID, ad esempio my-project-1.
    • LOCATION: posizione per i tuoi dati piattaforma di scambio pubblicitario.
    • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati.

    Analytics Hub restituisce le norme correnti.

  2. Aggiungere o rimuovere membri e le relative soluzioni IAM (Identity and Access Management) associate ruoli, modificare il criterio con un editor di testo. Utilizza il seguente formato per aggiungere i 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"
}

  3. Scrivi il criterio aggiornato utilizzando il metodo projects.locations.dataExchanges.setIamPolicy. Nel corpo della richiesta, fornisci il criterio IAM aggiornato dal 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 conterrà i dettagli dell'elenco.

Creare amministratori Analytics Hub

Per gestire gli scambi di dati, devi creare Analytics Hub Google Workspace for Education. Per creare amministratori della piattaforma di scambio, 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 in un progetto, concedi il ruolo Amministratore di Analytics Hub per quel progetto. Se vuoi che gli amministratori gestiscano uno scambio di dati specifico, concedi 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 quella piattaforma di scambio pubblicitario può visualizzare le sue schede o abbonarsi. Tuttavia, puoi scegliere di rendere pubblico uno scambio di dati. Le schede negli scambi di dati pubblici possono essere rilevato e sottoscritto dagli utenti Google Cloud (allAuthenticatedUsers).

Per rendere pubblico uno scambio di dati:

  1. Per consentire a allAuthenticatedUsers di visualizzare le schede, devi concedere al cliente il ruolo Visualizzatore Analytics Hub a livello di scambio di dati.

  2. Per consentire a allAuthenticatedUsers di iscriversi alle schede, devi concedergli il ruolo Subscriber di Analytics Hub a livello di scambio dati.

  3. Attiva la visibilità pubblica quando crei o aggiorni uno scambio di dati. Specifica le impostazioni autorizzazioni quando rendi pubblico uno scambio di dati.

Eliminare uno scambio di dati

Quando un trasferimento di dati viene eliminato, vengono eliminate anche tutte le schede al suo interno. Tuttavia, i set di dati condivisi e quelli collegati non vengono eliminati. Inoltre, quando un progetto viene eliminato, gli scambi di dati al suo interno non vengono eliminati. Prima di eliminare il progetto, dovrai eliminare questi scambi di dati. Se elimini uno scambio di dati, non puoi annullare l'operazione.

Per eliminare uno scambio di dati:

Console

  1. Vai alla pagina Hub di analisi.

    Vai ad Analytics Hub

  2. Nell'elenco degli scambi di dati, fai clic sull'interscambio di dati da eliminare.

  3. Fai clic su Elimina scambio.

  4. Nella finestra di dialogo Vuoi eliminare la piattaforma di scambio?, conferma l'eliminazione digitando delete.

  5. 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 sugli scambi di dati utilizzando le API, consulta i metodi projects.locations.dataExchanges.

Passaggi successivi