Neste guia, apresentamos todas as etapas de configuração necessárias para começar a usar a API Cloud Billing Budget.
Antes de começar
Faça o seguinte antes de ler este guia:
Sobre o Console do Google Cloud
O Console do Google Cloud (acesse a documentação, abra o console) é uma IU da Web usada para provisionar, configurar, gerenciar e monitorar sistemas que usam os produtos do Google Cloud. Você usa o Console do Google Cloud para configurar e gerenciar recursos do Google Cloud e do Faturamento do Cloud.
1. Selecionar ou criar um projeto
Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Um projeto organiza todos os seus recursos do Google Cloud. Ele consiste em um conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitoramento, informações de faturamento e controles de autenticação e acesso. Crie um ou vários projetos e use-os para organizar os recursos do Google Cloud em uma hierarquia de recursos. Para mais informações sobre projetos, consulte a documentação do Resource Manager.
Recomendação: configure um único projeto separado do Google Cloud para atender a todas as suas necessidades de administração de faturamento, incluindo a API Cloud Billing Budget. Também é possível usar seu projeto do Google Cloud de administração de faturamento para elementos como acesso à API Cloud Billing Account, dados exportados do Faturamento do Cloud, canais do Pub/Sub para notificações programáticas de orçamento etc.
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
2. Ativar faturamento
Ative o faturamento no projeto que você usa para chamar a API Cloud Billing Budget. Se você seguiu a recomendação na seção do projeto, esse é seu projeto do Google Cloud de administração de faturamento.
Uma Conta de faturamento do Cloud é usada para definir quem paga por um determinado conjunto de recursos do Google Cloud. Os recursos, como APIs ativadas, são organizados em projetos. É possível vincular uma Conta de faturamento do Cloud a um ou mais projetos. O uso do projeto é cobrado na conta de faturamento vinculada. Na maioria dos casos, você configura o faturamento ao criar um projeto. Para mais informações, consulte a documentação de faturamento.
Você configura os orçamentos do Faturamento do Cloud para monitorar uma Conta de faturamento do Cloud. Essa conta que você monitora pode ser a mesma vinculada ao projeto usado para chamar a API Cloud Billing Budget. O uso dessa API é gratuito para clientes do Google Cloud. Se você configurar as notificações programáticas de orçamento, será cobrado conforme os preços padrão do Pub/Sub.
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
3. Ativar a API
Ative a API Cloud Billing Budget no projeto que você usa para chamá-la. Se você seguiu a recomendação na seção do projeto, esse é seu projeto do Google Cloud de administração de faturamento.
Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.
Ative a Cloud Billing Budget API.
4. Configurar a autenticação e a autorização
Se você planeja usar a API Cloud Billing Budget, é necessário configurar a autenticação. Todo aplicativo cliente que usa a API precisa confirmar a identidade ao fazer a autenticação. Para mais detalhes, consulte Autenticar no Cloud Billing.
Faça a autenticação como um principal específico, como uma Conta do Google ou de serviço. Esse principal precisa ter papéis do Identity and Access Management (IAM) que contenham as permissões necessárias para a API Cloud Billing Budget.
Para garantir que o principal tenha as permissões
necessárias para gerenciar orçamentos,
peça ao administrador para conceder ao principal o
papel do IAM de Administrador da conta de faturamento (roles/billing.admin) na conta de faturamento.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Seu administrador também pode conceder ao principal as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.
Para saber como conceder papéis em uma conta de faturamento, consulte Atualizar permissões do Cloud Billing.
5. Instale e inicialize a CLI gcloud
Se você planeja usar a API Cloud Billing Budget, precisa instalar e inicializar a Google Cloud CLI. Ela é um conjunto de ferramentas para gerenciar recursos e aplicativos hospedados no Google Cloud. Isso inclui a gcloud CLI. O link a seguir fornece as instruções:
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
6. Testar o SDK e a autenticação
Se você tiver configurado a autenticação nas etapas anteriores, poderá usar a gcloud CLI para testar o ambiente de autenticação. Execute o seguinte comando para verificar se ocorrem erros e se as credenciais são retornadas:
gcloud auth print-access-token
Esse comando é usado por todas as amostras de REST da linha de comando da API Cloud Billing Budget para autenticar as chamadas de API.
7. Instalar a biblioteca de cliente da API Cloud Billing Budget
Como a API Cloud Billing Budget é criada em HTTP e JSON, qualquer cliente HTTP padrão pode enviar solicitações a ela e analisar as respostas.
Há opções para chamar a API:
Bibliotecas de cliente compatíveis com o Google (recomendado)
As bibliotecas de cliente oferecem melhor integração de linguagens, mais segurança e suporte para realização de chamadas que requerem autorização do usuário. As bibliotecas de cliente compatíveis com o Google estão disponíveis para várias linguagens conhecidas e são a opção recomendada.