Visão geral

A biblioteca de cliente do Python está hospedada no GitHub, e o pacote está disponível em PyPI.

A versão 10.0.0 da biblioteca de cliente introduziu várias alterações na interface que documentamos na Biblioteca versão 10.0.0 nesta seção.

Requisitos

A biblioteca requer o Python 3.8 ou posterior.

Pré-requisitos

Antes de instalar a biblioteca, você precisará de um token de desenvolvedor e ID do cliente. As instruções sobre como obtê-los estão descritas na pré-requisitos. Você vai gerar os outros tokens OAuth2 necessários nas etapas posteriores.

Instalação

Siga as instruções na nossa instalação para instalar a biblioteca do PyPi e voltar a esta página.

Configuração

Depois de instalar a biblioteca, você precisará definir uma configuração para reimplantá-lo. Há várias maneiras de configurar a biblioteca, que são descritas em configuração.

Autenticação

Depois de escolher um tipo de configuração, é possível continuar gerando a tokens OAuth2 restantes necessários para fazer solicitações à API. Existem várias fluxos OAuth2 compatíveis, que estão documentados na lista abaixo. Para detalhes sobre as diferenças entre os fluxos e ajudam a decidir qual é o melhor para seu app, consulte a documentação do OAuth.

Como fazer uma solicitação de API

Depois de incorporar seus tokens OAuth2 à configuração, você para fazer uma solicitação de API. Consulte a Exemplo de get campaigns para uma maneira simples de testar se a biblioteca está configurada de forma adequada para tornar a API solicitações.

Para executar a amostra get_campaigns.py, no diretório raiz do arquivo instalou a biblioteca de cliente googleads-python, 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, prossiga para estes usos do cliente biblioteca: