L'API Display & Video 360 est l'interface programmatique de la plate-forme Display & Video 360. Vous pouvez utiliser l'API Display & Video 360 pour automatiser des flux de travail Display & Video 360 complexes. Voici quelques exemples de tâches que vous pouvez effectuer avec l'API Display & Video 360:
- Importer et créer des créations
- Gérez les éléments de campagne et leur ciblage.
- Générez et téléchargez des fichiers de données structurées.
Ce guide explique comment faire vos premiers pas avec l'API Display & Video 360.
Prérequis
Avant d'utiliser l'API Display & Video 360, vous devez effectuer les opérations suivantes:
Vous devez disposer d'un compte Google. Vous devez disposer d'un compte Google pour créer un projet dans la console Google APIs. Si vous avez déjà un compte, vous êtes prêt. Vous pouvez également créer un compte Google distinct à des fins de test.
Vous devez disposer d'un accès à Display & Video 360. Vous devez disposer d'un accès au produit Display & Video 360 pour utiliser l'API. Si votre organisation dispose déjà d'un contrat Display & Video 360, assurez-vous qu'un profil utilisateur avec les autorisations appropriées a été créé pour votre ou vos comptes Google. Si ce n'est pas le cas, contactez notre équipe commerciale pour en savoir plus.
Essayez Display & Video 360. Cette documentation de l'API part du principe que vous avez déjà utilisé Display & Video 360 et que vous connaissez les concepts de programmation Web ainsi que les formats de données Web. Si vous n'avez jamais utilisé Display & Video 360, essayez l'UI Web avant de commencer à coder.
Sélectionner un projet
Vous devez créer ou sélectionner un projet dans la console Google APIs, puis activer l'API.
Vous pouvez créer un projet ou utiliser un projet existant.
Créer un projet
Suivez la procédure dans la console Google APIs pour créer un projet et activer automatiquement l'API Display & Video 360.
Utiliser un projet existant
Voici comment activer manuellement l'API Display & Video 360 pour un projet existant.
Pour activer une API pour votre projet, procédez comme suit :
- Dans la console Google APIs, ouvrez la bibliothèque des 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 Display & Video 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 expliquent comment créer 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 API.
Cliquez sur Créer des identifiants > ID client OAuth.
Sélectionnez le type d'application le plus approprié lorsque vous y êtes invité. Les extraits de code Java et Python proposés dans ces guides supposent une application de bureau, tandis que les extraits de code PHP supposent une application Web.
Saisissez les informations supplémentaires requises.
- Si vous créez un ID client pour la première fois, vous pouvez non seulement sélectionner le type d'application, mais aussi configurer votre écran de consentement en cliquant sur le bouton Configurer l'écran de consentement. Vous ne serez plus invité à configurer votre écran de consentement une fois que vous l'aurez fait pour la première fois, bien que ces informations puissent être mises à jour à tout moment.
Cliquez sur Créer.
Une fois l'opération terminée, vous obtiendrez un ID client et un secret client OAuth 2.0, que vous pourrez télécharger au format JSON et enregistrer pour une utilisation ultérieure.
Configurer 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.