Looking for a REST API? The Ad Manager API (Beta) is now available.

Esta página foi traduzida pela API Cloud Translation.

Começar
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

É possível usar a Google Ad Manager API para criar aplicativos que gerenciam inventário, criar pedidos, gerar relatórios e muito mais.

A API Ad Manager usa SOAP. Para ajudar você a começar, oferecemos ao cliente bibliotecas para Java, .NET, Python, PHP e Ruby.

Para fazer sua primeira solicitação de API, siga estas etapas:

Se você ainda não tiver, inscreva-se para uma conta do Ad Manager padrão. Também é possível criar test network: se você quiser testar a API em uma separado. Não é necessário ter uma conta do Google AdSense para fazer testes propósitos.

Anote o código da rede. Você pode encontrar isso no URL ao fazer login à sua rede. Por exemplo, no URL https://admanager.google.com/1234#home, 1234 é seu código de rede.

Criar credenciais de autenticação

É necessário autenticar todas as solicitações da API Ad Manager usando o OAuth 2.0. Etapas a seguir abordam o caso de uso de acessar seus próprios dados do Ad Manager. Para mais detalhes e outras opções, consulte Autenticação.

Abra o Console de APIs do Google Página de credenciais
No menu do projeto, escolha Criar projeto e insira um nome para o projeto e, opcionalmente, editar o ID do projeto fornecido. Clique em Criar.
Na página "Credenciais", selecione Criar credenciais e escolha Chave da conta de serviço.
Selecione Novo serviço conta e selecione JSON como o tipo de chave.
Clique em Criar para fazer o download de um arquivo que contém uma chave privada.

Configurar a rede do Ad Manager

Faça login no Google Ads Administrador.
Na barra lateral, clique em Administrador > Configurações globais.
Em Configurações gerais > API. Clique no controle deslizante para colocar em Ativado.
Clique no botão Salvar na parte de baixo da página.

Configurar seu cliente

Faça o download de uma das bibliotecas de cliente do Ad Manager. A oferecem funções de wrapper e recursos que facilitam e agilizam desenvolver aplicativos.

As guias abaixo fornecem guias de início rápido para codificação em cada uma das linguagens há uma biblioteca de cliente.

Java

Este é um exemplo básico que mostra como usar o cliente Java biblioteca. Para informações de uso mais detalhadas, consulte o arquivo README na distribuição da biblioteca de cliente.

Configurar suas credenciais

Execute o seguinte comando em um shell:

curl https://raw.githubusercontent.com/googleads/googleads-java-lib/main/examples/admanager_axis/src/main/resources/ads.properties -o ~/ads.properties

Abra o arquivo ~/ads.properties e preencha os seguintes campos:

[...]
api.admanager.applicationName=INSERT_APPLICATION_NAME_HERE
api.admanager.jsonKeyFilePath=INSERT_PATH_TO_JSON_KEY_FILE_HERE
api.admanager.networkCode=INSERT_NETWORK_CODE_HERE
[...]

Especificar as dependências

Edite o arquivo pom.xml e adicione o seguinte ao arquivo dependencies. Você pode encontrar o número da versão mais recente em GitHub.

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>ads-lib</artifactId>
  <version>RELEASE</version>
</dependency>
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>dfp-axis</artifactId>
  <version>RELEASE</version>
</dependency>

Escreva um código e faça uma solicitação.

import com.google.api.ads.common.lib.auth.OfflineCredentials;
import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
import com.google.api.ads.admanager.axis.factory.AdManagerServices;
import com.google.api.ads.admanager.axis.v202408.Network;
import com.google.api.ads.admanager.axis.v202408.NetworkServiceInterface;
import com.google.api.ads.admanager.lib.client.AdManagerSession;
import com.google.api.client.auth.oauth2.Credential;

public class App {
  public static void main(String[] args) throws Exception {
    Credential oAuth2Credential = new OfflineCredentials.Builder()
        .forApi(Api.AD_MANAGER)
        .fromFile()
        .build()
        .generateCredential();

    // Construct an AdManagerSession.
    AdManagerSession session = new AdManagerSession.Builder()
        .fromFile()
        .withOAuth2Credential(oAuth2Credential)
        .build();

    // Construct a Google Ad Manager service factory, which can only be used once per
    // thread, but should be reused as much as possible.
    AdManagerServices adManagerServices = new AdManagerServices();

    // Retrieve the appropriate service
    NetworkServiceInterface networkService = adManagerServices.get(session,
        NetworkServiceInterface.class);

    // Make a request
    Network network = networkService.getCurrentNetwork();

    System.out.printf("Current network has network code '%s' and display" +
        " name '%s'.%n", network.getNetworkCode(), network.getDisplayName());
  }
}

Ver no GitHub

Python

Este é um exemplo básico que mostra como usar a biblioteca do cliente Python. A biblioteca de cliente Python é compatível com o Python v3.6+. Para usos mais detalhados consulte o arquivo README na distribuição da biblioteca de cliente.

Instale a biblioteca e configure suas credenciais.

Execute os seguintes comandos em um shell:

pip install googleads
curl https://raw.githubusercontent.com/googleads/googleads-python-lib/main/googleads.yaml \
     -o ~/googleads.yaml

Configure seu arquivo ~/googleads.yaml.

Preencha os campos a seguir:

ad_manager:
  application_name: INSERT_APPLICATION_NAME_HERE
  network_code: INSERT_NETWORK_CODE_HERE
  path_to_private_key_file: INSERT_PATH_TO_FILE_HERE

Execute um código e faça uma solicitação.

# Import the library.
from googleads import ad_manager

# Initialize a client object, by default uses the credentials in ~/googleads.yaml.
client = ad_manager.AdManagerClient.LoadFromStorage()

# Initialize a service.
network_service = client.GetService('NetworkService', version='v202408')

# Make a request.
current_network = network_service.getCurrentNetwork()

print("Current network has network code '%s' and display name '%s'." %
        (current_network['networkCode'], current_network['displayName']))

Ver no GitHub

PHP

Este é um exemplo básico que mostra como usar o Biblioteca de cliente PHP.

Instale a biblioteca e configure suas credenciais.
Execute os seguintes comandos em um shell para instalar a biblioteca de cliente e fazer o download do adsapi_php.ini no seu diretório principal:
```
composer require googleads/googleads-php-lib
curl https://raw.githubusercontent.com/googleads/googleads-php-lib/main/examples/AdManager/adsapi_php.ini -o ~/adsapi_php.ini
```

Configure o arquivo ~/adsapi_php.ini.

Preencha os campos a seguir:

[AD_MANAGER]
networkCode = "INSERT_NETWORK_CODE_HERE"
applicationName = "INSERT_APPLICATION_NAME_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/dfp"

Execute um código e faça uma solicitação.

Esse código de exemplo precisa ser executado na linha de comando, e não em um navegador. O arquivo que contém esse código deve residir na raiz do diretório do projeto, em que composer require foi executado.

<?php
require 'vendor/autoload.php';
use Google\AdsApi\AdManager\AdManagerSession;
use Google\AdsApi\AdManager\AdManagerSessionBuilder;
use Google\AdsApi\AdManager\v202408\ApiException;
use Google\AdsApi\AdManager\v202408\ServiceFactory;
use Google\AdsApi\Common\OAuth2TokenBuilder;

// Generate a refreshable OAuth2 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();
// Construct an API session configured from a properties file and the OAuth2
// credentials above.
$session = (new AdManagerSessionBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

// Get a service.
$serviceFactory = new ServiceFactory();
$networkService = $serviceFactory->createNetworkService($session);

// Make a request
$network = $networkService->getCurrentNetwork();
printf(
    "Network with code %d and display name '%s' was found.\n",
    $network->getNetworkCode(),
    $network->getDisplayName()
);

Ver no GitHub

.NET

Este é um exemplo básico que mostra como usar o cliente .NET biblioteca

Criar um novo projeto
Abra o Visual Studio e crie um novo projeto (aplicativo Console).
Adicionar as referências de biblioteca necessárias ao projeto
Adicione uma dependência nuget para Google.Dfp.
Configurar App.config
Copie src\App.config no diretório do projeto e adicione-o ao projeto. Se o aplicativo tem a própria App.config, copie os seguintes nós para a App.config:
- configuration/AdManagerApi
- configuration/configSections/section[name="AdManagerApi"]
- configuration/system.net

Configurar credenciais

Abra App.config e edite as seguintes chaves:

<add key="ApplicationName" value="INSERT_YOUR_APPLICATION_NAME_HERE" />
<add key="NetworkCode" value="INSERT_YOUR_NETWORK_CODE_HERE" />
<add key="OAuth2Mode" value="SERVICE_ACCOUNT" />
<add key="OAuth2SecretsJsonPath" value="INSERT_OAUTH2_SECRETS_JSON_FILE_PATH_HERE" />

Fazer uma chamada para a biblioteca

Você pode chamar a biblioteca conforme mostrado no seguinte snippet de código C#

Ver no GitHub

AdManagerUser user = new AdManagerUser();
      using (InventoryService inventoryService = user.GetService<InventoryService>())
            {
                // Create a statement to select ad units.
                int pageSize = StatementBuilder.SUGGESTED_PAGE_LIMIT;
                StatementBuilder statementBuilder =
                    new StatementBuilder().OrderBy("id ASC").Limit(pageSize);

                // Retrieve a small amount of ad units at a time, paging through until all
                // ad units have been retrieved.
                int totalResultSetSize = 0;
                do
                {
                    AdUnitPage page =
                        inventoryService.getAdUnitsByStatement(statementBuilder.ToStatement());

                    // Print out some information for each ad unit.
                    if (page.results != null)
                    {
                        totalResultSetSize = page.totalResultSetSize;
                        int i = page.startIndex;
                        foreach (AdUnit adUnit in page.results)
                        {
                            Console.WriteLine(
                                "{0}) Ad unit with ID \"{1}\" and name \"{2}\" was found.", i++,
                                adUnit.id, adUnit.name);
                        }
                    }

                    statementBuilder.IncreaseOffsetBy(pageSize);
                } while (statementBuilder.GetOffset() < totalResultSetSize);

                Console.WriteLine("Number of results found: {0}", totalResultSetSize);
            }

Se você não quiser definir suas credenciais em App.config, consulte neste artigo da Wiki para conhecer formas alternativas de usar a classe AdManagerUser. Para informações mais detalhadas sobre o uso da biblioteca de cliente .NET, consulte LEIA-ME Se você deseja desenvolver em .NET sem a biblioteca do cliente, consulte a NoClientLibrary artigo da Wikipédia.

Ruby

Este é um exemplo básico que mostra como usar a biblioteca Ruby biblioteca de cliente. A biblioteca de cliente do Ruby requer o Ruby 2.1 ou posterior.

Instale a gem do Ruby e acesse o arquivo de configuração.
Execute os seguintes comandos em um shell:
```
gem install google-dfp-api
curl https://raw.githubusercontent.com/googleads/google-api-ads-ruby/main/ad_manager_api/ad_manager_api.yml -o ~/ad_manager_api.yml
```
Se você encontrar um erro como "cannot load such file -- mkmf (LoadError)" a qualquer momento durante a instalação das gemas, pode ser necessário instalar bibliotecas de desenvolvimento Ruby adicionais, como ruby-dev, ruby-devel, xcode-select etc. para o seu ambiente específico.
Configurar suas credenciais
Preencha os campos obrigatórios no ~/ad_manager_api.yml . Se você ainda não tiver um arquivo de chave OAuth2, siga as instruções etapas para criar sua conta do OAuth2 credenciais.
```
:authentication:
  :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
  :application_name: INSERT_APPLICATION_NAME_HERE
  :network_code: INSERT_NETWORK_CODE_HERE
```

Escreva um código e faça uma solicitação.

# Import the library.
require 'ad_manager_api'

# Initialize an Ad Manager client instance (uses credentials in ~/ad_manager_api.yml by default).
ad_manager = AdManagerApi::Api.new

# Get a service instance.
network_service = ad_manager.service(:NetworkService, :v202408)

# Make a request.
network = network_service.get_current_network()

puts "The current network is %s (%d)." %
        [network[:display_name], network[:network_code]]

Ver no GitHub

Etapas mais detalhadas para começar podem ser encontradas no README distribuído com a biblioteca de cliente Ruby. Além disso, confira nossa documentação biblioteca de exemplo para Ruby.

Próximas etapas

Quando você tiver uma biblioteca de cliente em execução, modifique os exemplos fornecidos para estenda-os de acordo com suas necessidades.

Consulte a documentação de referência para saber mais sobre a API.

Se precisar de ajuda, acesse nossa página de suporte.

Começar Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Acessar uma rede do Ad Manager

Criar credenciais de autenticação

Configurar a rede do Ad Manager

Configurar seu cliente

Java

Python

PHP

.NET

Ruby

Próximas etapas

Começar
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.