Perguntas frequentes

Dúvidas gerais

Inscrição

Sistema de preços e conformidade

Atualização dos Termos e Condições da Google AdWords API

Versões da API

Dúvidas técnicas


Dúvidas gerais

O que é a Google AdWords API?

Com a Google AdWords API, os desenvolvedores podem usar aplicativos que interagem diretamente com o servidor do Google AdWords. Com esses aplicativos, os anunciantes podem gerenciar de maneira mais eficiente grandes contas e campanhas do Google AdWords. Consulte a planilha de tarifas da Google AdWords API para detalhes sobre o sistema de preços da API.

Como faço para usar a Google AdWords API?

Você pode usar a Google AdWords API para empregar ou desenvolver programas que ajudam você ou seus clientes a interagir de forma mais eficiente com as contas relacionadas ao Google AdWords. Estas são algumas possibilidades:

  • Gerar automaticamente palavras-chave, textos do anúncio, URLs e relatórios personalizados
  • Integrar os dados do Google AdWords a outros bancos de dados, como sistemas de inventário
  • Desenvolver ferramentas e aplicativos adicionais para ajudar você a gerenciar melhor as contas do Google AdWords

Tudo o que você precisa para começar a desenvolver programas é um token de desenvolvedor, o qual será enviado após a inscrição. Depois que o token for aprovado, você poderá acessar a API.

Quem deve se inscrever na Google AdWords API?

A Google AdWords API foi criada para desenvolvedores que representam anunciantes grandes e com experiência em tecnologia e também terceiros. Isso inclui SEMs (profissionais de marketing de mecanismos de pesquisa), agências e outros profissionais de marketing on-line que gerenciam várias contas de clientes e/ou grandes campanhas. Como a implementação da Google AdWords API requer conhecimento técnico e habilidades de programação, os anunciantes que contratam desenvolvedores podem alcançar os melhores resultados.

E se eu não tiver uma conta da Minha central de clientes?

Você precisa ter uma conta da Minha central de clientes (MCC) para solicitar o acesso à API. Crie uma caso ainda não tenha. Para mais informações sobre a Minha central de clientes, acesse nossas Perguntas frequentes.

Se você criar uma nova conta da MCC para solicitar o token da API, vincule todas as suas contas existentes ou as contas dos seus clientes à nova MCC. Assim, você garante que sua solicitação seja processada o mais rápido possível. Acesse este link para instruções.

Por que preciso de uma conta da Minha central de clientes para acessar a Google AdWords API?

Os tokens de desenvolvedor são concedidos somente a contas da MCC. Os usuários comuns da Google AdWords API (anunciantes e agências que gerenciam muitas contas) já têm uma conta da MCC.

Há diferença entre gerenciar minha conta do Google AdWords por meio da Google AdWords API e da interface do Google AdWords?

A Google AdWords API oferece a mesma funcionalidade do Google AdWords que está disponível na nossa interface on-line. Todas as alterações feitas por meio da Google AdWords API afetarão sua conta do Google AdWords. No entanto, a Google AdWords API permite que os desenvolvedores e usuários tenham mais flexibilidade para criar aplicativos e ferramentas adicionais com a finalidade de gerenciar suas contas do Google AdWords. Isso depende do software cliente sendo usado e dos programas criados.

As alterações que faço por meio da Google AdWords API são refletidas na minha conta ativa do Google AdWords?

Sim. Todas as alterações que você faz por meio da Google AdWords API afetarão sua conta ativa do Google AdWords. Recomendamos que você teste seus aplicativos nas contas de teste antes de implementá-los na produção.

Que aplicativos posso desenvolver?

Isso depende das suas habilidades de programação e das necessidades de publicidade. Estas são algumas possibilidades:

  • Criar automaticamente anúncios, grupos de anúncios e campanhas
  • Fazer automaticamente o download de relatórios para monitorar o desempenho
  • Integrar os dados do Google AdWords a outros bancos de dados, como sistemas de inventário
  • Desenvolver ferramentas e aplicativos adicionais para ajudar a gerenciar melhor suas contas do Google AdWords

Veja mais casos de uso.

O que é um token de desenvolvedor?

Um token de desenvolvedor é uma combinação exclusiva de letras, números e caracteres que identifica suas atividades na Google AdWords API. Ele é sua chave para acessar o servidor do Google AdWords e as contas dos seus clientes no Google AdWords. Para que possamos identificar sua atividade, você deve incluir o token de desenvolvedor no cabeçalho de todas as suas solicitações de API.

Para se proteger contra fraudes, não compartilhe seu token de desenvolvedor com outras pessoas. Você pode encontrar seu token de desenvolvedor na Central de API do Google AdWords, que é acessada na guia Minha conta da Minha central de clientes.

Como faço para utilizar o token de desenvolvedor?

Você deve incluir seu token de desenvolvedor no cabeçalho de todas as suas solicitações da API para que possamos autenticar e identificar corretamente as atividades da sua conta do Google AdWords. Se você aproveitar uma das suas bibliotecas cliente, não precisará manipular o cabeçalho diretamente.

Preciso contratar alguém para criar um programa para mim. Onde devo procurar?

Comece pesquisando no nosso Fórum do desenvolvedor. Encontre postagens antigas ou poste sua própria solicitação aqui. Você também pode acessar o Webmaster World para conseguir ajuda. Se estiver em dúvida, pesquise "desenvolvedor da Google AdWords API" no Google. Esses desenvolvedores não são funcionários do Google nem mesmo endossados ou aprovados por nós.

Ao procurar um desenvolvedor, é importante que você pesquise e contrate alguém em quem possa confiar. O Google não oficializa parcerias entre você e desenvolvedores. Portanto, sugerimos que use um processo de triagem abrangente e reúna o máximo possível de informações antes de contratar um desenvolvedor.

Como posso usar o logotipo do Google AdWords?

Veja abaixo algumas restrições sobre o uso do logotipo do Google AdWords com seu cliente da API. A permissão para usar o logotipo é concedida de acordo com os Termos da Google AdWords API e está sujeita a estas restrições.

De acordo com os Termos da Google AdWords API, você tem permissão para redimensionar o logotipo para caber no seu aplicativo do cliente da Google AdWords API, desde que você mantenha a proporção dele. Se você usar o logotipo em uma página da Web, precisa haver um espaço mínimo de metade da altura do logotipo entre cada lado do logotipo e outros elementos de imagem ou texto na sua página da Web. Além disso, o logotipo deve aparecer individualmente, de modo que não dê aos usuários a impressão de que o Google aprova quaisquer produtos, serviços ou informações não pertencentes ao Google fornecidos na página da web em questão.

Você não pode (e concorda que não pode) fazer o seguinte:

  • Alterar a proporção ou as cores do logotipo de forma alguma
  • Exibir o logotipo como o elemento de mais destaque na sua página da Web
  • Exibir o logotipo de forma a sugerir uma relação de vínculo ou afiliação com o Google, patrocínio ou endosso do Google. O logotipo não pode ser usado de forma que possa ser interpretado ou que sugira que o conteúdo editorial ou análise de dados tenham sido autorizados ou representem os pontos de vista do Google ou da equipe do Google
  • Exibir o logotipo no seu website de outra forma que não seja autorizada de acordo com as Permissões do Google
  • Exibir o logotipo em qualquer produto, livro ou outro material (que não esteja de acordo com as diretrizes acima)
  • Exibir o logotipo em qualquer website que contenha ou exiba conteúdo adulto, promova jogos de azar, envolva a venda de cigarro ou álcool para pessoas com menos de 21 anos ou que viole as leis aplicáveis ou definidas pelas políticas editoriais do Google
  • Exibir o logotipo de uma forma que o Google, a critério próprio e exclusivo, considere enganosa, difamatória, incorreta, depreciativa, ofensiva, obscena ou questionável
  • Exibir o logotipo em um site que viole alguma lei ou norma
  • Enquadrar ou espelhar qualquer página do Google (incluindo a página que é exibida em resposta a um clique no logotipo do Google ou na caixa de pesquisa Google)
  • Remover, deturpar ou alterar qualquer elemento do logotipo
  • Exibir o logotipo de uma maneira que o faça parecer maior ou ter mais destaque do que seu nome, produto ou nome de serviço, marca registrada ou marca de serviço, logotipo ou o nome da empresa
  • Incluir o logotipo em nomes comerciais ou de empresas, nomes de domínios, nomes de produtos ou serviços, logotipos, documentos comerciais, designs, slogans ou outras marcas registradas
  • Traduzir o logotipo ou localizá-lo para qualquer outro idioma. Todas as versões traduzidas do logotipo precisam ser fornecidas pelo Google
  • Exibir o logotipo como um recurso de design nos seus materiais
  • Imitar o logotipo de algum modo nos seus materiais

Você não pode usar o logotipo de qualquer outra maneira que não esteja especificada nestas diretrizes. O não cumprimento dessas instruções constituirá violação do contrato da Google AdWords API.

Posso me inscrever se eu tiver uma conta do Google AdSense ou outra Conta do Google?

Sim. Os usuários do Google AdSense, do Gmail ou de outro serviço do Google podem inscrever-se para o programa da Google AdWords API. Apenas exigimos que você tenha uma conta atual do Google AdWords. Se desejar se inscrever no Google AdWords, acesse https://adwords.google.com.br.

Eu já tenho uma conta da Minha central de clientes. O que acontecerá com ela quando eu me inscrever?

Depois de inscrever-se no programa da Google AdWords API, sua conta da Minha central de clientes será automaticamente atualizada, mantendo-se inalterada. Suas informações pessoais e contas de cliente vinculadas à sua conta não serão afetadas. A única diferença é que você terá uma subguia nova, chamada Central da Google AdWords API, disponível em sua guia Minha conta. Clique nesta subguia para acessar seu token de desenvolvedor e informações de uso da API.

O que é SOAP?

SOAP é o acrônimo de Simple Object Access Protocol (Protocolo de acesso a objetos simples). Ele é usado para troca de informações e RPC (receita por clique), geralmente (mas não necessariamente) via HTTP. Mais informações estão disponíveis nas especificações. A Google AdWords API usa a arquitetura de SOAP.

O que é WSDL (Linguagem de Descrição de Serviços Web)?

WSDL é o acrônimo de Web Service Description Language (Linguagem de descrição de serviços da web). Ela fornece uma descrição formal de um serviço na Web, semelhante ao IDL da CORBA. O arquivo WSDL tem tudo que você precisa para saber como chamar o serviço da Web. Os kits de ferramentas podem gerar um código proxy diretamente de um arquivo WSDL.

O que é a lista de e-mails da Google AdWords API?

A lista de e-mails da Google AdWords API oferece atualizações sobre produtos e anúncios, enviadas diretamente para sua caixa de entrada de e-mail. Nossa lista de e-mails é fornecida pelo Grupos do Google. Sendo assim, você pode se inscrever usando três etapas simples:

  1. Digite seu endereço de e-mail na página inicial da Google AdWords API.
  2. Aguarde chegar um e-mail de confirmação na sua caixa de entrada.
  3. Clique no link de verificação contido no e-mail para ativar sua assinatura da lista de e-mails.

Pronto. Você não precisa clicar nos links "Participe" ou "Inscreva-se" da página de confirmação do Grupos do Google.

Enviaremos e-mails para a lista quando houver comunicados sobre recursos de produtos do seu interesse, mas não enviaremos e-mails não relacionados à API. Seu endereço de e-mail é protegido por nossa política de privacidade.

Encontre instruções sobre como cancelar a inscrição na lista de e-mails da API.

Como desativar a lista de e-mails de comunicados da Google AdWords API?

Você pode sair da lista de e-mails de comunicados da Google AdWords API ao cancelar a inscrição no Grupos do Google. Veja como:

Se você for um usuário registrado dos Grupos de Google (ou acha que é):

  1. Vá até a página de associação da lista de e-mails de comunicados.
  2. Clique no botão "cancelar inscrição" para remover seu endereço de e-mail da lista de comunicados da Google AdWords API.

Se você não for um usuário registrado do Grupos do Google, primeiro faça login no Grupos do Google antes de cancelar a assinatura da lista de e-mails. Para isso:

  1. Inscreva-se para uma conta do Grupos do Google. Use o mesmo endereço de e-mail que você usou para se inscrever na lista de e-mails de comunicados da Google AdWords API.
  2. Vá até a página de associação da lista de e-mails de comunicados.
  3. Clique no botão "cancelar inscrição" para remover seu endereço de e-mail da lista de comunicados da Google AdWords API.

Encontre instruções sobre como se inscrever na lista de e-mails da API.

Quando a API fica inativa para manutenção programada?

No momento, não temos uma programação de manutenção. As interrupções de serviço esperadas serão anunciadas no Fórum de comunicados da Google AdWords API.

Com quem devo entrar em contato para receber ajuda?

Sugerimos que você navegue no site do desenvolvedor da Google AdWords API. Lá, você encontra guias, exemplos de código e documentação de referência úteis. Você também pode participar do nosso Fórum para desenvolvedores e receber ajuda de outros desenvolvedores da Google AdWords API, bem como seguir nossa Página do Google+ para as últimas informações sobre a API.

Voltar ao início


Inscrição

Qual é meu "tipo de empresa"?
Quando você se inscrever para acessar a Google AdWords API, será perguntado seu tipo de empresa. As opções são:
  • Anunciante: você gerencia campanhas do Google AdWords apenas para os websites, produtos ou serviços da sua empresa. Você não gerencia campanhas do Google AdWords para outras empresas.
  • Agência/SEM: você gerencia campanhas do Google AdWords para clientes, e pode oferecer serviços adicionais relacionados a marketing on-line, hospedagem na Web, SEO (otimização de mecanismos de pesquisa) etc.
  • Afiliado: você participa de programas afiliados de outras empresas. Você usa o Google AdWords para ajudar na publicidade on-line dos produtos deles.
  • Desenvolvedor independente do Google AdWords: você pretende usar a Google AdWords API para desenvolver e licenciar software relacionado ao Google AdWords. Você não gerencia campanhas do Google AdWords para clientes.
O que aconteceu com o tipo de empresa "Serviço de integração"?

O tipo de empresa "Serviço de integração" foi combinado com "Agência/SEM". Essa alteração não afetará seu acesso à API de forma alguma.

O que preciso para começar a usar a Google AdWords API após a inscrição?

Tudo que você precisa é de um token de desenvolvedor aprovado. Você pode adquiri-lo depois de se registrar na Google AdWords API.

Após se inscrever, seu token de desenvolvedor será enviado para o endereço de e-mail da sua conta. Assim que for aprovado, o token será ativado e você poderá acessar a API incluindo-a nos cabeçalhos da sua solicitação. Você pode encontrar seu token na Central da Google AdWords API, que pode ser acessada na guia Minha conta da Minha central de clientes.

Leia nossas Perguntas frequentes para saber mais sobre tokens de desenvolvedor.

Como atualizo meu e-mail de contato de desenvolvedor?

Para alterar/atualizar seu e-mail de contato, siga estas instruções:

  1. Faça login na sua conta da MCC do Google AdWords e clique no ícone de roda dentada no canto superior direito.
  2. No menu suspenso, clique em Configurações da conta.
  3. Clique na Central da Google AdWords API na guia de navegação à esquerda.
  4. Na seção que contém os detalhes do desenvolvedor, clique em Editar.
Posso começar a usar a API assim que me inscrever?

Depois de fornecer suas informações de desenvolvedor, será atribuído a você um token de desenvolvedor. No entanto, você precisará aguardar até que o token seja aprovado para acessar a API. A equipe de revisão da Google AdWords API entrará em contato em até uma semana depois da solicitação. Até isso acontecer, você pode se inscrever em uma Conta de teste para começar a desenvolver e testar seu aplicativo.

Quais informações vocês precisam saber sobre meu aplicativo e usuários correspondentes?

Queremos saber o que seu aplicativo fará (por exemplo, relatórios personalizados, gerenciamento de contas, otimização de lances etc.) e quem o usará (por exemplo, seus colegas na empresa, seus clientes, anunciantes ou agências que venderão o aplicativo etc.). Seja bem-detalhista na sua descrição. Quanto mais você falar sobre seu aplicativo e usuários, mais rápido você será aprovado e melhor entenderemos suas necessidades para continuar desenvolvendo as melhores operações, recursos e suporte aos nossos usuários. Não compartilharemos as informações que você fornece com pessoas fora do Google.

Quais são os motivos comuns de um token de desenvolvedor não ser aprovado?

Os Termos e Condições da Google AdWords API incluem diretrizes detalhadas sobre o uso adequado dela. É necessário que você concorde com esses termos durante a etapa de configuração do faturamento. Se você usou ou pretende usar a API de formas que não sejam consistentes com esses termos, seus tokens não serão aprovados. Se você desenvolver uma ferramenta externa que seus clientes acessam, é necessário que a ferramenta implemente nossa funcionalidade mínima obrigatória.

Saiba mais sobre como se inscrever na Google AdWords API.

Voltar ao início


Sistema de preços e conformidade

Por que a Google AdWords API é oferecida gratuitamente?

Cobrávamos uma pequena taxa pelo uso da Google AdWords API para estimular os desenvolvedores a criar aplicativos que interagissem com a plataforma do Google AdWords de uma forma eficiente e responsável. Em 2010, lançamos o programa de sistema de preços preferenciais que oferecia blocos gratuitos da Google AdWords API para agências e desenvolvedores qualificados de ferramentas de Marketing de busca (SEM, na sigla em inglês). Recebemos feedback positivo desse programa, e agora queremos estender o uso gratuito a todos os desenvolvedores para estimular a inovação.

Quais são os diferentes níveis de acesso da Google AdWords API?

Há dois níveis de acesso à Google AdWords API:

  1. Básico
  2. Padrão

Os níveis de acesso se referem a apenas algumas operações diárias. Ainda há limites no nível do token para evitar pressão nos nossos sistemas e garantir bom desempenho para todos os usuários da nossa API. Os usuários ainda precisam estar de acordo com os termos do Google AdWords, termos da Google AdWords API e a funcionalidade mínima obrigatória, quando aplicável. Não haverá cobranças pelo uso da Google AdWords API para acesso básico ou padrão.

Acesso básico: é o nível de acesso padrão para todos os tokens de desenvolvedor aprovados. Com o acesso básico, os desenvolvedores podem executar até 10.000 operações por dia.

Acesso padrão: é o nível de acesso para quem precisa de maior capacidade de uso. O acesso padrão requer que os desenvolvedores forneçam detalhes adicionais e os mantenham atualizados com o Google.

O que são taxas de não conformidade e como elas são determinadas?

Para garantir experiências do usuário e do anunciante ideais, monitoramos o uso da Google AdWords API e a conformidade do aplicativo com os Termos e Condições da Google AdWords API.

Se seu aplicativo não estiver em conformidade, você será informado e terá um período para realizar as correções apropriadas. Ao final desse período de notificação inicial, se as correções não forem realizadas, você receberá uma extensão de até três meses. Durante esse tempo, será cobrada uma taxa mensal de não conformidade (de R$ 10,00 a cada 10.000 operações usadas no mês antes de você ter recebido o aviso de não conformidade). Se a não conformidade persistir, o acesso à API será revogado.

Leia mais sobre como as operações são contabilizadas.

Como exemplo, digamos que você executou um milhão de operações no mês de abril, e descobrimos que seu aplicativo não estava em conformidade com os Termos e Condições da Google AdWords API. Em 1º de maio, você recebe um aviso com prazo de 30 dias para corrigir o aplicativo. Se as alterações necessárias não forem realizadas até 31 de maio, será cobrada uma taxa fixa de não conformidade de R$1.000,00/mês (1.000.000/10.000 x R$ 10,00) por um máximo de três meses (junho, julho e agosto), ou até seu aplicativo atender aos requisitos de conformidade (o que ocorrer primeiro).

Recebemos blocos gratuitos de API por fazer publicidade das nossas próprias empresas. Mesmo assim precisamos solicitar acesso padrão?

Todos os desenvolvedores que requerem mais de 10.000 operações por dia precisam de acesso padrão. A alocação de blocos gratuitos de API com base nos gastos do Google AdWords será descontinuada. Com base no seu histórico com a Google AdWords API e detalhes que compartilhou conosco, você pode ser pré-qualificado para o acesso padrão. No entanto, para garantir que seu acesso à API não seja afetado, incentivamos você a inscrever-se no acesso padrão.

Nossa solicitação de sistema de preços preferenciais e blocos gratuitos de API foi aprovada. Mesmo assim precisamos solicitar acesso padrão?

Talvez sim, talvez não. O programa de sistema de preços preferenciais, que foi oferecido a agências e desenvolvedores de ferramentas de Marketing de Busca, será descontinuado. A partir de 1º de março de 2013, todos os desenvolvedores que requerem mais de 10.000 operações por dia precisarão de acesso padrão. Com base no seu histórico com a Google AdWords API e detalhes que compartilhou conosco, você pode ser pré-qualificado para o acesso padrão. No entanto, para garantir que seu acesso à API não seja afetado, incentivamos você a se inscrever no acesso padrão se não receber nosso contato OU se os detalhes que você forneceu durante a solicitação de sistema de preços preferenciais tiverem sido alterados recentemente.

Podemos continuar a pagar as cobranças atuais da Google AdWords API e não solicitar acesso padrão?

Não. Se você usar ou esperar usar menos de 10.000 operações por dia, você não precisa se inscrever no acesso padrão.

Como são contabilizadas as operações da Google AdWords API?

Em 1º de março de 2013, os blocos de API terão seu uso suspenso e todas as operações serão contabilizadas igualmente. As solicitações de download de relatórios adHoc e quaisquer solicitações de contas de teste não serão contabilizadas nos limites de acesso básico ou usadas para computar cobranças de não conformidade. Em uma tarefa de mutação em massa, cada operação é contabilizada separadamente.

Cada operação da Google AdWords API, como get ou mutate, é contabilizada separadamente. Por exemplo, uma operação get que gera 10 objetos resultantes só será contabilizada uma vez. Para mutações, cada item com mutação será contabilizado como uma operação. A tabela a seguir mostra alguns exemplo de como a nova contabilização funcionará:

Solicitação da API Operações contabilizadas para o limite diário
Operação: get
Contagem: 53 grupos de anúncios
Serviço: AdGroupAdService
1
Operação: mutate (ADICIONAR)
Contagem: 2 grupos de anúncios
Serviço: AdGroupAdService
2
Operação: get
Contagem: 100 ideias de segmentação
Serviço: TargetingIdeaService
1
Operação: POST HTTP
Contagem: 1 relatório
Serviço: download de relatórios AdHoc
0
Operação: mutate (ADICIONAR)
Contagem: 10 campanhas
Serviço: MutateJobService
10
Onde encontro meu uso da API e se devo solicitar acesso padrão?

Os dados Google AdWords API InfoService incluirão apenas dados de uso do histórico, já que o sistema de preços da API foi descontinuado. Sendo assim, você precisará monitorar o uso da API nos registros do seu aplicativo no cliente para determinar se precisa do acesso básico ou padrão.

Quando devo me inscrever para o acesso padrão?

Se você não se inscreveu no acesso padrão antes de 28 de fevereiro de 2013, foi direcionado para o acesso básico. Se você espera que seu uso aumente além desse limite no futuro, inscreva-se no acesso padrão pelo menos três semanas antes, e inclua o máximo possível de detalhes para garantir o rápido processamento da sua solicitação.

Quanto tempo leva para que meu acesso padrão seja aprovado?

Se todos os detalhes que você forneceu no formulário de acesso padrão forem precisos, e quaisquer dúvidas de esclarecimento forem respondidas rapidamente, esperamos concluir a análise em cerca de duas semanas.

Quais são os motivos comuns para a aprovação do acesso padrão atrasar ou não ser concedida?

Alguns dos motivos comuns para o atraso das aprovações são:

  • Detalhes incompletos fornecidos na solicitação de acesso padrão
  • Detalhes de contato imprecisos na conta da MCC associada ao token de desenvolvedor da Google AdWords API
  • Não responder às dúvidas e esclarecimentos de acompanhamento da equipe de suporte da Google AdWords API
  • Uso da API de formas inconsistentes com os Termos e Condições da Google AdWords API
  • A não implementação da funcionalidade mínima obrigatória
  • O uso da Google AdWords API atual é muito baixo e ainda não justifica o acesso padrão

Precisamos solicitar novamente o acesso padrão em algum momento?

Se as informações que você forneceu na solicitação de acesso padrão original tiverem sido alteradas ou se a Equipe de suporte da Google AdWords API solicitar, você deverá atualizar seus detalhes usando o formulário de solicitação de acesso padrão.

Por exemplo, se você for um anunciante de um único website, mas não quiser anunciar em nome de vários clientes, ou se sua ferramenta anteriormente oferecia apenas o recurso de relatórios e agora você deseja implementar a criação e gerenciamento de campanhas, você precisará fornecer os detalhes atualizados por meio do formulário de acesso padrão.

Como o uso da API é gratuito, precisamos fornecer detalhes de faturamento quando solicitamos o token da Google AdWords API?

Não exigimos mais informações de faturamento durante a inscrição. Detalhes como informações de contato ainda são necessários. Não há cobranças para o uso correto da API no acesso básico ou padrão.

Voltar ao início


Atualização dos Termos e Condições da Google AdWords API

O que preciso fazer como atual usuário da Google AdWords API?

Como um usuário da Google AdWords API, aceite os Termos e Condições atualizados para continuar a usar a Google AdWords API.

  • Se você é um terceiro desenvolvendo uma ferramenta de API para um cliente que é dono do software em questão e você não tem autoridade para aceitar em nome dos seus clientes, peça que seus clientes façam login nas contas correspondentes para revisar e aceitar os termos atualizados.
  • Você receberá um e-mail com instruções sobre como revisar e aceitar os novos termos. Se você não aceitar os termos em até 45 dias depois do recebimento deste e-mail, consideraremos que você os aceitou com base no uso continuado do seu token de desenvolvedor.
Onde encontro os novos Termos e Condições e como os aceito?

Além das instruções enviadas por e-mail, você também verá uma barra de alerta em vermelho na parte superior da conta da MCC associada ao token de desenvolvedor da Google AdWords API. Ela contém um link para os novos Termos e Condições. Para aceitar os novos termos, basta seguir as instruções fornecidas.

Você também pode revisar os novos Termos e Condições. Para analisar os Termos e Condições anteriores, veja abaixo.

Os Termos e Condições não aparecem quando faço login na minha conta.

Não se preocupe. Se os novos termos não aparecem quando você faz login na sua conta, significa que não há mais o que se fazer agora. Como atualizamos os novos termos continuamente, seu agendamento pode ter ficado para depois. Também é possível que seus termos já tenham sido aceitos por alguém autorizado a agir em seu nome.

O que mudou?

Os Termos e Condições atualizados foram criados para ser uma maneira mais concisa e melhor organizada de você entender o que precisa fazer como um usuário da Google AdWords API. Como em qualquer documento jurídico, convém consultar um advogado, caso tenha dúvidas legais. Veja a seguir alguns pontos gerais sobre os novos termos:

  • Aceitar os novos termos não muda seus lances, orçamentos ou outras configurações de campanha. Como sempre, você continuará controlando as configurações na guia "Campanha" da sua conta.
  • Você também verá links para uma nova Central de políticas da Google AdWords API, que devem ser seguidas de acordo com os novos termos.
  • Lembre-se de que, se você recusar os novos termos, seu token de desenvolvedor será encerrado.
Você pode consultar nossos Termos e Condições anteriores nos seguintes idiomas:

Versões da API

Como saber o número da versão mais recente?

O número da versão faz parte do URL de acesso da WSDL. Na documentação do Guia do desenvolvedor, o número da versão aparece nas notas de versão e nas páginas de "Referência".

Por quanto tempo as versões mais antigas da WSDL da Google AdWords API estarão disponíveis?

Quando uma versão da WSDL tiver sido substituída por uma versão atualizada, a antiga terá suporte por quatro meses, para que os usuários tenham tempo de migrar para a versão mais recente. Durante esse período, a Google AdWords API continuará a fornecer ao desenvolvedor acesso e suporte a qualquer versão que tiver sido substituída há quatro meses. A documentação da versão pode ser encontrada nas notas de versão e na programação da desativação.

Como faço para acessar versões mais antigas da WSDL?

Contanto que uma versão esteja disponível, o número da versão da WSDL será incluído no URL de acesso da WSDL.

O que acontece quando versões mais recentes eliminam funções ainda em uso em versões mais antigas?

Quando novas versões eliminam ou alteram os recursos existentes em versões anteriores (ainda disponíveis), as notas da versão mostram as alterações, e uma postagem de blog explica as atualizações às versões recém-lançadas. Também fornecemos um guia de migração para ajudar você a fazer upgrade.

Para que os desenvolvedores tenham tempo de migrar para as novas versões, as versões e as documentações antigas continuarão sendo disponibilizadas e atualizadas por quatro meses após o lançamento de uma nova versão.

Voltar ao início


Dúvidas técnicas

Como faço para depurar e diagnosticar mensagens de SOAP no meu aplicativo?

Recomendamos que você use apenas uma das suas bibliotecas cliente para criar o aplicativo, em vez de implementar seu próprio SOAP.

Os IDs retornados por meio da API são exclusivos?

Os IDs das palavras-chave e das peças criativas são exclusivos somente dentro dos grupos de anúncio correspondentes, e os IDs das campanhas e dos grupos de anúncios são globalmente exclusivos. Para mais detalhes, consulte o guia Como trabalhar com objetos.

Quais tecnologias de serviços da Web você usa / suporta?

Usamos SOAP 1.1 e WSDL 1.1. Todas as mensagens são enviadas via SSL (https) para proteger a privacidade dos nossos usuários, e são autenticadas por meio de senhas incorporadas. Atualmente, não usamos nenhuma das especificações WS-* de nível superior.

Nossa meta é alcançar a interoperabilidade com kits de ferramentas SOAP em qualquer ambiente de desenvolvimento de cliente. No momento, oferecemos bibliotecas cliente em Java, PHP, Python, .NET, Perl e Ruby.

O que é uma operação?

Uma operação é definida como uma ação realizada na sua conta do Google AdWords.

Uma única solicitação get é contabilizada como uma operação, independentemente do número de grupos de anúncios (ou outros objetos) que ela afeta. Para mutate, cada operação contida nela é contabilizada uma vez. Similarmente, em uma tarefa de mutação em massa, cada operação é contabilizada separadamente.

Acesse nossa planilha de tarifas da API para mais informações sobre as operações da API.

Quando devo redefinir meu token de desenvolvedor?

Quase nunca. Você só deve redefinir seu token de desenvolvedor nos raros casos em que acha que ele foi roubado ou está comprometido. Trate seu token de desenvolvedor com pelo menos o mesmo nível de segurança que você trata suas informações de login e senha da conta.

O que acontece quando redefino meu token de desenvolvedor?

Ele é excluído e removido do nosso banco de dados. Não é possível atualizar seu token de desenvolvedor depois de redefini-lo. Sendo assim, tenha certeza quando decidir fazê-lo.

Onde posso informar bugs?

Você pode enviar qualquer suspeita de bug por e-mail usando nossa página de suporte. Inclua o máximo possível de informações, incluindo uma captura de tela ou exemplo do bug. Como o suporte é um pouco limitado para a Google AdWords API, use somente esse endereço de e-mail para informar sobre bugs. Você pode enviar comentários gerais de desenvolvedor por meio do nosso Fórum do desenvolvedor.

Voltar ao início

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.