Questions fréquentes

Général

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

La dernière version de l'API à laquelle ce document fait référence est v1beta2. Il s'agit d'une version bêta privée disponible pour les testeurs de confiance.

Qui peut accéder à l'API ?

L'accès à v1beta2 n'est disponible que pour les projets de la console API Google figurant sur la liste d'autorisation. L'accès à la documentation de l'API est contrôlé par une liste d'autorisation d'utilisateurs distincte.

Comment savoir si mon projet de console figure sur la liste d'autorisation ?

Sélectionnez une clé API dans votre projet en cliquant sur l'élément API_KEY dans l'URL ci-dessous. Si aucune clé API n'existe pour le projet sélectionné, vous serez invité à en créer une. Une fois l'opération terminée, copiez et collez l'URL obtenue dans votre navigateur.

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

Si une description JSON de l'API s'affiche, votre projet figure sur la liste d'autorisation. Si une erreur s'affiche, votre projet ne figure pas sur la liste d'autorisation.

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. Toutes les requêtes doivent être autorisées pour le champ d'application suivant :

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

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

Python

La bibliothèque cliente des API Google pour Python, disponible publiquement, peut être utilisée pour accéder à cette API. Pour installer la bibliothèque et créer un objet de service autorisé, procédez comme suit.

  1. Installez google-api-python-client.

    pip install --upgrade google-api-python-client

  2. Obtenez un objet credentials autorisé. Pour obtenir un exemple, consultez le guide Configurer votre application.

  3. Créez un objet de service autorisé à l'aide du service de découverte.

    api_key = 'API_KEY'
api_name = 'displayvideo'
api_url = 'https://%s.googleapis.com/' % api_name
api_version = 'v1beta2'

discovery_url = (
    '%s/$discovery/rest?key=%s&version=%s&labels=%s'
    % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
)

service = discovery.build(api_name, api_version,
                          discoveryServiceUrl=discovery_url,
                          http=credentials)