A biblioteca de cliente do Python está hospedada no GitHub, e o pacote está disponível no PyPI.
Requisitos
A biblioteca oferece suporte ao Python 3.9 a 3.14 (>=3.9, <3.15; o suporte ao Python 3.14
foi adicionado na v28.2.0). Como o Python 3.9 e 3.10 emitem um aviso de suspensão de uso
na importação em google-ads v32.0.0 e versões mais recentes, recomendamos usar o Python 3.11 ou
mais recente.
Pré-requisitos
Antes de continuar com este guia, você precisa 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 em a seção Versões com suporte publicada pela Python Software Foundation, exceto para versões com status "recurso" ou "pré-lançamento".
A Equipe de API Google Ads pretende 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) não são compatíveis após a data de EOL na seção Versões sem suporte de python.org. A compatibilidade com ambientes de execução de EOL não pode ser garantida, já que as versões da biblioteca após uma data de EOL podem quebrar a compatibilidade.
Para dependências (especificamente, todos os pacotes mantidos pelo Google que estão listados como necessários pela biblioteca de cliente do Python), a compatibilidade é mantida com pacotes mantidos pelo Google e considerados "compatíveis" de acordo com a Política de alteração interruptiva de OSS do Google.
Para uma lista completa de ambientes de execução e dependências do Python com suporte, consulte a página Dependências.
Instalação
O guia de instalação descreve 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ê precisa configurar. Há várias maneiras de configurar a biblioteca, que são descritas no guia de configuração.
Autenticação
Depois de escolher uma abordagem de configuração, configure a autenticação. Para instruções detalhadas, consulte o guia de autenticação da biblioteca de cliente do Python. Para mais informações gerais de fundo, consulte a 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, primeiro clone o
google-ads-python repositório. Em seguida, no diretório raiz do repositório clonado, execute o seguinte comando:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Outros recursos
Depois de fazer uma solicitação de API, continue com estes usos da biblioteca de cliente: