Níveis de acesso gerenciados na nuvem

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

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

• Não é mais necessário proteger os tokens do desenvolvedor: o acesso à API é gerenciado por meio do organização do Google Cloud para que você não precise mais se preocupar em proteger tokens de desenvolvedor ou vazar. Você pode pular o envio de seu token de desenvolvedor em suas chamadas de API, embora ainda seja preciso enviar um token de acesso.

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

• Monitoramento e gerenciamento de cota doFiner: é possível monitorar a API uso de projetos individuais ou limitar o uso da API.

Pré-requisitos

• Um token de desenvolvedor aprovado

  Para usar essa opção, você já precisa ter um token de desenvolvedor aprovado. Você Encontre um token de desenvolvedor existente na página Central de API do seu conta de administrador do Google Ads. Faça login, em seguida, navegue até FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API.

• Uma organização do Google Cloud

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

  Cenário	Etapas
  Você já é um cliente Workspace ou Google Cloud Cliente do Identity	É provável que você já tenha um recurso da organização. Você pode Cheque 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. Depois criar o recurso Organização.
  Nenhuma das opções anteriores funciona para você	Explique seu cenário ao assinar participar do piloto e solicitar que o Google crie um recurso de organização para você. O Google será proprietário e gerente desse recurso da organização sem carga.

• Prepare 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 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 faz parte dessa organização. Se não estiver, migre dentro da organização. Se você já é cliente do Google Workspace ou Google Cloud Identity, é provável que os projetos do Console de APIs do Google na sua organização. Portanto, pule esta etapa.
  Você não tem uma organização do Google Cloud e não foi possível criar uma em a etapa anterior	Verifique se você é um usuário administrador no seu gerente da API Google Ads e seu projeto do Console de APIs do Google. Você precisa dessa permissão para executar etapas adicionais depois que sua inscriçã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. Seu contato da API Os detalhes estão listados na página "Central de API" da sua conta de administrador da API Google Ads. Faça login e navegue até FERRAMENTAS e CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API.

Inscrever-se no programa piloto

Inscreva-se no programa piloto. A equipe de compliance do Google vai analise sua inscrição e envie um e-mail para seu endereço de e-mail de contato da API com a status de aprovação e detalhes adicionais.

Se você pediu ao Google para criar uma organização do Google Cloud, há 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 administrador da API Google Ads receberão roles/resourcemanager.projectCreator no usuário recém-criado organização.

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

3. Você precisa fazer login na sua conta do Console de APIs do Google e seguir as instruções para mover seu projeto do Console de APIs do Google para para a nova organização.

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

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

Modificar suas solicitações de API

Você pode modificar seu app para parar de enviar o cabeçalho developer-token ao fazer chamadas de API. Esta 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 API Google Ads para .NET biblioteca.

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/v17/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 conseguida em muitos de maneiras. Esse requisito é semelhante a como você precisa 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?

Continue usando a Central de API por enquanto para solicitar alterações na Níveis de acesso à API.

Existe algum tempo de inatividade para participar desse piloto?

Não. A API Google Ads vai começar a usar automaticamente níveis de acesso à API no nível da organização após a aprovação.

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

É possível que haja mudanças mínimas no código. A maioria dos desenvolvedores para concluir as alterações no aplicativo em menos de 30 minutos.

Eu receberei alguma cobrança se eu participar do piloto?

Em geral, não haverá cobrança se você optar por esse piloto. API Google Ads é oferecido sem custos financeiros, e o Google não altera a API do Google Ads modelo de preços.

Os cenários possíveis para ter uma organização do Google Cloud são: da seguinte forma:

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

   Você vai receber cobranças pelo uso regular desses produtos, como de costume. Você não há cobrança pela criação de uma organização do Google Cloud com o propósito de que participaram do piloto.

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

   Não haverá cobrança ao se inscrever no Google Cloud Identity Free Edition ou criar uma organização do Google Cloud com o propósito de que participaram do 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 para que você não será cobrada.

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

Este caso de uso não é compatível, por isso você não poderá participar dele piloto.

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

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

Optei pelo 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 o suporte técnico da API e explique a natureza do problema. Incluir como ID da organização e registros de solicitação e resposta, quando sempre que possível.