Premiers pas

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

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 paquets 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-rev20220611-1.32.1</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 passer à 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. Il est recommandé 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

• Parcourez 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 (versions 1 et 2).

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 passer à 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.

C#

1. 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é avec 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;

2. 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"
       }
   );

3. 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

1. 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é avec 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 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");

2. 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();

3. 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

1. 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é avec 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é.

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

2. Créez un client Dfareporting autorisé.

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

3. 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

1. 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é avec 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é.

   # 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())

2. Créez un client Dfareporting autorisé.

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

3. 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

1. 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é avec 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 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

2. 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'

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