Premiers pas

Utilisez l'API Google Ad Manager (bêta) pour lire vos données Ad Manager et générer des rapports.

Pour effectuer votre première requête API, procédez comme suit:

Accéder à un réseau Ad Manager

Si vous n'en possédez pas déjà un, créez un compte Ad Manager.

Activer l'API Ad Manager

Activez l'API Ad Manager dans votre projet de la console Google APIs.

Authentifier

Toutes les requêtes API doivent être authentifiées à l'aide d'OAuth2.

Les bibliothèques clientes de l'API Ad Manager lisent les identifiants à partir des identifiants par défaut de l'application. Vous pouvez les définir à l'aide de variables d'environnement ou de gcloud.

Compte de service

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Identifiants utilisateur

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

Pour en savoir plus sur le choix et la création de types d'identifiants, consultez le guide d'authentification.

Configurer votre bibliothèque cliente

Java

Pour Maven:

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

Pour Gradle:

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

Python

Installez la bibliothèque cliente à partir de PyPi.

pip install google-ads-admanager

.NET

Installez la bibliothèque cliente à partir de NuGet.

Depuis la CLI .NET:

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

En tant que référence de package:

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

PHP

Installez la bibliothèque cliente à partir de Composer.

composer require googleads/ad-manager

Ruby

Installez la bibliothèque cliente à partir de RubyGems.

Gemfile:

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

Installer :

gem install google-ads-ad_manager

Node.js

Installez la bibliothèque cliente à partir de npm.

Depuis la ligne de commande, appelez :

npm install @google-ads/admanager

En tant que référence de package:

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

Envoyer votre première requête

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);
    }
  }
}

Vous trouverez d'autres exemples sur GitHub. Pour en savoir plus sur les bibliothèques clientes, consultez le guide 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)

Vous trouverez d'autres exemples sur GitHub. Pour en savoir plus sur la bibliothèque cliente, consultez le guide 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);
    }
}

Vous trouverez d'autres exemples sur GitHub. Pour en savoir plus sur les bibliothèques clientes, consultez le guide.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); }

Vous trouverez d'autres exemples sur 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

Vous trouverez d'autres exemples sur 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();

Vous trouverez d'autres exemples sur GitHub.

cURL

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