Installer et configurer votre client

Nous vous recommandons d'utiliser les bibliothèques clientes des API Google avec l'API Display &Video 360. Grâce à elles, vous n'avez plus besoin d'envoyer manuellement des requêtes HTTP ni d'analyser les réponses. Les bibliothèques clientes permettent d'intégrer plus facilement les langages de programmation, d'améliorer la sécurité et d'accepter les appels nécessitant des autorisations utilisateur.

L'API Display &Video 360 est basée sur HTTP et JSON. Si vous préférez, vous pouvez utiliser n'importe quel client HTTP standard pour envoyer des requêtes et analyser les réponses.

Installer une bibliothèque cliente

Nous proposons des bibliothèques clientes compatibles avec l'API Display &Video 360 dans différents langages de programmation. Pour obtenir la liste complète des bibliothèques clientes, consultez la page Exemples et bibliothèques.

Les guides du développeur de l'API Display &Video 360 fournissent des extraits de code pour les langages suivants :

En plus des extraits de code de nos guides, nous proposons des exemples d'intégration complets dans ces langages. Pour les consulter, accédez à notre dépôt GitHub d'exemples d'API Display & Video 360.

Configurer votre client

Une fois les identifiants OAuth 2.0 et une bibliothèque cliente installée, vous êtes prêt à utiliser l'API Display & Video 360. Voici comment autoriser et configurer votre client :

Java

  1. Importez les bibliothèques nécessaires.

    import static java.nio.charset.StandardCharsets.UTF_8;
import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.util.Utils;
import com.google.api.services.displayvideo.v4.DisplayVideo;
import com.google.api.services.displayvideo.v4.DisplayVideo.Advertisers;
import com.google.api.services.displayvideo.v4.model.Advertiser;
import com.google.api.services.displayvideo.v4.model.ListAdvertisersResponse;
import java.io.Reader;
import java.nio.file.Files;
import java.nio.file.Paths;

  2. Chargez le fichier de clés secrètes du 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 qui a accès à Display & Video 360. Votre application sera autorisée à accéder aux données pour le compte du compte actuellement connecté. Pour en savoir plus, consultez notre guide conceptuel sur les autorisations utilisateur. 

    // Read client secrets file.
GoogleClientSecrets clientSecrets;
try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) {
  clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader);
}

// Generate authorization credentials.
// Set up the authorization code flow.
GoogleAuthorizationCodeFlow flow =
    new GoogleAuthorizationCodeFlow.Builder(
        Utils.getDefaultTransport(),
        Utils.getDefaultJsonFactory(),
        clientSecrets,
        oauth-scopes)
    .build();

Credential credential =
    new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

  3. Créez un client API autorisé.

    // Create authorized API client.
DisplayVideo service =
    new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("displayvideo-java-installed-app-sample")
        .build();

Python

  1. Importez les bibliothèques nécessaires.

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

  2. Chargez le fichier de clés secrètes du 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 qui a accès à Display & Video 360. Votre application sera autorisée à accéder aux données pour le compte du compte actuellement connecté. Pour en savoir plus, consultez notre guide conceptuel sur les autorisations utilisateur. 

    # Set up a flow object to create the credentials using the
# client secrets file and OAuth scopes.
credentials = InstalledAppFlow.from_client_secrets_file(
    path-to-client-secrets-file, oauth-scopes).run_local_server()

  3. Créez un client API autorisé.

    # Build the discovery document URL.
discovery_url = f'https://displayvideo.googleapis.com/$discovery/rest?version=v4'

# Build the API service.
service = discovery.build(
    'displayvideo',
    'v4',
    discoveryServiceUrl=discovery_url,
    credentials=credentials)

PHP

Cet exemple suppose que vous exécutez PHP avec un serveur Web intégré et que vous avez configuré vos identifiants pour rediriger vers la page Web appropriée. Par exemple, ce code, dans un fichier index.php, peut être exécuté à l'aide de la commande suivante et des identifiants configurés pour rediriger vers http://localhost:8000 après l'authentification :

php -S localhost:8000 -t ./

  1. Téléchargez et installez le client PHP de l'API Google.

    La méthode préférée consiste à utiliser Composer :

    composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0

    Une fois installé, veillez à inclure le chargeur automatique :

    require_once '/path/to/your-project/vendor/autoload.php';

  2. Créez un objet Google_Client.

    $client = new Google_Client();

  3. Configurez le client, redirigez vers l'URL d'authentification si nécessaire et récupérez un jeton d'accès.

    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 qui a accès à Display & Video 360. Votre application sera autorisée à accéder aux données pour le compte du compte actuellement connecté. Pour en savoir plus, consultez notre guide conceptuel sur les autorisations utilisateur. 

    // Set up the client.
$client->setApplicationName('DV360 API PHP Samples');
$client->addScope(oauth-scope);
$client->setAccessType('offline');
$client->setAuthConfigFile(path-to-client-secrets-file);

// If the code is passed, authenticate. If not, redirect to authentication page.
if (isset($_GET['code'])) {
  $client->authenticate($_GET['code']);
} else {
  $authUrl = $client->createAuthUrl();
  header('Location: ' . $authUrl);
}

// Exchange authorization code for an access token.
$accessToken = $client->getAccessToken();
$client->setAccessToken($accessToken);

  4. Créez un client pour le service de l'API Display &Video 360.

    $service = new Google_Service_DisplayVideo($client);
Précédent
Générer des identifiants
Suivant
Envoyer une requête