AZX Digital
Google Ads API tool
AZX Digital is the internal application that AZX Digital, a performance marketing agency based in Brazil, uses on the official Google Ads API. Its purpose is to produce performance reports, plan keywords and manage campaigns in the client ad accounts we administer, replacing repetitive manual work in the Google Ads user interface. It is used only by our own staff and has no external users. “AZX Digital” is also the application name shown on the Google OAuth consent screen.
English
Summary for the Google Ads API review team
AZX Digital is a performance marketing agency based in Brazil. Our business is managing paid media for our clients as a paid service: we plan, operate and report on their advertising campaigns, and our revenue comes from agency retainers. We manage Google Ads accounts on behalf of our clients in two ways — most client accounts are linked to our manager account (MCC 294-208-1233), and a few are accounts where the client granted us direct user access instead of linking. In both cases access is granted with the client's consent. We also use the same tool for AZX Digital's own campaigns when we advertise our services.
The tool described on this page is an internal integration used exclusively by AZX Digital staff. It is not a public product, it is not sold or licensed, it has no external users, it is not offered to third parties and we do not resell API access. Its purpose is to replace repetitive manual work in the Google Ads user interface with programmatic reporting, keyword planning and campaign operations on the accounts we already administer.
Requested capabilities: Reporting, Keyword Planning Services, Campaign Management and Campaign Creation. Not requested: Account Creation, Account Management, App Conversion Tracking and Remarketing API.
Identification
| Company | AZX Digital — performance marketing agency, Brazil |
|---|---|
| Company website | https://azxdigital.com |
| Application name | AZX Digital (the same name shown on the Google OAuth consent screen) |
| Purpose | Reporting, keyword planning and campaign management on the client Google Ads accounts we administer |
| Google Ads manager account (MCC) | 294-208-1233 |
| Google Cloud project | azx-digital · 389009356121 |
| API technical contact | lucasrafael@azxdigital.com |
| Access level requested | Basic Access |
| Design document | Google Ads API — Tool Design Document (PDF) |
| Privacy Policy | azxdigital.com/privacidade |
| Terms of Service | azxdigital.com/termos |
What the tool does
Performance reporting
Queries campaign, ad group, ad and keyword metrics from the accounts we administer, for optimization and for the reports we deliver to each client.
Campaign management
Creates and maintains campaigns, ads, keywords and budgets, always with human review and confirmation before any change is applied.
Keyword planning
Researches keyword ideas and search volume estimates to plan Search campaigns for our clients.
Google Ads API services used
| GoogleAdsService | GAQL queries for performance reporting on campaigns, ad groups, ads, keywords and search terms of the accounts we administer. Capability: Reporting. |
|---|---|
| KeywordPlanIdeaService · RecommendationService | Keyword ideas and search volume estimates used to plan Search campaigns, plus Google's own optimization recommendations, always reviewed by an operator before being applied or dismissed. Capability: Keyword Planning Services. |
| CampaignService · CampaignBudgetService | Reading and adjusting status and daily budget of the campaigns we operate. Capability: Campaign Management. |
| AdGroupService · AdGroupAdService · AdGroupCriterionService | Creation and maintenance of Search campaigns, responsive search ads and keywords in the accounts we administer. Capability: Campaign Creation. |
Out of scope: account creation and account administration, the App Conversion Tracking and Remarketing API, reselling API access, and serving third parties.
Architecture and data flow
The integration runs locally, on our team's own workstations. There is no public server, no hosted multi-tenant service and no storage of Google Ads data outside the operator's machine. Authentication is OAuth 2.0 using a desktop application client from our own Google Cloud project, with scope restricted to https://www.googleapis.com/auth/adwords; the refresh token is kept in a local file with permission 600 and the login-customer-id header always points to our manager account.
Every write operation requires human review and confirmation before execution, with a mandatory dry run first, campaigns created paused, budget limits configured in the client itself, and a local audit log of each mutation.
Who uses it
Only AZX Digital staff. The tool is not a public product, it is not sold or licensed and it has no external users. It operates on the ad accounts of the clients we administer, with the account owner's consent — either linked to our manager account (MCC 294-208-1233) or through user access the client granted us on their own account — plus AZX Digital's own campaigns when we advertise our services.
How the tool uses Google data
AZX Digital accesses Google Ads data through the official API, under OAuth authorization granted by our own account, with scope restricted to Google Ads. Specifically:
- It reads campaign data and performance metrics from the accounts we administer, used only to operate, optimize and report on that same client's campaigns.
- It creates and edits campaigns in those same accounts, when requested by our team.
- It does not sell, share or transfer that data to third parties; it does not use the data for our own advertising and does not use it to train models.
- Use of information received from Google APIs adheres to the Google API Services User Data Policy, including the Limited Use requirements.
Questions about the tool or about data handling: lucasrafael@azxdigital.com. See also our Privacy Policy and our Terms of Service.
Português
O que é
O AZX Digital é o aplicativo que a equipe da agência AZX Digital usa para gerar relatórios e gerenciar campanhas de anúncios das contas de clientes que administramos, conectando-se à API oficial do Google Ads.
Identificação
| Empresa | AZX Digital — agência de marketing de performance, Brasil |
|---|---|
| Site | https://azxdigital.com |
| Conta administradora Google Ads (MCC) | 294-208-1233 |
| Projeto Google Cloud | azx-digital · 389009356121 |
| Contato técnico da API | lucasrafael@azxdigital.com |
| Nível de acesso solicitado | Basic Access |
| Documento de design | Google Ads API — Tool Design Document |
O que o aplicativo faz
Relatórios de desempenho
Consulta métricas de campanhas, grupos de anúncios, anúncios e palavras-chave das contas administradas, para análise e relatórios aos clientes.
Gestão de campanhas
Cria e mantém campanhas, anúncios, palavras-chave e orçamentos, sempre com revisão e confirmação humana antes de qualquer alteração.
Planejamento de palavras-chave
Pesquisa ideias e volumes de busca para planejar campanhas de pesquisa dos clientes.
Serviços da API do Google Ads utilizados
| GoogleAdsService | Consultas GAQL para relatórios de desempenho de campanhas, grupos de anúncios, anúncios, palavras-chave e termos de busca das contas administradas. Capability: Reporting. |
|---|---|
| KeywordPlanIdeaService · RecommendationService | Ideias de palavras-chave e estimativas de volume de busca para planejar campanhas de pesquisa, e as recomendações de otimização do próprio Google, sempre revisadas por um operador antes de aplicar ou descartar. Capability: Keyword Planning Services. |
| CampaignService · CampaignBudgetService | Leitura e ajuste de status e orçamento diário das campanhas que operamos. Capability: Campaign Management. |
| AdGroupService · AdGroupAdService · AdGroupCriterionService | Criação e manutenção de campanhas de pesquisa, anúncios responsivos e palavras-chave nas contas administradas. Capability: Campaign Creation. |
Fora de escopo: criação e administração de contas, App Conversion Tracking and Remarketing API, revenda de acesso à API e atendimento a terceiros.
Arquitetura e fluxo de dados
A integração roda localmente, nas estações de trabalho da equipe. Não existe servidor público, não existe serviço multi-inquilino hospedado e não há armazenamento de dados do Google Ads fora da máquina do operador. A autenticação é OAuth 2.0 com cliente de aplicativo para computador do nosso próprio projeto no Google Cloud, com escopo restrito a https://www.googleapis.com/auth/adwords; o refresh token fica em arquivo local com permissão 600 e o cabeçalho login-customer-id aponta sempre para o nosso MCC.
Toda alteração de escrita passa por confirmação humana antes de ser executada, com simulação prévia obrigatória e limites de orçamento configurados no próprio cliente.
Quem usa
Somente a equipe da AZX Digital. O aplicativo não é um produto público, não é vendido nem licenciado e não possui usuários externos. Ele opera sobre as contas de anúncios dos clientes que administramos, com o consentimento do titular — seja por vínculo com a nossa conta de administrador (MCC 294-208-1233), seja por acesso de usuário que o cliente nos concedeu na própria conta — além das campanhas da AZX Digital quando anunciamos os nossos serviços.
Como o aplicativo usa dados do Google
O AZX Digital acessa dados do Google Ads por meio da API oficial, mediante autorização OAuth concedida pela nossa própria conta, com escopo restrito ao Google Ads. Especificamente:
- Lê dados de campanhas e métricas de desempenho das contas administradas, usados apenas para operação, otimização e relatórios das campanhas do próprio cliente.
- Cria e edita campanhas nessas mesmas contas, quando solicitado pela nossa equipe.
- Não vende, não compartilha e não transfere esses dados a terceiros; não usa os dados para publicidade própria nem para treinar modelos.
- O uso de informações recebidas das APIs do Google segue a Política de Dados do Usuário dos Serviços de API do Google, incluindo os requisitos de Uso Limitado (Limited Use).