Gestisci sottoscrizioni

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

  • Iscriviti a una scheda.
  • Elenca le tue iscrizioni attuali in un determinato progetto.
  • Eliminare un abbonamento.

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

  • Visualizza tutte le iscrizioni alla tua scheda.
  • Revoca l'accesso a un abbonamento specifico.

Un abbonamento è una risorsa regionalizzata che risiede nel progetto del sottoscrittore. 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 all'interno del tuo progetto Google Cloud.

Autorizzazioni obbligatorie

Per abilitare 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 Autorizzazioni e ruoli predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub:

Console

Vai all'API Analytics Hub per il tuo progetto Google Cloud e abilitala.

Attivare l'API Analytics Hub

gcloud

Esegui il comando gcloud services allow:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

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

  • Ruolo Proprietario abbonamenti Analytics Hub (roles/analyticshub.subscriptionOwner), che ti consente di gestire gli abbonamenti che crei.

Per saperne di più, consulta Ruoli utente di Analytics Hub.

Flusso di lavoro degli abbonati

Gli abbonati possono eseguire le seguenti azioni con le sottoscrizioni.

Iscriviti alle schede

Per iscriverti alle schede, segui i passaggi descritti in Iscriversi alle schede.

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti:

API

Per visualizzare gli 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 le sottoscrizioni da elencare.

  • LOCATION: la località per la quale vuoi indicare gli abbonamenti esistenti.

Flusso di lavoro del publisher

Gli editori possono eseguire le seguenti azioni con gli abbonamenti. Per scoprire di più 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 di dati in cui vuoi elencare le sottoscrizioni.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutte le sottoscrizioni alle schede all'interno del Data Exchange.

API

Per elencare le sottoscrizioni alle schede in una determinata piattaforma Data Exchange, 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 di Data Exchange di cui vuoi elencare le sottoscrizioni da rimuovere.
  • LOCATION: la località di Data Exchange.
  • DATAEXCHANGE_ID: l'ID di Data Exchange per cui vuoi elencare gli abbonamenti.

Rimuovere una sottoscrizione

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 di dati in cui vuoi creare la scheda.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti allo scambio di dati.

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

  5. Fai clic su Rimuovi abbonamenti.

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 della sottoscrizione che vuoi rimuovere.
  • LOCATION: la località dell'abbonamento.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento che vuoi rimuovere.

Limitazioni

Gli abbonamenti sono soggetti alle seguenti limitazioni:

  • Non viene eseguito il backfill dei set di dati collegati creati prima del 25 luglio 2023. Solo gli abbonamenti creati dopo il 25 luglio 2023 funzionano con i metodi API.

Passaggi successivi