Como começar

Use a API Google Ad Manager (Beta) para ler seus dados do Ad Manager e gerar relatórios.

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

Acessar uma rede do Ad Manager

Se você ainda não tiver uma, crie uma conta do Ad Manager.

Ativar a API Ad Manager

Ative a API Ad Manager no seu projeto do Console de APIs do Google.

Autenticar

Todas as solicitações de API precisam ser autenticadas usando o OAuth2.

As bibliotecas de cliente da API Ad Manager leem credenciais do Application Default Credentials. É possível definir esses valores usando variáveis de ambiente ou a gcloud.

Conta de serviço

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Credenciais do usuário

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID

Para mais informações sobre como escolher e criar tipos de credenciais, consulte o guia de autenticação.

Configurar a biblioteca de cliente

Java

Para o Maven:

<!-- pom.xml -->
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>ad-manager</artifactId>
   <version>0.1.0</version>
</dependency>

Para o Gradle:

implementation 'com.google.api-ads:ad-manager:0.1.0'

Python

Instale a biblioteca de cliente do PyPi.

pip install google-ads-admanager

.NET

Instale a biblioteca de cliente no NuGet.

Na CLI do .NET:

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

Como referência de pacote:

<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

PHP

Instale a biblioteca de cliente no Composer.

composer require googleads/ad-manager

Ruby

Instale a biblioteca de cliente em RubyGems.

Gemfile:

gem 'google-ads-ad_manager', '~> 0.2.0'

Instalar:

gem install google-ads-ad_manager

Node.js

Instale a biblioteca de cliente do npm.

Na linha de comando:

npm install @google-ads/admanager

Como referência de pacote:

// package.json
"dependencies": {
  "@google-ads/admanager": "^0.1.0"
}

Faça sua primeira solicitação

Java

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

  public static void main(String[] args) throws Exception {
    syncGetNetwork();
  }

  public static void syncGetNetwork() throws Exception {
    try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
      GetNetworkRequest request =
          GetNetworkRequest.newBuilder()
              .setName(NetworkName.of("NETWORK_CODE").toString())
              .build();
      Network response = networkServiceClient.getNetwork(request);
    }
  }
}

Confira mais exemplos no GitHub. Para mais informações sobre a biblioteca de cliente, consulte o guia do Java.

Python

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="networks/NETWORK_CODE",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)

Confira mais exemplos no GitHub. Para mais informações sobre a biblioteca de cliente, consulte o guia do Python.

.NET

using Google.Ads.AdManager.V1;

public sealed partial class GeneratedNetworkServiceClientSnippets
{
    public void GetNetwork()
    {
        // Create client
        NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
        // Initialize request argument(s)
        string name = "networks/NETWORK_CODE";
        // Make the request
        Network response = networkServiceClient.GetNetwork(name);
    }
}

Confira mais exemplos no GitHub. Para mais informações sobre a biblioteca de cliente, consulte o guia.NET.

PHP

<?php

use Google\Ads\AdManager\V1\Client\NetworkServiceClient;
use Google\Ads\AdManager\V1\GetNetworkRequest; use Google\Ads\AdManager\V1\Network; use Google\ApiCore\ApiException; /** * API to retrieve a Network object. * * @param string $formattedName Resource name of Network. * Format: networks/{network_code} * Please see {@see NetworkServiceClient::networkName()} for help formatting this field. */ function get_network_sample(string $formattedName): void { // Create a client. $networkServiceClient = new NetworkServiceClient(); // Prepare the request message. $request = (new GetNetworkRequest()) ->setName($formattedName); // Call the API and handle any network failures. try { /** @var Network $response */ $response = $networkServiceClient->getNetwork($request); printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); } catch (ApiException $ex) { printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); } } /** * Helper to execute the sample. * */ function callSample(): void { $formattedName = NetworkServiceClient::networkName('NETWORK_CODE'); get_network_sample($formattedName); }

Confira mais exemplos no GitHub.

Ruby

require "google/ads/ad_manager/v1"

def get_network
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Ads::AdManager::V1::NetworkService::Rest::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Ads::AdManager::V1::GetNetworkRequest.new(:name => 'networks/NETWORK_CODE)'

  # Call the get_network method.
  result = client.get_network request

  # The returned object is of type Google::Ads::AdManager::V1::Network.
  p result
end

Confira mais exemplos no GitHub.

Node.js

// Resource name of the Network
const name = 'networks/NETWORK_CODE'

// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;

// Instantiates a client
const admanagerClient = new NetworkServiceClient();

async function callGetNetwork() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await admanagerClient.getNetwork(request);
  console.log(response);
}

callGetNetwork();

Confira mais exemplos no GitHub.

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE