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" />

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);
    }
  }
}
SyncGetNetwork.java

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="name_value",
    )

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

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

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);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

Vous trouverez d'autres exemples sur GitHub. Pour en savoir plus sur les bibliothèques clientes, consultez le guide.NET.

cURL 

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