Níveis de acesso gerenciados pela nuvem

Observação: o Google está aceitando candidatos para este programa. Inscreva-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 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 tokens de desenvolvedor. É possível pular o envio do token de desenvolvedor nas chamadas de API, mas ainda é necessário enviar um token de acesso.

• Manter 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 nessa 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 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ê já precisa ter um token de desenvolvedor aprovado para usar essa opção. É possível encontrar um token de desenvolvedor na Central de API na sua conta de administrador do Google Ads. Faça login, acesse Administrador > Central de API. Na Central de API, acesse 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ê é um cliente do Google Workspace ou do Google Cloud Identity	É provável que você já tenha um recurso da organização. Verifique Check e crie 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 programa piloto e peça ao Google para criar um recurso da organização para você. O Google vai possuir e gerenciar esse recurso da organização sem custo.

• Prepare 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 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. Se não estiverem, migre 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 essa etapa.
  Você não tem uma organização do Google Cloud e não conseguiu criar uma em a etapa anterior	Verifique se você é um usuário administrador na sua 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 aplicação do 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 API da sua conta de administrador da API Google Ads. Faça login e acesse FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API.

Inscrever-se no programa piloto

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

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

1. O Google vai criar um recurso da organização do Cloud de propriedade do Google para você. Todos os administradores da sua conta de administrador da API Google Ads vão receber o papel 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 da 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 o 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 conformidade do Google vai analisar sua inscrição e enviar um e-mail para o endereço de e-mail para contato da API com o status de aprovação e outros detalhes.

Modificar as solicitações de API

É possível modificar seu app para interromper o envio do 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 de 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 seu 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/v24/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 pelo Cloud.

Essa mudança significa que preciso ser um 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 a Central de API 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 da organização assim que for aprovada.

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

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

Vou receber cobranças se participar desse programa piloto?

Em geral, não. A API Google Ads é oferecida sem custo financeiro, e o Google não está fazendo mudanças no modelo de preços da API Google Ads.

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

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

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

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

   Não haverá cobranças ao se inscrever na 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 da organização do Cloud para você:

   Esse é um recurso da organização do Cloud interno gerenciado pelo Google. Portanto, não haverá cobranças.

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

Esse caso de uso não é compatível. Portanto, não é possível participar desse programa 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.

Participei desse programa piloto e tenho um problema ou feedback. Como entro 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.