Resumo da Notícia
Contexto Geral
Apresentação da biblioteca python-amazon-ad-api, um wrapper em Python 3 para a Amazon Advertising API, com instruções de instalação, configuração de credenciais, exemplos de uso, suporte a diferentes marketplaces, tratamento de exceções, opções de depuração e avisos de descontinuação.
Principais Pontos
- Instalação via pip, incluindo a opção de versão específica: pip install python-amazon-ad-api==0.7.3.
- Necessidade de credenciais próprias da Amazon, que podem exigir conta de desenvolvedor e acesso como seller ou vendor, com referência a um checklist de onboarding da Amazon Ads API.
- Uso de credenciais diretamente no cliente como dicionário (refresh_token, client_id, client_secret, profile_id) ou por meio de arquivo credentials.yml para gerenciar múltiplas contas/perfis.
- Seleção de perfis por parâmetro (ex.: account="germany") e exigência de um perfil por marketplace.
- Caminhos de busca do credentials.yml: macOS/Unix em ~/.config/python-ad-api e Windows em %APPDATA%\python-ad-api (com fallback para %HOME%\AppData\Roaming).
- Marketplaces: padrão Europa (EU) cobrindo UK, FR, IT, ES, DE, NL, AE, SE, PL e TR; para América do Norte (NA) ou Extremo Oriente (FE) é necessário definir o marketplace (ex.: NA, US, CA, MX, BR, JP, AU, SG).
- Exemplo de listagem de campanhas de Sponsored Products (CampaignsV3) com filtro de estado “ENABLED”.
- Tratamento de erros com AdvertisingApiException por meio de try/except.
- Opção de depuração com debug=True para exibir logs de cabeçalhos, método, caminho, parâmetros e dados enviados.
- Exemplo de registro de assistente em perfis via Profiles.register_assistant com country_code e alternativa via curl para o endpoint /v2/profiles/register.
- Módulos mencionados: Common Resources, Profiles Manager, Accounts.
- Avisos de descontinuação planejada: nova versão 3 da Portfolios API (1/3/2025) e nova versão 3 da Sponsored Product API (6/30/2023), com indicação de guia de migração.
- Disponibilidade de arquivos para download por plataforma, com filtros por nome, interpretador, ABI e plataforma, e referência a orientações sobre nomes de arquivos wheel.
Informações Essenciais
A python-amazon-ad-api fornece uma interface em Python para a Amazon Advertising API, com instalação via pip, configuração de credenciais por dicionário ou YAML e suporte a múltiplos perfis e marketplaces. O conteúdo inclui exemplos para listar campanhas, registrar assistente e habilitar logs de depuração, além de instruções sobre caminhos do arquivo de credenciais, módulos disponíveis e avisos de descontinuação de APIs com direcionamento a guias de migração.
Fonte: pypi.org