Premiers pas

Utilisez l'API REST de Google Ad Manager pour lire vos données Ad Manager et générer des rapports.

Pour vous aider à démarrer, nous vous proposons une bibliothèque cliente pour Java langues disponibles prochainement. Pour envoyer votre première requête API, suivez les étapes ci-dessous.

Accéder à un réseau Ad Manager

Si vous n'en avez pas encore, vous inscrire à un compte Ad Manager ; de service.

Activer l'API Ad Manager

Activez le 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.

Remarque :Si vous disposez déjà d'un compte de service pour l'API SOAP Google Ad Manager, vous pouvez le réutiliser.

Les bibliothèques clientes de l'API REST Ad Manager lisent les identifiants des Identifiants par défaut de l'application. Pour définir ces à l'aide de variables d'environnement gcloud, suivez ces instructions.

Compte de service

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

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

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

Faites votre première demande

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.

Python

from google.ads import admanager

client = admanager.NetworkServiceClient()

request = admanager.GetNetworkRequest(
     name="networks/NETWORK_CODE",
)

response = client.get_network(request=request)

print(response)

Vous trouverez d'autres exemples sur GitHub.

cURL

Remarque :Si vous vous authentifiez avec les identifiants de l'utilisateur final, vous devez également définir l'en-tête HTTP x-goog-user-project. Pour en savoir plus, consultez la section Définir le quota avec une requête REST.

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