Gestisci gli abbonamenti

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

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

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

  • Visualizza tutte le iscrizioni alla tua scheda.
  • Revocare 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, vedi Ruoli e autorizzazioni 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 abilitalo.

Abilitare l'API Analytics Hub

gcloud

Esegui il comando gcloud services enabled:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

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

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

Per ulteriori informazioni, consulta i ruoli utente di Analytics Hub.

Flusso di lavoro del sottoscrittore

Gli abbonati possono eseguire le seguenti azioni con le sottoscrizioni.

Iscriviti alle schede

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

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti, segui questi passaggi.

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 le iscrizioni da elencare.

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

Flusso di lavoro del publisher

Gli editori possono eseguire le seguenti azioni con le iscrizioni. Per ulteriori informazioni sulla gestione degli abbonamenti alle schede, consulta la sezione Gestire le schede.

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti, segui questi passaggi.

Console

  1. Nella console Google Cloud, vai alla pagina di 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 visualizzare le sottoscrizioni.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti alle schede all'interno dello scambio di dati.

API

Per elencare gli abbonamenti di schede in un determinato 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 per il quale vuoi elencare le sottoscrizioni da rimuovere.
  • LOCATION: la posizione dello scambio di dati.
  • DATAEXCHANGE_ID: l'ID del Data Exchange per il quale vuoi elencare le sottoscrizioni.

Rimuovere una sottoscrizione

Console

  1. Nella console Google Cloud, vai alla pagina di 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 alla piattaforma di scambio di dati.

  4. Seleziona la casella di controllo accanto alle sottoscrizioni che vuoi rimuovere oppure seleziona tutte le sottoscrizioni.

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

Limitazioni

Gli abbonamenti sono soggetti alle seguenti limitazioni:

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

Passaggi successivi