Gestire le schede
In qualità di publisher Analytics Hub, puoi eseguire le seguenti operazioni: attività:
- Crea schede in uno scambio di dati per cui disponi dell'accesso con diritti di pubblicazione.
- Aggiornare, eliminare, condividere e visualizzare le metriche di utilizzo per le schede.
- Gestisci ruoli diversi per le schede Analytics Hub, ad esempio amministratori, iscritti e visualizzatori delle schede.
- Visualizza tutti gli iscritti che si sono iscritti alla tua scheda.
- Monitora l'utilizzo delle tue schede.
- Rimuovi gli abbonati dalla tua scheda.
Una scheda è un riferimento a un set di dati condiviso elencato da un publisher uno scambio di dati. Le schede possono essere dei due tipi seguenti in base a Identity and Access Management (IAM) impostata per la scheda e il tipo di scambio di dati che contiene l'elenco:
Scheda pubblica. Può essere scoprito e hanno effettuato l'iscrizione dagli utenti Google Cloud (
allAuthenticatedUsers
). Le schede in uno scambio di dati pubblico sono schede pubbliche. Queste schede possono essere riferimenti a un set di dati pubblico gratuito o a un set di dati commerciale. Se fa riferimento a un set di dati commerciale, gli abbonati possono richiedere l'accesso e il fornitore di dati contatta gli abbonati.Scheda privata. Vengono condivisi direttamente con individui o gruppi. Per Ad esempio, una scheda privata può fare riferimento al set di dati delle metriche di marketing che condividi con altri team interni all'organizzazione. Anche se può consentire a
allAuthenticatedUsers
di si iscrivi alle tue schede, la scheda rimarrà privata e non verrà visualizzata come scheda pubblica nella pagina Analytics Hub. Per condividere queste schede con gli utenti, condividi con loro l'URL della scheda. Per rendere una scheda privata rilevabile, devi rendere la tua pubbliche.
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 le schede e gli abbonamenti, devi disporre di uno dei seguenti requisiti: Ruoli di Analytics Hub:
il ruolo Publisher Analytics Hub (
roles/analyticshub.publisher
), che ti consente di creare, aggiornare, eliminare e impostare i criteri IAM sulle tue schede.il ruolo Amministratore schede Analytics Hub (
roles/analyticshub.listingAdmin
), che consente di aggiornare, eliminare e impostare i criteri IAM sulle schede.il ruolo Amministratore Analytics Hub (
roles/analyticshub.Admin
), che ti consente di creare, aggiornare, eliminare e impostare i criteri IAM su tutte le schede in lo scambio di dati.
Per saperne di più, consulta Ruoli utente di Analytics Hub. Per scoprire come concedere questi ruoli ad altri utenti, consulta Creare una scheda Amministratore.
Inoltre, per creare schede, devi avere anche bigquery.datasets.get
e
bigquery.datasets.update
autorizzazioni per i set di dati per i quali vuoi
creare schede. Le seguenti impostazioni predefinite BigQuery
ruoli contengono
Autorizzazione bigquery.datasets.update
:
- Ruolo Proprietario dati BigQuery (
roles/bigquery.dataOwner
) - Ruolo Amministratore BigQuery (
roles/bigquery.admin
)
Per visualizzare tutti gli scambi di dati nei progetti di un'organizzazione
devi avere accesso, devi avere resourcemanager.organizations.get
autorizzazione. Non sono presenti impostazioni predefinite BigQuery
ruoli che contengono
dovrai usare un ruolo personalizzato IAM.
Visualizza scambi di dati
Per visualizzare l'elenco degli scambi di dati della tua organizzazione a cui hai accesso, consulta Visualizzare gli scambi di dati. Se lo scambio di dati avviene in un'altra organizzazione, L'amministratore di Analytics Hub deve condividere un link a questi dati piattaforma di scambio pubblicitario con te.
Crea una scheda
Una scheda è un riferimento a un set di dati condiviso che un publisher elenca in uno scambio di dati.
Per creare una scheda, procedi nel seguente modo:
Console
Vai alla pagina Analytics Hub.
Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.
Fai clic sul nome dello scambio di dati in cui vuoi creare la scheda.
Fai clic su
Crea scheda.Nella pagina Crea scheda, in Nome visualizzato, inserisci il nome del dell'annuncio.
Se stai creando una scheda commerciale, devi compilare il Richiedi contatto per l'accesso. Devi inserire un indirizzo email o un URL del modulo di accettazione per consentire agli abbonati di contattarti.
(Facoltativo) Inserisci i seguenti dettagli:
Contatto principale: inserisci un indirizzo email o un URL del contatto principale per la scheda.
Categoria: seleziona fino a due categorie che meglio rappresentano la tua dell'annuncio. Gli iscritti possono filtrare le schede in base a queste categorie.
Provider: espandi la sezione Provider e specifica i dettagli nel campo seguenti campi:
- Nome provider: il nome del fornitore del set di dati.
- Contatto principale del fornitore: un'email o un URL del set di dati contatto principale del fornitore.
Gli abbonati possono filtrare le schede in base ai fornitori di dati.
Editore: espandi la sezione Editore e specifica i dettagli in nei seguenti campi:
- Nome publisher: il nome del publisher che crea l'account di servizio dell'annuncio.
- Contatto principale del publisher: un'email o un URL del set di dati contatto principale del publisher.
Icona: un'icona per la tua scheda. I formati di file PNG e JPEG sono supportati. Le dimensioni dei file delle icone devono essere inferiori a 512 KiB e non superiori a 512 x 512 pixel.
Descrizione: una breve descrizione della tua scheda. Gli abbonati possono cercare schede in base alla descrizione.
In Set di dati di origine, seleziona il set di dati da elencare nel lo scambio di dati. Il set di dati di origine deve trovarsi nella stessa regione dei dati piattaforma di scambio pubblicitario. Non puoi aggiornare questo campo dopo aver creato la scheda.
In In uscita dai dati, seleziona il modo in uscita dai dati in uscita. Solo gli iscritti con offerte non disponibili nella versione o nella versione Enterprise Plus possono eseguire query sui dati con restrizioni relative al traffico in uscita.
- Per applicare restrizioni per il traffico in uscita dai dati al set di dati condiviso, ma non su i risultati della query del set di dati condiviso, seleziona Disattiva copia e l'esportazione dei dati condivisi.
- Per applicare il traffico in uscita dai dati restrizioni relative al set di dati condiviso e ai risultati delle query dell'account set di dati, seleziona Disabilita la copia e l'esportazione dei risultati della query, impostare automaticamente anche Disattiva la copia e l'esportazione dei dati condivisi.
- Per applicare restrizioni relative al traffico in uscita dalla copia e all'esportazione dell'API di dati sui nel set di dati, seleziona Disabilita la copia e l'esportazione delle tabelle tramite le API, imposterà automaticamente anche Disattiva la copia e l'esportazione dei dati condivisi.
(Facoltativo) Nella sezione Dettagli scheda, fai clic sul pulsante Pubblico la rilevabilità pubblica per abilitare la rilevabilità pubblica. Devi concedere ad Analytics Hub Ruolo Visualizzatore (
roles/analyticshub.viewer
) aallUsers
oppureallAuthenticatedUsers
. Per ulteriori informazioni, vedi Concedere il ruolo per un dell'annuncio. Se la piattaforma di scambio è già pubblica, le autorizzazioni dell'elenco sono già ereditate e non vengono obbligatorio.Le piattaforme di scambio pubblicitario pubblicamente non possono avere schede private a causa di ereditarietà delle autorizzazioni, ma gli scambi privati possono avere schede pubbliche. Per schede pubbliche, il progetto in cui si trova l'elenco dei dati deve avere un'organizzazione e un account di fatturazione associati.
(Facoltativo) Nella sezione Documentazione > Markdown, puoi inserisci informazioni aggiuntive, come query di esempio che puoi eseguire set di dati, link a qualsiasi documentazione pertinente ed eventuali altri informazioni che possono aiutare gli abbonati a usare il tuo set di dati.
Fai clic su Salva.
API
Utilizza la projects.locations.dataExchanges.listings.create
gcloud.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene i dati scambio in cui vuoi creare la scheda.LOCATION
: la località dello scambio di dati. Per ulteriori informazioni sulle sedi Analytics Hub, consulta Regioni supportate.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.LISTING_ID
: l'ID scheda.
Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta conterrà i dettagli dell'elenco.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Concedere agli utenti l'accesso a una scheda
Se vuoi concedere agli utenti l'accesso a una scheda privata, devi impostare
Criterio IAM per un individuo o un gruppo per quella scheda. Per un
scheda commerciale, lo scambio di dati deve essere pubblico.
Le schede in uno scambio di dati pubblico vengono visualizzate in Analytics Hub per
tutti gli utenti Google Cloud (allAuthenticatedUsers
).
Per consentire agli utenti di richiedere l'accesso a schede commerciali, devi concedere loro
il ruolo Visualizzatore Analytics Hub.
Se vuoi rendere la tua scheda accessibile a tutti, comprese le persone che
non utilizzano Google Cloud, devi concedere a allUsers
il ruolo Visualizzatore Analytics Hub
(roles/analyticshub.viewer
).
Per concedere agli utenti l'accesso per visualizzare o abbonarsi alla tua scheda, procedi nel seguente modo:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda alla quale vuoi aggiungere abbonati.
Fai clic su
Imposta autorizzazioni.Per aggiungere entità, fai clic su
Aggiungi principal.Nel campo Nuove entità, aggiungi i seguenti dettagli in base al tipo dell'elenco:
Per una scheda privata, inserisci gli indirizzi email dell'identità a cui desideri concedere l'accesso.
Per una scheda pubblica, aggiungi
allAuthenticatedUsers
.Per una scheda pubblica rilevabile da tutti, anche non Google Cloud utenti, aggiungi
allUsers
.
Per Seleziona un ruolo, tieni il puntatore del mouse su Analytics Hub e poi in base al tipo di scheda, seleziona uno dei seguenti ruoli:
Per una scheda commerciale, seleziona il ruolo Visualizzatore Analytics Hub. Questo consente agli utenti di visualizzare la scheda e richiedere l'accesso.
Per una scheda pubblica privata o non commerciale, seleziona il Abbonato ad Analytics Hub. Questo ruolo consente agli utenti iscriverti alla tua scheda.
Per ulteriori informazioni, consulta Ruoli di abbonato e Visualizzatore Analytics Hub.
Fai clic su Salva.
API
Leggi la norma esistente con il metodo
getIamPolicy
delle schede utilizzando il Metodoprojects.locations.dataExchanges.listings.getIamPolicy
.POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
Sostituisci quanto segue:
PROJECT_ID
: il progetto ID, ad esempiomy-project-1
.LOCATION
: località dello scambio di dati che contiene la scheda.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.LISTING_ID
: l'ID scheda.
Analytics Hub restituisce il criterio corrente nella risposta.
Per aggiungere o rimuovere i membri e i relativi ruoli, 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
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.listings.setIamPolicy
gcloud. Nel corpo della richiesta, fornisci il criterio IAM aggiornato dal passaggio precedente.POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_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.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Crea un URL non autenticato per la scheda pubblica
Per creare un URL di una scheda Analytics Hub non autenticato che sia visibile anche agli utenti che non utilizzano Google Cloud, procedi nel seguente modo:
Vai alla pagina Analytics Hub.
Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sul nome visualizzato per esaminare i dettagli della scheda. La scheda deve avere rilevabilità pubblica in un bucket in cui è abilitato il controllo delle versioni.
Fai clic su Copia link pubblico per generare un URL di scheda non autenticato. Marca assicurati che questa scheda conceda a
allUsers
il ruolo Visualizzatore Analytics Hub (roles/analyticshub.viewer
).
Crea un amministratore della scheda
Per consentire agli utenti di gestire le schede, devi creare Analytics Hub amministratori delle schede. Per creare amministratori delle schede, devi concedere agli utenti Ruolo Publisher Analytics Hub o Amministratore scheda Analytics Hub a livello di scheda. Per ulteriori informazioni su come concedere questi ruoli per una scheda, consulta Assegna il ruolo per una scheda.
Visualizza tutti gli abbonamenti
Per visualizzare tutte le iscrizioni correnti alla tua scheda, seleziona una delle seguenti opzioni opzioni:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda per la quale vuoi per gestire gli abbonamenti.
Fai clic sulla scheda per cui desideri elencare tutti gli iscritti.
Per visualizzare tutti gli iscritti della tua scheda, fai clic su Gestisci abbonamenti.
(Facoltativo) Puoi filtrare i risultati in base ai dettagli dell'iscritto.
In alternativa, se hai accesso al set di dati condiviso, puoi seguire questi passaggi per elencare gli iscritti:
Vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e seleziona il set di dati condiviso.
Nell'elenco Condivisione di
, seleziona Gestisci abbonamenti.
SQL
L'esempio seguente utilizza il metodo
INFORMATION_SCHEMA.SCHEMATA_LINKS
visualizzazione
per elencare tutti i set di dati collegati a un set di dati condiviso in myproject
che si trovano nel
Regione us
:
SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;
L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+ | catalog_name | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | +----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+ | myproject | myschema1 | subscriptionproject1 | 974999999291 | subscriptionld1 | subscriptionorg | | myproject | myschema2 | subscriptionproject2 | 974999999292 | subscriptionld2 | subscriptionorg | | myproject | myschema3 | subscriptionproject3 | 974999999293 | subscriptionld3 | subscriptionorg | +----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
API
Utilizza il projects.locations.dataExchanges.listings.listSubscriptions.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto della scheda che a cui vuoi abbonarti.LOCATION
: posizione della scheda che a cui vuoi abbonarti.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati contenente la scheda a cui vuoi abbonarti.LISTING_ID
: l'ID della scheda che vuoi .
Rimuovere una sottoscrizione
Se rimuovi dalle tue schede un'iscrizione creata prima del 25 luglio 2023: il set di dati collegato ottiene scollegato dallo spazio condiviso del set di dati. Iscritti possono ancora vedere i set di dati nei loro progetti, ma non sono più collegati il set di dati condiviso.
Per rimuovere dalle tue schede un abbonamento creato prima del 25 luglio 2023: questi passaggi:
Per elencare tutti i sottoscrittori di una scheda, segui le istruzioni della console Google Cloud istruzioni in Visualizzare tutti gli abbonamenti.
Per rimuovere un iscritto da una scheda, fai clic su
Elimina. Se vuoi rimuovere tutte le sottoscrizioni, fai clic su Rimuovi tutte le sottoscrizioni.Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci
remove
per confermare.Fai clic su Rimuovi.
Per rimuovere le iscrizioni create dopo il 25 luglio 2023:
Console
Per elencare tutti i sottoscrittori di una scheda, segui le istruzioni della console Google Cloud istruzioni in Visualizzare tutti gli abbonamenti.
Fai clic sulla scheda Sottoscrizioni.
Per rimuovere un abbonato da una scheda, seleziona gli abbonamenti che desideri rimuovere e fai clic su
Rimuovi abbonamenti.Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci
remove
per confermare.Fai clic su Rimuovi.
API
Utilizza il metodoprojects.locations.subscriptions.revoke.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto della sottoscrizione che da rimuovere.LOCATION
: la località dell'abbonamento che da rimuovere.SUBSCRIPTION
: l'ID del abbonamento che vuoi rimuovere.
Aggiornare una scheda
Per aggiornare una scheda, procedi nel seguente modo:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda da aggiornare.
Fai clic su
Modifica scheda.Modifica i valori nei campi. Puoi modificare tutti i valori tranne l'origine del set di dati della scheda.
Facoltativamente,
- Se attivi la rilevabilità pubblica, concedi a
allUsers
oallAuthenticatedUsers
il ruolo Visualizzatore Analytics Hub (roles/analyticshub.viewer
). Per ulteriori informazioni, consulta l'articolo Concedi ruolo per una scheda - Se disattivi la rilevabilità pubblica,
rimuovi il ruolo Visualizzatore Analytics Hub da
allUsers
eallAuthenticatedUsers
. Gli scambi pubblici non possono avere schede private, mentre gli scambi privati possono avere schede pubbliche.
- Se attivi la rilevabilità pubblica, concedi a
Per visualizzare l'anteprima delle modifiche, fai clic su Anteprima.
Per salvare le modifiche, fai clic su Salva.
API
Utilizza il metodo projects.locations.dataExchanges.listings.patch
.
PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK
Sostituisci UPDATEMASK
con l'elenco dei campi
che vuoi aggiornare. Per aggiornare più valori, utilizza i valori separati da virgole
dall'elenco di lettura. Nel corpo della richiesta, specifica i valori aggiornati.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Eliminare una scheda
Se elimini una scheda, gli iscritti non potranno più visualizzarla. L'eliminazione di una scheda elimina anche tutti i set di dati collegati (rimuove tutte le iscrizioni) dai tuoi iscritti in modo programmatico a gestire i progetti.
Se elimini una scheda, non puoi annullarla. Per eliminare una scheda: passaggi:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda da eliminare.
Fai clic su
Elimina.Nella finestra di dialogo Vuoi eliminare la scheda?, conferma l'eliminazione digitando delete.
Fai clic su Elimina.
API
Utilizza il metodo projects.locations.dataExchanges.listings.delete
.
DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Visualizza una scheda nella sezione In primo piano
Per aumentare la visibilità e l'awareness della tua scheda nel Analytics Hub, le schede possono essere visualizzate nel Sezione In primo piano. Le schede in primo piano sono regolate dal Partner Google Cloud Contratto Advantage.
Partner interessati a visualizzare le loro schede nella sezione In primo piano del catalogo Analytics Hub devono soddisfare i seguenti criteri:
I dati condivisi devono risiedere in BigQuery.
Deve essere registrata al programma Partner Advantage con la designazione Build.
La scheda deve essere stata creata e avere attivato la rilevabilità pubblica.
Per richiedere che la tua scheda venga visualizzata nella sezione In primo piano, compila e invia il modulo di accettazione. Per richiedere la rimozione della scheda dalla sezione, invia lo stesso modulo di accettazione.
Passaggi successivi
- Ulteriori informazioni sull'architettura di Analytics Hub
- Scopri come visualizzare e iscriverti alle schede.
- Scopri di più sui ruoli utente di Analytics Hub.
- Scopri di più sulla creazione di set di dati.
- Scopri di più sul log di controllo di Analytics Hub.
- Scopri come monitorare le schede.