A biblioteca de cliente do Python está hospedada no GitHub, e o pacote está disponível no PyPI.
Requisitos
A biblioteca exige 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 dependências e ambiente de execução
A biblioteca de cliente do Python mantém a compatibilidade com os ambientes de execução do Python em a Versões compatíveis seção publicada pela Python Software Foundation, exceto para versões com status de "recurso" ou "pré-lançamento".
Nosso objetivo é adotar novas versões do ambiente de execução do Python assim que 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, na sigla em inglês) não são compatíveis após a data de EOL na seção Versões não compatíveis do python.org. Não podemos garantir a compatibilidade com ambientes de execução de EOL, já que podemos lançar uma versão da biblioteca que seja incompatível com eles a qualquer momento após a data de EOL.
Para dependências (especificamente, todos os pacotes mantidos pelo Google que estão listados como necessários pela biblioteca de cliente do Python), vamos manter a compatibilidade com pacotes que são mantidos pelo Google e considerados "compatíveis" de acordo com a Política de mudanças interruptivas de OSS do Google.
Para 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 seu aplicativo é com pip:
$ python -m pip install google-ads
Configuração
Depois de instalar a biblioteca, você precisará configurar. 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 configurar a autenticação. Para instruções detalhadas, consulte nosso guia de autenticação da biblioteca de cliente do 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 como receber campanhas para uma maneira rápida de testar se a biblioteca está configurada corretamente para fazer solicitações de API.
Para executar o exemplo 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 fazer uma solicitação de API, continue com estes usos da biblioteca de cliente: