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:

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 saperne di più 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.

Abilitare l'API Analytics Hub

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

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

    Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.

  2. Fai clic sul nome dello scambio di dati in cui vuoi creare la scheda.

  3. Fai clic su Crea scheda.

  4. Nella pagina Crea scheda, in Nome visualizzato, inserisci il nome del dell'annuncio.

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

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

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

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

  9. (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) a allUsers oppure allAuthenticatedUsers. 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.

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

  11. 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

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio di dati che contiene la scheda.

  3. Fai clic sulla scheda alla quale vuoi aggiungere abbonati.

  4. Fai clic su Imposta autorizzazioni.

  5. Per aggiungere entità, fai clic su Aggiungi principal.

  6. 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.

  7. 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 ulteriori informazioni, consulta Ruoli di abbonato e Visualizzatore Analytics Hub.

  8. Fai clic su Salva.

API

  1. Leggi la norma esistente con il metodo getIamPolicy delle schede utilizzando il Metodo projects.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 esempio my-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.

  2. 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 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 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:

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

    Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.

  2. Fai clic sul nome dello scambio di dati che contiene la scheda.

  3. Fai clic sul nome visualizzato per esaminare i dettagli della scheda. La scheda deve avere rilevabilità pubblica in un bucket con il controllo delle versioni attivo.

  4. 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

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio di dati che contiene la scheda per la quale vuoi per gestire gli abbonamenti.

  3. Fai clic sulla scheda per cui desideri elencare tutti gli iscritti.

  4. Per visualizzare tutti gli iscritti della tua scheda, fai clic su Gestisci abbonamenti.

    gestire gli iscritti

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

  1. Vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel riquadro Explorer, espandi il progetto e seleziona il set di dati condiviso.

  3. 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:

  1. Per elencare tutti i sottoscrittori di una scheda, segui le istruzioni della console Google Cloud istruzioni in Visualizzare tutti gli abbonamenti.

  2. Per rimuovere un iscritto da una scheda, fai clic su Elimina. Se vuoi rimuovere tutte le sottoscrizioni, fai clic su Rimuovi tutte le sottoscrizioni.

  3. Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci remove per confermare.

  4. Fai clic su Rimuovi.

Per rimuovere le iscrizioni create dopo il 25 luglio 2023:

Console

  1. Per elencare tutti i sottoscrittori di una scheda, segui le istruzioni della console Google Cloud istruzioni in Visualizzare tutti gli abbonamenti.

  2. Fai clic sulla scheda Sottoscrizioni.

  3. Per rimuovere un abbonato da una scheda, seleziona gli abbonamenti che desideri rimuovere e fai clic su Rimuovi abbonamenti.

  4. Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci remove per confermare.

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

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio di dati che contiene la scheda.

  3. Fai clic sulla scheda da aggiornare.

  4. Fai clic su Modifica scheda.

  5. Modifica i valori nei campi. Puoi modificare tutti i valori tranne l'origine del set di dati della scheda.

  6. Facoltativamente,

    • Se attivi la rilevabilità pubblica, concedi a allUsers o allAuthenticatedUsers 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 e allAuthenticatedUsers. Gli scambi pubblici non possono avere schede private, mentre gli scambi privati possono avere schede pubbliche.

  7. Per visualizzare l'anteprima delle modifiche, fai clic su Anteprima.

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

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio di dati che contiene la scheda.

  3. Fai clic sulla scheda da eliminare.

  4. Fai clic su Elimina.

  5. Nella finestra di dialogo Vuoi eliminare la scheda?, conferma l'eliminazione digitando delete.

  6. 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.

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:

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