A biblioteca de cliente Python está hospedada no GitHub, e o pacote está disponível no PyPI.
Requisitos
A biblioteca requer o Python 3.9 ou mais recente.
Pré-requisitos
Antes de continuar com este guia, você vai precisar de um token de desenvolvedor para a API Google Ads e do ID de cliente de 10 dígitos da sua conta do Google Ads.
Compatibilidade de ambiente de execução e dependência
A biblioteca de cliente do Python mantém a compatibilidade com os ambientes de execução do Python na seção Versões compatíveis publicada pela Python Software Foundation, exceto versões com status "recurso" ou "pré-lançamento".
Nosso objetivo é adotar novas versões do ambiente de execução do Python assim que elas forem lançadas e oficialmente compatíveis com a Python Software Foundation.
Os ambientes de execução do Python que atingiram o fim da vida útil (EOL) não são compatíveis após a data de EOL na seção Versões sem suporte de python.org. Não podemos garantir a compatibilidade com runtimes de fim da vida útil, já que podemos lançar uma versão da biblioteca incompatível com eles a qualquer momento após a data de fim da vida útil.
Para dependências (especificamente, qualquer pacote mantido pelo Google que seja listado como obrigatório pela biblioteca de cliente Python), vamos manter a compatibilidade com pacotes mantidos pelo Google e considerados "compatíveis" de acordo com a Política de mudanças incompatíveis de OSS do Google.
Para conferir uma lista completa de ambientes de execução e dependências do Python compatíveis, consulte a página Dependências.
Instalação
Nosso guia de instalação mostra todas as maneiras diferentes de instalar a biblioteca. A maneira mais simples (e recomendada) de instalar a biblioteca no aplicativo é com pip:
$ python -m pip install google-ads
Configuração
Depois de instalar a biblioteca, você precisará configurar uma configuração para ela. Há várias maneiras de configurar a biblioteca, que são descritas no nosso guia de configuração.
Autenticação
Depois de escolher uma abordagem de configuração, você pode definir a configuração de autenticação. Para instruções detalhadas, consulte nosso guia de autenticação da biblioteca de cliente Python e, para mais informações gerais, consulte nossa visão geral do OAuth.
Fazer uma solicitação de API
Depois de configurar a autenticação, você poderá fazer uma solicitação de API. Consulte o exemplo de receber campanhas para uma maneira rápida de testar se a biblioteca está configurada corretamente para fazer solicitações de API.
Para executar a amostra get_campaigns.py, no diretório raiz da biblioteca de cliente googleads-python instalada localmente, execute o seguinte comando:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Outros recursos
Depois de conseguir fazer uma solicitação de API, siga para estes usos da biblioteca de cliente: