Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este documento é destinado a desenvolvedores que querem usar a API de gerenciamento do Google AdSense para obter informações sobre sua conta do Google AdSense. Para acompanhar este documento, é necessário ter familiaridade com conceitos de programação e formatos de dados da Web.
Na página Bibliotecas de cliente e amostras, você encontra informações sobre bibliotecas e amostras disponíveis. Clique
na guia do idioma escolhido e siga os links para fazer o download da fonte.
As bibliotecas de cliente cuidam do seguinte para você:
authentication
descoberta de serviços
criar as solicitações para a API
análise de resposta
Leia as instruções para instalar e configurar a biblioteca de cliente escolhida,
normalmente encontrada no arquivo README no diretório raiz do repositório.
Caso a implementação tenha necessidades especiais, como o uso de um idioma sem suporte, faça solicitações diretas à API em vez de usar uma biblioteca de cliente.
Registrar seu aplicativo
Para usar a AdSense Management API, é necessário registrar o aplicativo que você está desenvolvendo criando um projeto e gerando um Client-ID.
Edite os arquivos de configuração do projeto da biblioteca de cliente com as novas credenciais que você acabou de criar. Consulte a documentação da biblioteca de cliente para mais detalhes.
Observação:a Conta do Google usada para registro deve ser sua conta de desenvolvedor, ou seja, a conta que você quer que os usuários do seu aplicativo vejam como o desenvolvedor dele. Essa conta não precisa estar vinculada a um login do Google AdSense, já que os usuários concederão acesso às próprias contas ao usar o aplicativo.
Tutorial de início rápido
Siga as etapas abaixo para fazer as primeiras solicitações. Elas
podem variar um pouco dependendo da biblioteca ou linguagem que você está usando:
Use o exemplo apropriado para recuperar uma lista de clientes de anúncio de uma conta do Google AdSense. Essa solicitação inicia um processo único em que o usuário do Google AdSense autentica e autoriza seu projeto.
Clientes de anúncio representam uma associação entre uma conta do Google AdSense e um produto do Google AdSense, como anúncios de conteúdo ou anúncios de pesquisa.
Uma conta do Google AdSense pode ter um ou vários clientes de anúncio.
Em aplicativos da Web, os usuários serão redirecionados a um site em que poderão optar por conceder acesso. Depois de autorizados, eles serão redirecionados para o URL de retorno de chamada definido no Console de APIs do Google.
Os aplicativos instalados funcionam de forma semelhante. A biblioteca de cliente tentará abrir uma janela do navegador e usar um código de autorização. Para aplicativos Android, Chrome e iOS, esse método é específico da plataforma.
Os relatórios oferecem insights sobre seus ganhos,
bem como o que está afetando esses ganhos. Eles podem ser exibidos em uma conta inteira ou em um subconjunto de blocos de anúncios por meio do uso de canais.
Tente solicitar o mesmo relatório pelo seu aplicativo.
É possível filtrar os relatórios por blocos de anúncios. Busque a lista de blocos de anúncios usando
adunits.list.
É necessário um ID do cliente de anúncios (consiga-o na etapa 1). Depois de escolher um bloco de anúncios, use o ID dele no parâmetro filter para reports.generate:
Blocos de anúncios são marcadores de posição para anúncios configurados pelo usuário que definem algumas propriedades dos anúncios mostrados (como tamanho e formato).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
Filtre por critérios personalizados ou de URL ou misture vários filtros.
Canais são ferramentas que permitem acompanhar o desempenho de um subconjunto de blocos de anúncios. Há dois tipos de canais: de URL e personalizado. O primeiro permite acompanhar o desempenho em uma página ou um domínio específico, enquanto o segundo ajuda a acompanhar o desempenho de grupos de blocos de anúncios específicos selecionados pelo usuário.
Você está pronto para iniciar sua implementação explorando o restante das chamadas e recursos disponíveis na documentação de referência.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eStarts ADH import of a specified BigQuery table containing a quarterly brand lift benchmark report, triggered by the customer.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the year, quarter, and source BigQuery table in the request body.\u003c/p\u003e\n"],["\u003cp\u003eUses POST request to \u003ccode\u003ehttps://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandLiftBenchmark\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns an Operation object upon successful submission.\u003c/p\u003e\n"]]],["To use the AdSense Management API, first, obtain an AdSense account and familiarize yourself with it. Select a client library or make direct API requests. Register your application to get a Client ID, and configure your project with the credentials. Retrieve a list of ad clients, then generate reports using the API explorer or your application. Filter reports by ad units or channels, and explore the API reference documentation to start implementing your code.\n"],null,["# Get Started\n\nThis document is for developers who want to use the AdSense Management API to get\ninformation about their AdSense account. This document assumes that you're\nfamiliar with web programming concepts and web data formats.\n\nBefore you start\n----------------\n\n### Get an AdSense account\n\nSign up or sign in to your [AdSense\naccount](//adsense.google.com/) to get started.\n\n### Get familiar with AdSense\n\nIf you're not familiar with AdSense concepts read the [introductory information on AdSense](//support.google.com/adsense)\nand experiment with the [AdSense UI](//adsense.google.com/)\nbefore starting to code.\n\n### Choose your client library\n\nIn the [Client Libraries and Samples\npage](/adsense/management/libraries), you'll find information on the available libraries and samples. Click\nthe tab for your chosen language and follow the links to download the source.\nThe client libraries handle the following for you:\n\n- authentication\n- discovery of services\n- building the requests to the API\n- response parsing\n\nRead the instructions to install and configure your chosen client library,\ntypically found in the README file in the root directory of the repository.\n\nIf your implementation has special needs, such as using an unsupported\nlanguage, you can [make direct\nrequests](/adsense/management/direct_requests) to the API instead of using a client library.\n\nRegister your application\n-------------------------\n\nTo use the AdSense Management API you must register the application you're developing\nby creating a project and generating a Client ID.\nRegister your app\n\nEdit the configuration files for your client library project with the new\ncredentials you just created. Check the client library documentation for more\ndetails.\n\n**Note:** The Google Account used for registration should be\nyour **developer** account, that is, the account that you want users of your\napplication to see as the developer of the application. **This account does\nnot need to be tied to an AdSense login**, as users will be granting access\nto their own accounts while using the application.\n\nQuick start tutorial\n--------------------\n\nFollow the steps below to make your first requests, note that these steps\nmay vary slightly depending on the library or language you are using:\n\n1. Use the appropriate sample to retrieve a list of ad clients from an AdSense account. This request initiates a one-time process in which the AdSense user authenticates and authorizes your project. **Ad clients** represent an association between an\n AdSense account and an AdSense product, such as Content Ads or Search Ads.\n An AdSense account can have one or multiple ad clients.\n\n 1. For **web applications**, users will be redirected to a site where they can choose to grant access. Once authorized, they will be redirected to the callback URL defined in the Google API Console.\n 2. **Installed applications** work similarly. The client library will try to open a browser window and use an authorization code. For Android, Chrome and iOS applications this method is platform-specific.\n2. Use the [Google APIs explorer for\n `reports.generate`](/adsense/management/reference/rest/v2/accounts.reports/generate) to request the following report:\n - `date_range: YESTERDAY`\n - `dimensions: DATE`\n - `metrics: ESTIMATED_EARNINGS`\n\n **Reports** give you insight into what you're earning,\n as well as what's having an impact on those earnings. They can be run on\n an entire account or on a subset of ad units, through the use of\n channels.\n3. Try to request the same report from your application.\n4. You can filter the reports by ad units. Fetch the list of ad units using [adunits.list](/adsense/management/reference/rest/v2/accounts.adclients.adunits/list). Note that an ad client ID is needed (get it from step 1). After you choose an ad unit, use its ID in the [filter](/adsense/management/reporting/filtering) parameter for `reports.generate`:\n\n **Ad Units** are user-configured placeholders for ads,\n that define some properties for the ads being shown (such as size and\n shape).\n - `date_range: YESTERDAY`\n - `dimensions: DATE`\n - `metrics: ESTIMATED_EARNINGS`\n - `filter: AD_UNIT_ID==ca-pub-123456789:987654321`\n5. Try filtering by custom or URL channels or mixing multiple filters. **Channels** are tools that let you track the\n performance of a subset of your ad units. There are two types of channels:\n URL and custom. The former lets you track performance across a specific\n page or domain, whereas the latter help you track performance on specific\n user-selected groups of ad units.\n\nYou are ready to start your implementation by exploring the rest of the\navailable calls and resources in the [reference\ndocumentation](/adsense/management/reference/rest)."]]
