Gestisci gli abbonamenti

In qualità di abbonato ad Analytics Hub, puoi eseguire le seguenti attività:

  • Iscriverti a una scheda.
  • Elenca i tuoi abbonamenti attuali in un determinato progetto.
  • Eliminare un abbonamento.

In qualità di publisher di Analytics Hub, puoi eseguire le seguenti attività:

  • Visualizza tutti gli abbonamenti alla tua scheda.
  • Revocare l'accesso a un abbonamento specifico.

Un abbonamento è una risorsa regionalizzata che si trova nel progetto dell'abbonato. Gli abbonamenti memorizzano informazioni pertinenti sull'abbonato e rappresentano il contratto tra editore e abbonato.

Prima di iniziare

Per iniziare a utilizzare Analytics Hub, devi abilitare l'API Analytics Hub nel tuo progetto Google Cloud.

Autorizzazioni obbligatorie

Per attivare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per abilitare l'API Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub, segui questi passaggi:

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

Autorizzazioni obbligatorie

Per gestire gli abbonamenti, devi disporre di uno dei seguenti ruoli di Analytics Hub:

  • Il ruolo Analytics Hub Subscription Owner (roles/analyticshub.subscriptionOwner), che ti consente di gestire le sottoscrizioni che crei.

Per ulteriori informazioni, consulta i ruoli degli utenti di Analytics Hub.

Flusso di lavoro degli abbonati

Gli abbonati possono eseguire le seguenti azioni con gli abbonamenti.

Iscriversi alle schede

Per iscriverti alle schede, segui la procedura descritta in Iscriverti alle schede.

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti:

API

Per visualizzare i tuoi abbonamenti attuali in un determinato progetto, utilizza il metodo projects.locations.subscriptions.list.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto che contiene gli abbonamenti che vuoi elencare.

  • LOCATION: la località per cui vuoi elencare gli abbonamenti esistenti.

Flusso di lavoro del publisher

I publisher possono eseguire le seguenti azioni con gli abbonamenti. Per ulteriori informazioni sulla gestione degli abbonamenti alle schede, consulta Gestire le schede.

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti:

Console

  1. Nella console Google Cloud, 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 dati in cui vuoi elencare le iscrizioni.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutte le iscrizioni alle schede all'interno dello scambio dati.

API

Per elencare le iscrizioni delle schede in un determinato scambio di dati, utilizza il metodo projects.locations.dataExchanges.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto dello scambio dati per cui vuoi elencare gli abbonamenti da rimuovere.
  • LOCATION: la posizione di Data Exchange.
  • DATAEXCHANGE_ID: l'ID dello scambio dati per cui vuoi elencare gli abbonamenti.

Rimuovere un abbonamento

Console

  1. Nella console Google Cloud, 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 dati in cui vuoi creare la scheda.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutte le iscrizioni allo scambio di dati.

  4. Seleziona la casella di controllo accanto agli abbonamenti che vuoi rimuovere o tutti gli abbonamenti.

  5. Fai clic su Rimuovi iscrizioni.

API

Per rimuovere un abbonamento, 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.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento che vuoi rimuovere.

Limitazioni

Gli abbonamenti sono soggetti alle seguenti limitazioni:

  • I set di dati collegati creati prima del 25 luglio 2023 non vengono sottoposti a backfill. Solo gli abbonamenti creati dopo il 25 luglio 2023 funzionano con i metodi dell'API.

Passaggi successivi