Níveis de acesso gerenciados pela nuvem

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

Esse recurso permite que os níveis de acesso à API sejam gerenciados por uma organização do Google Cloud, oferecendo os seguintes benefícios:

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

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

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

Pré-requisitos

• Um token de desenvolvedor aprovado

  Você precisa ter um token de desenvolvedor aprovado para usar essa opção. Você pode encontrar um token de desenvolvedor na Central de API na sua conta de administrador do Google Ads. Faça login e acesse Administrador > Centro de APIs. No API Center, navegue até Acesso à API > Token do 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 um, 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 piloto e solicitar que o Google crie um recurso de organização para você. O Google será o proprietário e gerenciador desse recurso da organização sem custo financeiro.

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

  Você precisa preparar os projetos do Console de APIs do Google que usa com a API Google Ads para o programa piloto da seguinte maneira:

  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 para a organização. Se você já for cliente do Google Workspace ou do Google Cloud Identity, é provável que os projetos do Google API Console já estejam na sua organização. Portanto, pule 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 sua conta de administrador da API Google Ads e no seu projeto do Console de APIs do Google. Você precisa dessa permissão para realizar outras etapas depois que sua inscrição piloto for aprovada.

• Um e-mail de contato atualizado da API

  Confira se o e-mail de contato da API Google Ads está atualizado. Seus detalhes de contato da API estão listados na página do Centro de APIs da sua conta de administrador da API Google Ads. Faça login e navegue até Ferramentas & Configurações > Configuração > Centro de APIs.

Inscreva-se no programa piloto

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

Se você solicitou que o Google criasse 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 para você. Todos os administradores da sua conta de administrador da API do 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 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 as solicitações de API

É possível modificar o app para que ele pare 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

Faça o download 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 solicitações HTTP:

curl -i -X POST https://googleads.googleapis.com/v18/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

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 muitas maneiras. Esse requisito é semelhante à necessidade de um projeto do Console de APIs do Google para usar a API Google Ads.

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

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

Há algum tempo de inatividade para ativar esse 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?

Mudanças mínimas no código. A maioria dos desenvolvedores precisa concluir as mudanças no app em menos de 30 minutos.

Vou receber cobranças se participar do piloto?

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

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

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

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

2. Você criou uma conta do Google Cloud Identity Free:

   Não haverá cobrança ao se inscrever na conta do Google Cloud Identity edição sem custo financeiro ou ao criar uma organização do Google Cloud para participar deste piloto.

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

   Esse é um recurso interno gerenciado pelo Google para a organização do Cloud. Por isso, 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 tem suporte, então você não poderá participar desse piloto.

Isso afeta a autorização da API para as contas que eu administro usando a API Google Ads?

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

Eu aceitei participar deste 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 sua organização e registros de solicitação e resposta, quando possível.