Gestire gli scambi di dati

Console

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

Abilita l'API Analytics Hub

gcloud

Esegui il comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Console

1. Vai alla pagina Hub di analisi.

   Vai ad Analytics Hub

2. Fai clic su add_box Crea scambio.

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 aver creato 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 dell'eredità delle autorizzazioni, per impostazione predefinita tutte le schede verranno impostate con lo stesso tipo di rilevabilità pubblica della piattaforma di scambio pubblicitario. Pertanto, le piattaforme di scambio pubblicitario pubbliche non possono avere schede private, ma quelle private possono avere schede pubbliche (ad esempio, puoi impostare il tipo di visibilità 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 Crea scambio.

8. (Facoltativo) Nella sezione Autorizzazioni di scambio, segui questi passaggi:

   1. Inserisci gli indirizzi email nei seguenti campi per concedere i ruoli utente di Analytics Hub:

      • Amministratori: a questi utenti è assegnato il ruolo Amministratore di Analytics Hub.
      • Editori: a questi utenti è assegnato il ruolo Editore di Analytics Hub. Per informazioni sulle attività che possono essere eseguite dai publisher, consulta Gestire le schede.
      • Abbonati: a questi utenti viene assegnato il ruolo Abbonato ad Analytics Hub. Per informazioni sulle attività che possono essere eseguite dagli iscritti, consulta Visualizzare e iscriversi alle schede.
      • Visualizzatori: a questi utenti è assegnato il ruolo Visualizzatore di Analytics Hub. Gli spettatori possono visualizzare le schede.
        • Se la visibilità pubblica è attivata, assegna il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers.

   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 posizione per lo 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.

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 da aggiornare.

3. Fai clic su mode_edit 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 visibilità pubblica,rimuovi il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer) da allUsers oallAuthenticatedUsers. Gli scambi pubblici non possono avere schede private, mentre gli scambi 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 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
• Rilevabilità pubblica

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

Console

1. Vai alla pagina Hub di analisi.

   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 la quale vuoi elencare gli scambi di dati esistenti.

Console

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

   Vai ad Analytics Hub

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

3. Fai clic su person Imposta autorizzazioni.

4. Per aggiungere entità, fai clic su person_add 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):

   • Analytics Hub Admin
   • Analytics Hub Publisher
   • Analytics Hub Listing Admin
   • Analytics Hub Subscriber
   • Analytics Hub Viewer

7. Fai clic su Salva.

API

1. Leggi il criterio esistente con il metodo getIamPolicy della 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 del progetto, ad esempio my-project-1.
   • LOCATION: la posizione del tuo scambio di dati.
   • DATAEXCHANGE_ID: l'ID dello scambio dati.

   Analytics Hub restituisce le norme correnti.

2. Per aggiungere o rimuovere membri e i relativi ruoli IAM (Identity and Access Management), modifica 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 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 va a buon fine, il corpo della risposta contiene i dettagli della scheda.

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 delete Elimina scambio.

4. Nella finestra di dialogo Eliminare la piattaforma di scambio pubblicitario?, 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.