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, iscritti 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
schede da scoprire
e si è iscritto a
dagli utenti Google Cloud (allAuthenticatedUsers
),
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 di quanto segue 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.
Abilitare l'API Analytics Hub
Per attivare l'API Analytics Hub:
Console
Vai all'API Analytics Hub per il tuo progetto Google Cloud e abilitarlo.
gcloud
Esegui gcloud services abilita :
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 ulteriori informazioni, consulta Amministratore Analytics Hub
ruolo. Per scoprire come
concedi questo ruolo ad altri utenti, consulta Creare Analytics Hub
Google Workspace.
Creare uno scambio di dati
Per creare uno scambio di dati:
Console
Vai alla pagina Analytics Hub.
Fai clic su
Crea della piattaforma di scambio pubblicitario.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.
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 per lo scambio di dati.
- Descrizione: inserisci una descrizione per lo scambio di dati.
Per attivare la rilevabilità pubblica, fai clic su Rilevabilità pubblica pulsante di attivazione/disattivazione. Quando una piattaforma di scambio pubblicitario è rilevabile pubblicamente, tutte le schede nella le piattaforme di scambio pubblicitario sono visualizzate e cercate nel catalogo. Se abiliti l'accesso pubblico la rilevabilità, devi configurare le autorizzazioni per lo scambio. 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 i dati la piattaforma di scambio pubblicitario deve avere un'organizzazione e un account di fatturazione associati.
Fai clic su Create Exchange (Crea piattaforma di scambio pubblicitario).
(Facoltativo) Nella sezione Autorizzazioni di Exchange, segui questi passaggi:
Inserisci gli indirizzi email nei seguenti campi per concedere alla Ruoli utente di Analytics Hub:
- Amministratori: a questi utenti è assegnato il ruolo Amministratore Analytics Hub .
- Publisher: a questi utenti viene assegnato il ruolo Publisher Analytics Hub. . Per informazioni sulle attività che i publisher possono eseguire, consulta Gestire le schede.
- Iscritti: a questi utenti viene assegnato il ruolo Iscritti ad Analytics Hub. . Per informazioni sulle attività che gli abbonati possono eseguire, consulta Visualizzare e iscriversi alle schede.
- Spettatori: a questi utenti viene assegnato il Visualizzatore Analytics Hub.
.
Gli spettatori possono visualizzare le schede.
- Se la rilevabilità pubblica è abilitata, concedi ad Analytics Hub
Ruolo Visualizzatore (
roles/analyticshub.viewer
) aallUsers
oppureallAuthenticatedUsers
.
- Se la rilevabilità pubblica è abilitata, concedi ad Analytics Hub
Ruolo Visualizzatore (
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 per creare lo scambio di dati.LOCATION
: la località dello scambio di dati. Per ulteriori informazioni sulle sedi Analytics Hub, consulta Regioni supportate.DATAEXCHANGE_ID
: l'ID dello scambio di dati.
Nel corpo della richiesta, fornisci i dettagli dello scambio di dati. Se la richiesta ha esito positivo, il corpo della risposta conterrà i dettagli sullo scambio di dati.
Per ulteriori informazioni sulle attività che puoi eseguire sugli scambi di dati utilizzando
API, vedi i metodi projects.locations.dataExchanges
.
Aggiornare uno scambio di dati
Per aggiornare uno scambio di dati:
Console
Vai alla pagina Analytics Hub.
Nell'elenco degli scambi di dati, fai clic su uno scambio di dati a cui vuoi aggiornamento.
Fai clic su
Modifica scambio.Nella finestra di dialogo Modifica piattaforma di scambio pubblicitario, aggiorna i seguenti campi:
- Nome visualizzato
- Contatto principale
- Descrizione
- Rilevabilità pubblica
- Se attivi la rilevabilità pubblica, concedi ad Analytics Hub
Ruolo Visualizzatore (
roles/analyticshub.viewer
) aallUsers
oppureallAuthenticatedUsers
. - Se disattivi la rilevabilità pubblica,
rimuovi Analytics Hub
Ruolo Visualizzatore (
roles/analyticshub.viewer
) daallUsers
oallAuthenticatedUsers
. Gli scambi pubblici non possono avere schede private, mentre gli scambi privati possono avere schede pubbliche.
- Se attivi la rilevabilità pubblica, concedi ad Analytics Hub
Ruolo Visualizzatore (
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 i valori separati da virgole
di Google Cloud, ad esempio per aggiornare il nome visualizzato e il contatto principale di un
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
.
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.
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 maggiori informazioni consulta la sezione Recupero dell'ID organizzazione.
- LOCATION: la sede per cui vuoi elencare i scambi di dati esistenti.
Condividere uno scambio di dati
Se il publisher Analytics Hub appartiene a un'altra organizzazione dell'organizzazione che contiene lo scambio di dati, il publisher 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.
Nell'elenco degli scambi di dati, fai clic su
. Altre opzioni.Fai clic su
Copia link condivisione.
Concedere agli utenti l'accesso a uno scambio di dati
Per consentire agli utenti di accedere a uno scambio di dati, devi impostare 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
Nella console Google Cloud, vai alla pagina di 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 principal.Nel campo Nuove entità, aggiungi le email a cui vuoi concedere l'accesso.
Per Seleziona un ruolo, tieni il puntatore del mouse su Analytics Hub e poi seleziona uno dei seguenti ruoli di Identity and Access Management (IAM):
- Amministratore Analytics Hub
- Publisher Analytics Hub
- Amministratore schede Analytics Hub
- Abbonato ad Analytics Hub
- Visualizzatore Analytics Hub
Fai clic su Salva.
API
Leggi la norma esistente con il metodo
getIamPolicy
delle schede utilizzando ilprojects.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 esempiomy-project-1
.LOCATION
: posizione per i tuoi dati piattaforma di scambio pubblicitario.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.
Analytics Hub restituisce il criterio corrente.
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 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
agroup:subscribers@example.com
, aggiungi la seguente associazione al criterio:{ "members": [ "group:subscribers@example.com" ], "role":"roles/analyticshub.subscriber" }
Scrivi il criterio aggiornato utilizzando la proprietà
projects.locations.dataExchanges.setIamPolicy
gcloud. 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 di Exchange, devi concedere agli utenti
Il ruolo Amministratore 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, concedere il ruolo Amministratore 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
scegli 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:
Per consentire a
allAuthenticatedUsers
di visualizzare le schede, devi concedere al cliente il ruolo Visualizzatore Analytics Hub a livello di scambio di dati.Per consentire a
allAuthenticatedUsers
di iscriversi alle schede, devi concedere il ruolo Iscritto Analytics Hub a livello di scambio di dati.Attiva la rilevabilità pubblica quando crei o aggiornare uno scambio di dati. Specifica le impostazioni autorizzazioni quando rendi pubblico uno scambio di dati.
Eliminare uno scambio di dati
Quando viene eliminato uno scambio di dati, vengono eliminate anche tutte le relative schede. 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. L'eliminazione di uno scambio di dati non può essere annullata.
Per eliminare uno scambio di dati:
Console
Vai alla pagina Analytics Hub.
Dall'elenco degli scambi di dati, fai clic sullo scambio di dati che vuoi eliminare.
Fai clic su
Elimina scambio.Nella finestra di dialogo Vuoi eliminare la piattaforma di 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 sugli scambi di dati utilizzando
API, vedi i metodi projects.locations.dataExchanges
.
Passaggi successivi
- Scopri di più sulla gestione delle schede.
- Scopri come concedere i ruoli utente di Analytics Hub.
- Scopri come visualizzare e iscriverti alle schede.
- Scopri di più sul log di controllo di Analytics Hub.