Questions fréquentes

Général

Quelle est la dernière version de l'API ?

La dernière version de l'API abordée dans ce document est v4.

Puis-je récupérer des données sur les performances à l'aide de cette API ?

Non. Utilisez l'API Bid Manager pour créer, récupérer et exécuter des rapports hors connexion Display & Video 360.

Utiliser l'API

Quelle URL dois-je utiliser pour accéder à l'API ?

https://displayvideo.googleapis.com

Quelles méthodes d'authentification sont acceptées ?

OAuth 2.0 est la seule méthode d'authentification acceptée.

Les requêtes envoyées à l'API Display & Video 360 doivent être autorisées pour la portée suivante:

  • https://www.googleapis.com/auth/display-video

Les requêtes adressées au service users doivent également être autorisées pour le champ d'application supplémentaire suivant:

  • https://www.googleapis.com/auth/display-video-user-management

Je veux écrire du code. Où puis-je trouver les bibliothèques clientes ?

Consultez le guide de la bibliothèque cliente.

Que faire si je ne souhaite pas utiliser de bibliothèque cliente ?

Nous vous recommandons d'utiliser l'une de nos bibliothèques clientes, mais vous pouvez également interagir avec l'API Display & Video 360 à l'aide de requêtes HTTP directes.

Certaines méthodes plus complexes, telles que advertisers.assets.upload et media.upload, sont plus difficiles à traduire directement en requêtes HTTP. Consultez des exemples de requêtes HTTP vers ces méthodes à l'aide de cURL dans nos guides sur les campagnes publicitaires et les enchères personnalisées.

De quelles autorisations Display & Video 360 ai-je besoin ?

Pour utiliser l'API Display & Video 360, le compte Google d'authentification doit être un utilisateur Display & Video 360 ayant accès aux partenaires ou annonceurs concernés.

L'utilisateur Display & Video 360 doit disposer de l'un des rôles utilisateur suivants pour les partenaires ou annonceurs concernés afin d'effectuer les actions suivantes:

  • En lecture seule: récupérez les ressources à l'aide d'appels get ou list, à l'exception des ressources user.
  • Standard: permet de récupérer, de créer et de mettre à jour des ressources. Récupérez des ressources user avec des autorisations pour les mêmes partenaires ou annonceurs.
  • Admin: permet de récupérer, de créer et de mettre à jour des ressources. Récupérez, créez et accordez l'accès aux ressources user pour les partenaires ou les annonceurs que vous gérez.

Comment mettre à jour les ressources YouTube et partenaires à l'aide de l'API ?

L'API Display & Video 360 ne permet pas de créer ni de mettre à jour des ressources YouTube et partenaires. Créez ou mettez à jour des ressources YouTube et partenaires de manière groupée en important des fichiers de données structurées (SDF) dans l'interface Display & Video 360. Pour en savoir plus sur l'importation au format SDF, consultez notre page de guide sur les ressources YouTube et partenaires.

Comment cibler des zones géographiques ?

Vous pouvez attribuer un ciblage géographique aux éléments de campagne à l'aide des types de ciblage suivants:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Récupérez les ID des options de ciblage pour les trois premiers types de ciblage à l'aide de targetingTypes.targetingOptions.search. Récupérez et gérez les ressources de liste d'emplacements à l'aide du service advertisers.locationLists.

Vous pouvez également créer un ID d'option de ciblage TARGETING_TYPE_POI pour cibler directement un rayon de proximité autour de coordonnées de latitude/longitude spécifiques.

Je vois que je peux télécharger des fichiers de données structurées (SDF) à l'aide de l'API, mais comment les importer ?

L'API Display & Video 360 n'est pas compatible avec l'importation de fichiers de données structurées. Nous vous recommandons de gérer les ressources à l'aide des méthodes CREATE, PATCH et DELETE fournies par l'API. Si vous souhaitez toujours gérer des ressources à l'aide de fichiers de données structurées, vous pouvez les mettre à jour dans l'interface de Display & Video 360.

Assistance

L'API présente-t-elle des problèmes ou des limites connus ?

Le nombre de requêtes que votre projet peut envoyer par seconde est limité. Vous trouverez plus d'informations dans notre guide des limites d'utilisation.