A biblioteca de cliente do Python está hospedada no GitHub, e o pacote está disponível em PyPI (links em inglês).
A versão 10.0.0
da biblioteca de cliente introduziu várias mudanças de interface
que documentamos na seção
Biblioteca versão 10.0.0.
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 um ID de cliente. As instruções sobre como recebê-los estão descritas na seção de pré-requisitos. Você vai gerar os outros tokens OAuth2 necessários nas etapas posteriores.
Instalação
Siga as instruções na nossa documentação de instalação para instalar a biblioteca do PyPi e retornar a esta página.
Configuração
Depois de instalar a biblioteca, você precisará definir uma configuração para ela. Há várias maneiras de configurar a biblioteca, que são descritas na documentação de configuração.
Autenticação
Depois de escolher um tipo de configuração, é possível continuar gerando os tokens OAuth2 restantes necessários para fazer solicitações à API. Há vários fluxos OAuth2 compatíveis, documentados na lista abaixo. Para detalhes sobre as diferenças entre os fluxos e ajudar a decidir qual é o melhor para seu aplicativo, consulte nossa documentação do OAuth.
- Fluxo de aplicativos OAuth para computador
- Fluxo de aplicativos da Web OAuth
- Fluxo da conta de serviço do OAuth
Como fazer uma solicitação de API
Depois de incorporar os tokens OAuth2 à configuração, você poderá fazer uma solicitação de API. Consulte o exemplo de get campaigns para ver uma maneira simples de testar se a biblioteca está configurada corretamente para fazer solicitações de API.
Outros recursos
Depois de fazer uma solicitação de API, siga estes usos da biblioteca de cliente:
- Logging
- Máscaras de campo
- Nomes dos recursos
- Getters proto (link em inglês)
- Como definir campos de mensagem vazios