Gerenciar assinaturas

Como assinante do Analytics Hub, é possível realizar as seguintes tarefas:

  • Assinar uma listagem.
  • Listar suas assinaturas atuais em um determinado projeto.
  • Excluir uma assinatura.

Como editor do Analytics Hub, é possível realizar as seguintes tarefas:

  • Conferir todas as assinaturas da sua listagem.
  • Revogar o acesso a uma assinatura específica.

Uma assinatura é um recurso regionalizado que reside no projeto do assinante. As assinaturas armazenam informações relevantes sobre o assinante e representam o contrato entre o editor e o assinante.

Antes de começar

Para começar a usar o Analytics Hub, você precisa ativar a API Analytics Hub no projeto do Google Cloud.

Permissões necessárias

Para ativar a API Analytics Hub, você precisa das seguintes permissões de gerenciamento de identidade e acesso (IAM):

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

O papel predefinido do IAM a seguir inclui as permissões necessárias para ativar a API Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

Para mais informações sobre os papéis do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Ativar a API Analytics Hub

Para ativar a API Analytics Hub, faça o seguinte:

Console

Acesse a API Analytics Hub para seu projeto do Google Cloud e ative-o.

Ativar a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Permissões necessárias

Para gerenciar listagens, você precisa ter um destes papéis do Analytics Hub:

  • Papel de proprietário de assinatura do Analytics Hub (roles/analyticshub.subscriptionOwner), que permite gerenciar as assinaturas criadas por você.

Para mais informações, consulte as funções do usuário do Analytics Hub.

Fluxo de trabalho dos assinantes

Os assinantes podem realizar as ações a seguir com as assinaturas.

Assinar listagens

Para fazer isso, siga as etapas em Assinar listagens.

Listar assinaturas

Para listar todas as assinaturas, siga estas etapas.

API

Para conferir suas assinaturas atuais em um determinado projeto, use o método projects.locations.subscriptions.list.

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

Substitua:

  • PROJECT_ID: o ID do projeto que contém as assinaturas que você quer listar.

  • LOCATION: o local em que você quer listar as assinaturas atuais.

Fluxo de trabalho do editor

Os editores podem realizar as ações a seguir com as assinaturas. Para mais informações sobre como gerenciar assinaturas em listagens, consulte Gerenciar listagens.

Listar assinaturas

Para listar todas as assinaturas, siga estas etapas.

Console

  1. No Console do Google Cloud, acesse a página do Analytics Hub.

    Acessar o Analytics Hub

    Será exibida uma página que lista todas as trocas de dados que é possível acessar.

  2. Clique no nome da troca de dados em que você quer listar as assinaturas.

  3. Clique na guia Assinaturas para conferir todas as assinaturas em listagens na troca de dados.

API

Para listar assinaturas de fichas em uma troca de dados específica, use o método projects.locations.dataExchanges.listSubscriptions.

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

Substitua:

  • PROJECT_ID: o ID do projeto do Data Exchange em que você quer listar as assinaturas que quer remover.
  • LOCATION: o local da troca de dados.
  • DATAEXCHANGE_ID: o ID do Data Exchange em que você quer listar as assinaturas.

Remover uma inscrição

Console

  1. No Console do Google Cloud, acesse a página do Analytics Hub.

    Acessar o Analytics Hub

    Será exibida uma página que lista todas as trocas de dados que é possível acessar.

  2. Clique no nome da troca de dados na qual você quer criar a listagem.

  3. Clique na guia Assinaturas para conferir todas as assinaturas na troca de dados.

  4. Marque a caixa de seleção ao lado das assinaturas que você quer remover ou selecione todas.

  5. Clique em Remover assinaturas.

API

Para remover uma assinatura, use o método projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Substitua:

  • PROJECT_ID: o ID do projeto da assinatura que você quer remover.
  • LOCATION: o local da assinatura.
  • SUBSCRIPTION_ID: o ID da assinatura que você quer remover.

Limitações

As assinaturas estão sujeitas às seguintes limitações:

  • Os conjuntos de dados vinculados criados antes de 25 de julho de 2023 não são preenchidos. Apenas assinaturas criadas após 25 de julho de 2023 vão funcionar com os métodos da API.

A seguir