Gestire le schede

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

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

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

3. Fai clic su add_box Crea scheda.

4. Nella pagina Crea scheda, in Nome visualizzato, inserisci il nome della scheda.

5. Se stai creando una scheda commerciale, compila il campo Contatto per richiedere l'accesso con un'email o l'URL del modulo di inserimento per consentire agli abbonati di contattarti. In alternativa, crea una scheda integrata con Cloud Marketplace completando questi passaggi per creare una scheda standard, quindi segui le istruzioni per pubblicare la scheda su Cloud Marketplace.

6. (Facoltativo) Inserisci i seguenti dettagli:

   • Contatto principale: inserisci un'email o un URL del contatto principale per la scheda.

   • Categoria: seleziona fino a due categorie che rappresentano al meglio la tua scheda. Gli iscritti possono filtrare le schede in base a queste categorie.

   • Fornitore: espandi la sezione Fornitore e specifica i dettagli nei seguenti campi:

     • Nome del provider: il nome del provider del set di dati.
     • Contatto principale del provider: un'email o un URL del contatto principale del fornitore del set di dati.

     Gli abbonati possono filtrare le schede in base ai fornitori di dati.

   • Editore: espandi la sezione Editore e specifica i dettagli nei seguenti campi:

     • Nome publisher: il nome del publisher che sta creando la scheda.
     • Contatto principale del publisher: un indirizzo email o un URL del contatto principale del publisher del set di dati.

   • Icona: un'icona per la tua scheda. I formati file PNG e JPEG sono supportati. Le icone devono avere una dimensione file inferiore a 512 KiB e dimensioni non superiori a 512 x 512 pixel.

   • Descrizione: una breve descrizione della tua scheda. Gli abbonati possono cercare le schede in base alla descrizione.

7. In Set di dati di origine, seleziona il set di dati da elencare nello scambio di dati. Il set di dati di origine deve trovarsi nella stessa regione del collegamento dati. Non puoi aggiornare questo campo dopo la creazione della scheda.

8. In Esportazione dati, seleziona l'opzione esportazione dati appropriata. Solo gli abbonati con offerte non in versione o con la versione Enterprise Plus possono eseguire query sui dati con limitazioni all'esportazione dei dati.

   • Per applicare limitazioni all'esportazione dei dati al set di dati condiviso, ma non ai risultati delle query del set di dati condiviso, seleziona Disabilita la copia e l'esportazione dei dati condivisi.
   • Per applicare limitazioni all'esportazione dei dati sul set di dati condiviso e sui risultati delle query del set di dati condiviso, seleziona Disattiva la copia e l'esportazione dei risultati delle query, che imposterà automaticamente anche l'opzione Disattiva la copia e l'esportazione dei dati condivisi.
   • Per applicare limitazioni in uscita per la copia e l'esportazione delle API di dati al set di dati condiviso, seleziona Disattiva la copia e l'esportazione delle tabelle tramite API, che imposta automaticamente anche Disattiva la copia e l'esportazione dei dati condivisi.

9. (Facoltativo) Nella sezione Dettagli scheda, fai clic sul pulsante di attivazione/disattivazione Visibilità pubblica per attivare la visibilità pubblica. Devi concedere il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers. Per ulteriori informazioni, consulta Concedere il ruolo per una scheda. Se la piattaforma di scambio pubblicitario è già pubblica, le autorizzazioni per le schede sono già ereditate e non sono necessarie altre azioni.

   Le piattaforme di scambio pubblicitario rilevabili pubblicamente non possono avere schede private a causa dell'eredità delle autorizzazioni, ma le piattaforme di scambio pubblicitario private possono avere schede pubbliche. Affinché le schede pubbliche vengano create, il progetto in cui si trova la scheda di dati deve avere un account di fatturazione e un'organizzazione associati. Se stai creando una scheda commerciale integrata con Cloud Marketplace, ti consigliamo di renderla rilevabile pubblicamente.

10. (Facoltativo) Nella sezione Documentazione > Markdown, puoi inserire informazioni aggiuntive, ad esempio query di esempio che puoi eseguire sul set di dati, link a documentazione pertinente e altre informazioni che possono aiutare gli abbonati a utilizzare il set di dati.

11. Fai clic su Salva.

API

Utilizza il metodo projects.locations.dataExchanges.listings.create.

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 la piattaforma di scambio pubblicitario in cui vuoi creare la scheda.
• LOCATION: la posizione per lo scambio di dati. Per maggiori informazioni sulle località che supportano Analytics Hub, consulta Regioni supportate.
• DATAEXCHANGE_ID: l'ID dello scambio dati.
• LISTING_ID: l'ID scheda.

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.

Per ulteriori informazioni sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Hub di analisi.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio dati contenente la scheda.

3. Fai clic sulla scheda per cui vuoi aggiungere gli abbonati.

4. Fai clic su person Imposta autorizzazioni.

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

6. Nel campo Nuovi principali, aggiungi i seguenti dettagli in base al tipo di scheda:

   • Per una scheda privata, inserisci gli indirizzi email dell'identità a cui vuoi concedere l'accesso.

   • Per una scheda pubblica, aggiungi allAuthenticatedUsers.

   • Per una scheda pubblica rilevabile da tutti, inclusi gli utenti non Google Cloud, aggiungi allUsers.

7. In Seleziona un ruolo, posiziona il cursore 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 di Analytics Hub. Questo ruolo consente agli utenti di visualizzare la scheda e richiedere l'accesso.

   • Per una scheda pubblica privata o non commerciale, seleziona il ruolo Abbonato ad Analytics Hub. Questo ruolo consente agli utenti di abbonarsi alla tua scheda.

   Per ulteriori informazioni, consulta la sezione relativa ai ruoli di visualizzatore e abbonato di Analytics Hub.

8. Fai clic su Salva.

API

1. Leggi il criterio esistente con il metodo getIamPolicy della scheda 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: l'ID del progetto, ad esempio my-project-1.
   • LOCATION: la posizione dello scambio dati che contiene la scheda.
   • DATAEXCHANGE_ID: l'ID dello scambio 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 associati, 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 il metodo projects.locations.dataExchanges.listings.setIamPolicy. Nel corpo della richiesta, fornisci il criterio IAM aggiornato del 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 va a buon fine, il corpo della risposta contiene i dettagli della scheda.

Per ulteriori informazioni sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Hub di analisi.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio dati contenente la scheda per la quale vuoi gestire le iscrizioni.

3. Fai clic sulla scheda per la quale vuoi elencare tutti gli abbonati.

4. Per visualizzare tutti gli iscritti alla tua scheda, fai clic su Gestisci iscrizioni.

   

5. (Facoltativo) Puoi filtrare i risultati in base ai dettagli degli iscritti.

In alternativa, se hai accesso al set di dati condiviso, puoi seguire questi passaggi per elencare gli abbonati:

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 person_add Condivisione, seleziona Gestisci abbonamenti.

SQL

L'esempio seguente utilizza la vista INFORMATION_SCHEMA.SCHEMATA_LINKS per elencare tutti i set di dati collegati a un set di dati condiviso in myproject che si trovano nella 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 metodo 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 a cui vuoi abbonarti.
• LOCATION: la località della scheda a cui vuoi abbonarti.
• DATAEXCHANGE_ID: l'ID dello scambio dati che contiene la scheda a cui vuoi abbonarti.
• LISTING_ID: l'ID della scheda a cui vuoi abbonarti.

Console

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

2. Fai clic sulla scheda Sottoscrizioni.

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

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

5. Fai clic su Rimuovi.

API

Utilizza il metodo projects.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 dell'abbonamento che vuoi rimuovere.
• LOCATION: la posizione dell'abbonamento che vuoi rimuovere.
• SUBSCRIPTION: l'ID dell'abbonamento che vuoi rimuovere.

Console

1. Vai alla pagina Hub di analisi.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio dati contenente la scheda.

3. Fai clic sulla scheda che vuoi aggiornare.

4. Fai clic su mode_edit Modifica scheda.

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

6. Facoltativamente,

   • Se attivi la visibilità pubblica, concedi a allUsers o allAuthenticatedUsers il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer). Per ulteriori informazioni, consulta Concedere il ruolo per una scheda
   • Se disattivi la visibilità pubblica, rimuovi il ruolo Visualizzatore di 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 di campi che vuoi aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole. Nel corpo della richiesta, specifica i valori aggiornati.

Per ulteriori informazioni sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Hub di analisi.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio dati contenente la scheda.

3. Fai clic sulla scheda che vuoi eliminare.

4. Fai clic su delete 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 sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.