Questions fréquentes

Questions d'ordre général

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

La dernière version de l'API concernée par ce document est v3.

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 Display & Video 360 hors connexion.

Utiliser l'API

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

https://displayvideo.googleapis.com

Quelles sont les méthodes d'authentification prises en charge ?

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

Les requêtes API Display & Video 360 doivent être autorisées pour le champ d'application suivant:

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

Les requêtes envoyé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 des 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 envoyées à ces méthodes avec cURL dans nos guides sur les créations et les enchères personnalisées.

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

Pour que vous puissiez utiliser l'API Display & Video 360, le compte Google utilisé pour l'authentification doit être un utilisateur Display & Video 360 ayant accès aux partenaires ou annonceurs pertinents.

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

  • Lecture seule: récupérez des ressources à l'aide d'appels get ou list, à l'exclusion des ressources user.
  • Standard: récupère, crée et met à jour des ressources. Récupérez user ressources ayant les autorisations pour les mêmes partenaires ou annonceurs.
  • Administrateur: récupérer, créer et 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 administrez.

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 de Display & Video 360. Pour en savoir plus sur l'importation de fichiers SDF, consultez notre guide sur les ressources YouTube et partenaires.

Comment cibler des zones géographiques ?

Le ciblage géographique peut être attribué à des éléments de campagne utilisant les 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 d'option de ciblage pour les trois premiers types de ciblage à l'aide de targetingTypes.targetingOptions.search. Récupérez et gérez les ressources de la liste d'emplacements à l'aide du service advertisers.locationLists.

En outre, 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 à l'aide de l'API, mais comment puis-je les importer ?

L'API Display & Video 360 ne permet pas d'importer des fichiers SDF. Nous vous recommandons plutôt de gérer les ressources via les méthodes CREATE, PATCH et DELETE fournies par l'API. Si vous souhaitez toujours gérer les ressources à l'aide de fichiers SDF, vous pouvez mettre à jour ces fichiers 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é, comme décrit dans notre guide sur les limites d'utilisation.