Níveis de acesso gerenciados pela nuvem

Observação: o Google está aceitando inscrições para esse programa. Inscreva-se.

Com esse recurso, os níveis de acesso à API podem ser gerenciados por uma organização do Google Cloud, o que oferece os seguintes benefícios:

• Não é mais necessário proteger tokens de desenvolvedor:o acesso à API é gerenciado pela organização do Google Cloud. Assim, não é mais necessário se preocupar em proteger ou vazar tokens de desenvolvedor. Você pode pular o envio do token de desenvolvedor nas chamadas de API, mas ainda precisa enviar um token de acesso.

• Mantenha projetos separados do Console de APIs do Google para diferentes apps:qualquer projeto vinculado à organização do Google Cloud herda o nível de acesso à API da organização. Isso permite criar vários projetos do Console de APIs do Google na organização para fins como gerenciamento granular de projetos, projetos separados para diferentes apps e vários projetos do Console de APIs do Google para os membros da equipe.

• Monitoramento e gerenciamento mais refinados de cotas: é possível monitorar o uso da API de projetos individuais ou limitar o uso da API.

Pré-requisitos

• Um token de desenvolvedor aprovado

  Você já precisa ter um token de desenvolvedor aprovado para usar essa opção. Você pode encontrar um token de desenvolvedor na Central de API da sua conta de administrador do Google Ads. Faça login e acesse Administrador > Central de APIs. Na Central de APIs, navegue até Acesso à API > Token de desenvolvedor.

• Uma organização do Google Cloud

  A API Google Ads associa seu token de desenvolvedor a uma organização do Google Cloud e o usa para determinar seus níveis de acesso à API. Há várias maneiras de criar uma organização do Google Cloud.

  Cenário	Etapas
  Você é cliente do Google Workspace ou do Google Cloud Identity	É provável que você já tenha um recurso da organização. Você pode verificar e criar uma, se necessário.
  Você não usa o Google Workspace ou o Google Cloud Identity	Inscreva-se na edição sem custo financeiro do Google Cloud Identity. Em seguida, crie o recurso da organização.
  Nenhuma das opções anteriores funciona para você	Explique seu cenário ao se inscrever no programa piloto e peça ao Google para criar um recurso de organização para você. O Google vai ser proprietário e gerenciar esse recurso de organização sem custos financeiros.

• Preparar seus projetos do Console de APIs do Google para o programa piloto

  Prepare os projetos do Console de APIs do Google que você usa com a API Google Ads para o programa piloto da seguinte forma:

  Cenário	Etapas
  Você já tem uma organização do Google Cloud ou criou uma na etapa anterior.	Verifique se todos os projetos do Console de APIs do Google em que você ativou a API Google Ads estão nessa organização. Caso contrário, migre o projeto para a organização. Se você já é cliente do Google Workspace ou do Google Cloud Identity, é provável que os projetos do console de APIs do Google já estejam na sua organização. Portanto, você pode pular esta etapa.
  Você não tem uma organização do Google Cloud e não conseguiu criar uma na etapa anterior.	Verifique se você é um usuário administrador na conta de administrador da API Google Ads e no projeto do Console de APIs do Google. Você precisa dessa permissão para realizar outras etapas depois que sua inscrição no programa piloto for aprovada.

• Um e-mail de contato da API atualizado

  Verifique se o e-mail de contato da API Google Ads está atualizado. Os detalhes de contato da API estão listados na página da Central de APIs da sua conta de administrador da API Google Ads. Faça login e acesse FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de APIs.

Inscrever-se no programa piloto

Inscreva-se no programa piloto. A equipe de compliance do Google vai analisar sua inscrição e enviar um e-mail para o endereço de contato da API com o status de aprovação e outros detalhes.

Se você pediu para o Google criar uma organização do Google Cloud para você, há algumas etapas adicionais envolvidas:

1. O Google vai criar um recurso de organização do Cloud de propriedade do Google para você. Todos os administradores da sua conta de gerente da API Google Ads vão receber a função roles/resourcemanager.projectCreator na organização recém-criada.

2. O Google vai enviar um e-mail para o endereço de e-mail de contato da API com os detalhes do recurso de organização recém-criado.

3. Faça login na sua conta do Console de APIs do Google e siga as instruções para mover seu projeto do Console de APIs do Google para a nova organização.

4. Responda ao e-mail para informar ao Google que seus projetos foram movidos para a nova organização.

5. A equipe de compliance do Google vai analisar sua inscrição e enviar um e-mail para o endereço de contato da API com o status de aprovação e outros detalhes.

Modificar suas solicitações de API

Você pode modificar o app para parar de enviar o cabeçalho developer-token ao fazer chamadas de API. Esta é uma etapa opcional, mas recomendada. Se você estiver no programa piloto, o servidor da API Google Ads vai ignorar o developer-token se ele for enviado como parte das solicitações da API.

Java

Em breve!

.NET

Baixe e instale a versão 17.1.0 ou mais recente da biblioteca .NET da API Google Ads.

Em seguida, modifique o código da seguinte maneira:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Em breve!

Python

Em breve!

Ruby

Em breve!

Perl

Em breve!

Cliente HTTP (REST)

Omita o cabeçalho developer-token nas suas solicitações HTTP:

curl -i -X POST https://googleads.googleapis.com/v20/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Perguntas frequentes

Confira algumas perguntas frequentes sobre os níveis de acesso gerenciados na nuvem.

Essa mudança significa que preciso ser cliente do Google Workspace ou do Google Cloud para usar a API Google Ads?

Não. Você precisa de uma organização do Google Cloud, que pode ser obtida de várias maneiras. Esse requisito é semelhante à necessidade de um projeto do Console de APIs do Google para usar a API Google Ads hoje.

Preciso mudar meus níveis de acesso à API. Como fazer isso?

Por enquanto, continue usando o Central de APIs para solicitar mudanças nos níveis de acesso à API.

Há algum tempo de inatividade para participar desse programa piloto?

Não. A API Google Ads vai começar a usar automaticamente os níveis de acesso à API no nível da organização assim que for aprovada.

Quanto esforço é necessário para participar desse piloto?

Espere mudanças mínimas no código. A maioria dos desenvolvedores consegue fazer mudanças no app em menos de 30 minutos.

Vou receber uma cobrança se participar desse piloto?

Em geral, não. Você não vai receber cobranças se participar desse piloto. A API Google Ads é oferecida sem custo financeiro, e o Google não está fazendo nenhuma mudança no modelo de preços dela.

Os possíveis cenários para conseguir uma organização do Google Cloud são os seguintes:

1. Você já é cliente do Google Workspace ou do Google Cloud Identity:

   Você vai receber cobranças normalmente pelo uso regular desses produtos. Não há cobranças pela criação de uma organização do Google Cloud para participar do programa piloto.

2. Você criou uma conta da edição sem custo financeiro do Google Cloud Identity:

   Não há cobranças ao se inscrever em uma conta da edição sem custo financeiro do Google Cloud Identity ou ao criar uma organização do Google Cloud para participar desse programa piloto.

3. O Google criou um recurso de organização do Cloud para você:

   Esse é um recurso interno da organização do Cloud gerenciado pelo Google, então você não vai receber cobranças.

Tenho vários tokens de desenvolvedor para ferramentas diferentes. Como esse piloto me afeta?

Esse caso de uso não é compatível, então você não poderá participar do piloto.

Isso afeta alguma autorização de API para as contas que gerencio usando a API Google Ads?

Não, essa mudança não afeta nenhuma autorização de API para as contas do Google Ads que você gerencia usando a API Google Ads.

Eu ativei o piloto e tenho um problema ou feedback. Como posso entrar em contato com o suporte?

Entre em contato com a equipe da API Google Ads usando a página de suporte técnico da API e explique a natureza do problema. Inclua detalhes como o ID da organização e os registros de solicitação e resposta, quando possível.