Cette page a été traduite par l'API Cloud Translation.

Premiers pas

L'API Campaign Manager 360 permet d'accéder par programmation aux informations de votre compte Campaign Manager 360. Elle permet de gérer et de créer des campagnes et des rapports, comme vous le feriez avec les services Web Campaign Manager 360 et Outil de création de rapports.

Ce guide explique comment commencer à utiliser l'API Campaign Manager 360.

Prérequis

Avant d'utiliser l'API Campaign Manager 360, vous devez effectuer quelques étapes préalables :

Vous devez disposer d'un compte Campaign Manager 360. Pour en savoir plus sur l'inscription, consultez Annonceurs/Agences.
L'accès à l'API doit être activé pour votre compte Campaign Manager 360. La plupart des comptes ont cette fonctionnalité activée par défaut. Si vous n'êtes pas sûr, contactez votre représentant de compte ou l'équipe d'assistance Campaign Manager 360 pour obtenir de l'aide.
Vous devez disposer d'un profil utilisateur ayant accès à ce compte. Demandez à l'administrateur de votre compte Campaign Manager 360 de créer un profil utilisateur associé à ce compte.
Vérifiez les autorisations du profil utilisateur dans l'UI Campaign Manager 360. Elles contrôlent ce à quoi le profil utilisateur peut accéder depuis l'API. Il n'existe pas d'autorisations d'API distinctes.

Créer un projet

Pour commencer à utiliser l'API Campaign Manager 360, vous devez d'abord créer ou sélectionner un projet dans la console Google APIs, puis activer l'API. Ce lien vous guide tout au long du processus et active automatiquement l'API Campaign Manager 360.

Activer l'API pour un projet existant…

Les étapes suivantes s'appliquent aux utilisateurs qui disposent déjà d'un projet et qui préfèrent activer manuellement l'API Campaign Manager 360 pour celui-ci.

Pour activer une API pour votre projet, procédez comme suit :

Dans la console Google APIs, ouvrez la bibliothèque d'API. Si vous y êtes invité, sélectionnez un projet ou créez-en un. La bibliothèque des API répertorie toutes les API disponibles, regroupées par famille de produits et classées en fonction de leur popularité.
Si l'API que vous souhaitez activer n'apparaît pas dans la liste, utilisez la fonctionnalité de recherche pour la trouver.
Sélectionnez l'API que vous souhaitez activer, puis cliquez sur le bouton Activer.
Si vous y êtes invité, activez la facturation.
Si vous y êtes invité, acceptez les conditions d'utilisation de l'API.

Générer des identifiants

Toutes les requêtes que vous envoyez à l'API Campaign Manager 360 doivent être autorisées. Pour obtenir un bref aperçu de l'autorisation, découvrez comment autoriser et identifier votre application auprès de Google.

Les instructions suivantes vous guident dans la création d'un ID client OAuth 2.0 à utiliser avec le flux d'application installée. Pour savoir comment générer des identifiants à utiliser avec le flux de compte de service, consultez le guide Comptes de service.

Suivez la procédure pour configurer un projet dans la console Google APIs.
Ouvrez la page Identifiants dans la console d'API.
Cliquez sur CRÉER DES IDENTIFIANTS > ID client OAuth.
1. Si vous n'avez pas configuré d'écran de consentement OAuth pour ce projet auparavant, vous serez invité à le faire maintenant. Cliquez sur CONFIGURER L'ÉCRAN DE CONSENTEMENT.
2. Sélectionnez le type d'utilisateur, puis cliquez sur CRÉER.
3. Remplissez le formulaire initial. Vous pourrez le modifier plus tard si nécessaire. Lorsque vous avez terminé, cliquez sur Enregistrer.
4. Revenez à Identifiants > CRÉER DES IDENTIFIANTS > ID client OAuth pour continuer.
Sélectionnez Application de bureau comme type d'application, donnez-lui un nom, puis cliquez sur Créer.

Une fois l'opération terminée, un ID client et un code secret OAuth 2.0 s'affichent. Vous pouvez les télécharger au format JSON et les enregistrer pour les utiliser ultérieurement.

Configuration de l'écran de consentement de l'utilisateur...

Lorsque vous utilisez OAuth 2.0 pour l'authentification, vos utilisateurs sont authentifiés après qu'ils ont accepté les conditions qui s'affichent sur l'écran d'autorisation de l'utilisateur.

Pour configurer l'écran de consentement de votre projet, procédez comme suit :

Ouvrez la page Écran de consentement dans la console Google API. Si vous y êtes invité, sélectionnez un projet ou créez-en un.
Remplissez le formulaire, puis cliquez sur Enregistrer.

Installer une bibliothèque cliente

L'API Campaign Manager 360 est basée sur HTTP et JSON. Par conséquent, n'importe quel client HTTP standard peut lui envoyer des requêtes et analyser ses réponses.

Toutefois, les bibliothèques clientes des API Google permettent d'intégrer plus facilement les langages de programmation, d'améliorer la sécurité et d'accepter les requêtes autorisées. Les bibliothèques clientes sont disponibles pour un grand nombre de langages de programmation. Elles vous évitent de devoir configurer les requêtes HTTP et analyser les réponses manuellement.

Pour commencer, sélectionnez le langage de programmation que vous utilisez pour le développement.

C#

Installez la dernière bibliothèque cliente de l'API Campaign Manager 360 pour .NET. Nous vous recommandons d'utiliser NuGet pour gérer votre installation.

Ouvrez la console du gestionnaire de packages NuGet et exécutez la commande suivante :

Install-Package Google.Apis.Dfareporting.v3_4

En savoir plus

Parcourez la documentation de référence.NET pour l'API Campaign Manager 360.
Consultez le guide du développeur de la bibliothèque cliente des API Google pour .NET.

Java

Installez la dernière bibliothèque cliente de l'API Campaign Manager 360 pour Java. Nous vous recommandons d'utiliser Maven pour gérer votre installation.

Ajoutez la dépendance suivante à votre fichier pom.xml :

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v4-rev20250722-2.0.0</version>
  <exclusions>
    <exclusion>
      <groupId>com.google.guava</groupId>
      <artifactId>guava-jdk5</artifactId>
    </exclusion>
  </exclusions>
</dependency>

En savoir plus

Parcourez la documentation de référence JavaDoc pour l'API Campaign Manager 360.
Consultez le guide du développeur de la bibliothèque cliente des API Google pour Java.

PHP

Installez la dernière bibliothèque cliente de l'API Campaign Manager 360 pour PHP. Nous vous recommandons d'utiliser Composer pour gérer votre installation.

Ouvrez un terminal et exécutez la commande suivante :

composer require google/apiclient

Si vous avez déjà installé la bibliothèque et que vous souhaitez simplement la mettre à jour vers la dernière version :

composer update google/apiclient

Selon votre système, vous devrez peut-être ajouter le préfixe sudo à ces commandes.

En savoir plus

Consultez le guide du développeur de la bibliothèque cliente des API Google pour PHP.

Python

Installez la dernière bibliothèque cliente de l'API Campaign Manager 360 pour Python. Nous vous recommandons d'utiliser pip pour gérer votre installation.

Ouvrez un terminal et exécutez la commande suivante :

pip install --upgrade google-api-python-client

Selon votre système, vous devrez peut-être ajouter le préfixe sudo à ces commandes.

En savoir plus

Consultez la documentation de référence PyDoc pour l'API Campaign Manager 360.
Consultez le guide du développeur de la bibliothèque cliente des API Google pour Python (v1/v2).

Ruby

Installez la dernière bibliothèque cliente de l'API Campaign Manager 360 pour Ruby. Nous vous recommandons d'utiliser RubyGems pour gérer votre installation.

Ouvrez un terminal et exécutez la commande suivante :

gem install google-api-client

Si vous avez déjà installé la bibliothèque et que vous souhaitez simplement la mettre à jour vers la dernière version :

gem update -y google-api-client

Selon votre système, vous devrez peut-être ajouter le préfixe sudo à ces commandes.

En savoir plus

Consultez le guide du développeur de la bibliothèque cliente des API Google pour Ruby.

Vous trouverez d'autres langages compatibles sur la page Bibliothèques clientes.

Envoyer une requête

Une fois les identifiants OAuth 2.0 créés et la bibliothèque cliente installée, vous êtes prêt à utiliser l'API Campaign Manager 360. Découvrez comment autoriser et configurer votre client, et comment effectuer votre première requête en suivant le guide de démarrage rapide ci-dessous.

C#

Chargez le fichier de secrets client et générez des identifiants d'autorisation.

La première fois que vous effectuez cette étape, vous êtes invité à accepter une invite d'autorisation dans votre navigateur. Avant d'accepter, assurez-vous d'être connecté à un compte Google ayant accès à Campaign Manager 360. Votre application sera autorisée à accéder aux données au nom du compte actuellement connecté.

// Load client secrets from the specified JSON file.
GoogleClientSecrets clientSecrets;
using(Stream json = new FileStream(pathToJsonFile, FileMode.Open, FileAccess.Read)) {
  clientSecrets = GoogleClientSecrets.Load(json);
}

// Create an asynchronous authorization task.
//
// Note: providing a data store allows auth credentials to be cached, so they survive multiple
// runs of the application. This avoids prompting the user for authorization every time the
// access token expires, by remembering the refresh token. The "user" value is used to
// identify a specific set of credentials within the data store. You may provide different
// values here to persist credentials for multiple users to the same data store.
Task<UserCredential> authorizationTask = GoogleWebAuthorizationBroker.AuthorizeAsync(
    clientSecrets.Secrets,
    OAuthScopes,
    "user",
    CancellationToken.None,
    dataStore);

// Authorize and persist credentials to the data store.
UserCredential credential = authorizationTask.Result;

Créez un client Dfareporting autorisé.

// Create a Dfareporting service object.
//
// Note: application name should be replaced with a value that identifies your application.
service = new DfareportingService(
    new BaseClientService.Initializer {
      HttpClientInitializer = credential,
      ApplicationName = "C# installed app sample"
    }
);

Effectuez une opération.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = service.UserProfiles.List().Execute();

foreach (UserProfile profile in profiles.Items) {
  Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
      profile.ProfileId, profile.UserName);
}

Java

Chargez le fichier de secrets client et générez des identifiants d'autorisation.

// Load the client secrets JSON file.
GoogleClientSecrets clientSecrets =
    GoogleClientSecrets.load(
        jsonFactory, Files.newBufferedReader(Paths.get(pathToClientSecretsFile), UTF_8));

// Set up the authorization code flow.
//
// Note: providing a DataStoreFactory allows auth credentials to be cached, so they survive
// multiple runs of the program. This avoids prompting the user for authorization every time the
// access token expires, by remembering the refresh token.
GoogleAuthorizationCodeFlow flow =
    new GoogleAuthorizationCodeFlow.Builder(
            httpTransport, jsonFactory, clientSecrets, OAUTH_SCOPES)
        .setDataStoreFactory(dataStoreFactory)
        .build();

// Authorize and persist credentials to the data store.
//
// Note: the "user" value below is used to identify a specific set of credentials in the data
// store. You may provide different values here to persist credentials for multiple users to
// the same data store.
Credential credential =
    new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

Créez un client Dfareporting autorisé.

// Create a Dfareporting client instance.
//
// Note: application name below should be replaced with a value that identifies your
// application. Suggested format is "MyCompany-ProductName/Version.MinorVersion".
Dfareporting reporting =
    new Dfareporting.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("dfareporting-java-installed-app-sample")
        .build();

Effectuez une opération.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = reporting.userProfiles().list().execute();
for (int i = 0; i < profiles.getItems().size(); i++) {
  System.out.printf("%d) %s%n", i + 1, profiles.getItems().get(i).getUserName());
}

PHP

Chargez le fichier de secrets client et générez des identifiants d'autorisation.

// Create a Google_Client instance.
//
// Note: application name should be replaced with a value that identifies
// your application. Suggested format is "MyCompany-ProductName".
$client = new Google_Client();
$client->setAccessType('offline');
$client->setApplicationName('PHP installed app sample');
$client->setRedirectUri(self::OAUTH_REDIRECT_URI);
$client->setScopes(self::$OAUTH_SCOPES);

// Load the client secrets file.
$client->setAuthConfig($pathToJsonFile);

// Try to load cached credentials from the token store. Using a token store
// allows auth credentials to be cached, so they survive multiple runs of
// the application. This avoids prompting the user for authorization every
// time the access token expires, by remembering the refresh token.
if (file_exists($tokenStore) && filesize($tokenStore) > 0) {
    $client->setAccessToken(file_get_contents($tokenStore));
} else {
    // If no cached credentials were found, authorize and persist
    // credentials to the token store.
    print 'Open this URL in your browser and authorize the application.';
    printf("\n\n%s\n\n", $client->createAuthUrl());
    print 'Enter the authorization code: ';
    $code = trim(fgets(STDIN));
    $client->authenticate($code);

    file_put_contents($tokenStore, json_encode($client->getAccessToken()));
}

Créez un client Dfareporting autorisé.

// Create a Dfareporting service object.
$service = new Google_Service_Dfareporting($client);

Effectuez une opération.

// Retrieve and print all user profiles for the current authorized user.
$result = $service->userProfiles->listUserProfiles();
foreach ($result['items'] as $userProfile) {
    printf(
        "User profile \"%s\" (ID: %d) found for account %d.\n",
        $userProfile->getUserName(),
        $userProfile->getProfileId(),
        $userProfile->getAccountId()
    );
}

Python

Chargez le fichier de secrets client et générez des identifiants d'autorisation.

# Set up a Flow object to be used if we need to authenticate.
flow = client.flow_from_clientsecrets(
    path_to_client_secrets_file, scope=OAUTH_SCOPES)

# Check whether credentials exist in the credential store. Using a credential
# store allows auth credentials to be cached, so they survive multiple runs
# of the application. This avoids prompting the user for authorization every
# time the access token expires, by remembering the refresh token.
storage = Storage(CREDENTIAL_STORE_FILE)
credentials = storage.get()

# If no credentials were found, go through the authorization process and
# persist credentials to the credential store.
if credentials is None or credentials.invalid:
  credentials = tools.run_flow(flow, storage,
                               tools.argparser.parse_known_args()[0])

# Use the credentials to authorize an httplib2.Http instance.
http = credentials.authorize(httplib2.Http())

Créez un client Dfareporting autorisé.

# Construct a service object via the discovery service.
service = discovery.build('dfareporting', 'v4', http=http)

Effectuez une opération.

# Construct the request.
request = service.userProfiles().list()

# Execute request and print response.
response = request.execute()

for profile in response['items']:
  print('Found user profile with ID %s and user name "%s".' %
        (profile['profileId'], profile['userName']))

Ruby

Chargez le fichier de secrets client et générez des identifiants d'autorisation.

# Load client ID from the specified file.
client_id = Google::Auth::ClientId.from_file(path_to_json_file)

# Set up the user authorizer.
#
# Note: providing a token store allows auth credentials to be cached, so they
# survive multiple runs of the application. This avoids prompting the user for
# authorization every time the access token expires, by remembering the
# refresh token.
authorizer = Google::Auth::UserAuthorizer.new(
  client_id, [API_NAMESPACE::AUTH_DFAREPORTING], token_store
)

# Authorize and persist credentials to the data store.
#
# Note: the 'user' value below is used to identify a specific set of
# credentials in the token store. You may provide different values here to
# persist credentials for multiple users to the same token store.
authorization = authorizer.get_credentials('user')
if authorization.nil?
  puts format(
    "Open this URL in your browser and authorize the application.\n\n%s" \
    "\n\nEnter the authorization code:",
    authorizer.get_authorization_url(base_url: OAUTH_REDIRECT_URI)
  )
  code = STDIN.gets.chomp
  authorization = authorizer.get_and_store_credentials_from_code(
    base_url: OAUTH_REDIRECT_URI, code: code, user_id: 'user'
  )
end

Créez un client Dfareporting autorisé.

# Create a Dfareporting service object.
#
# Note: application name should be replaced with a value that identifies
# your application. Suggested format is "MyCompany-ProductName".
service = API_NAMESPACE::DfareportingService.new
service.authorization = authorization
service.client_options.application_name = 'Ruby installed app sample'
service.client_options.application_version = '1.0.0'

Effectuez une opération.

// Retrieve and print all user profiles for the current authorized user.
UserProfileList profiles = service.UserProfiles.List().Execute();

foreach (UserProfile profile in profiles.Items) {
  Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
      profile.ProfileId, profile.UserName);
}

En savoir plus

Consultez la documentation de référence de l'API pour découvrir tous les services proposés par l'API. Chaque page de détails de méthode comporte un explorateur d'API intégré que vous pouvez utiliser pour effectuer des requêtes de test directement depuis votre navigateur.

Consultez nos autres guides, qui couvrent des sujets avancés et fournissent des exemples de bout en bout pour les tâches courantes.

Lorsque vous serez prêt à écrire du code, n'hésitez pas à explorer notre vaste collection d'exemples de code, qui peuvent être modifiés et étendus pour répondre à vos besoins.

Premiers pas Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Prérequis

Créer un projet

Générer des identifiants

Installer une bibliothèque cliente

C#

En savoir plus

Java

En savoir plus

PHP

En savoir plus

Python

En savoir plus

Ruby

En savoir plus

Envoyer une requête

C#

Java

PHP

Python

Ruby

En savoir plus

Premiers pas