L'API Video Stitcher vous permet de créer une session en direct chaque fois que vous lancez la lecture d'un flux en direct au cours duquel des annonces diffusées par Google Ad Manager sont assemblées de manière dynamique pendant les coupures publicitaires. La réponse spécifie l'URL de lecture et la configuration de la session en direct.
Ce document explique comment créer et gérer une session en direct. Pour en savoir plus, consultez la documentation REST.
Avant de commencer
- Créez une configuration active. Pour l'intégration à Google Ad Manager, assurez-vous que l'objet
gamLiveConfig
est défini. - Si vous spécifiez un écran, assurez-vous que l'objet
gamSlate
est défini sur l'écran que vous enregistrez.
Créer une session en direct
Pour créer une session en direct à l'aide de l'API directement, utilisez la méthode projects.locations.liveSessions.create
.
Le champ liveConfig
est le seul champ obligatoire du corps JSON. Vous pouvez définir ou remplacer les paramètres facultatifs suivants par session en direct (comme illustré dans l'exemple REST suivant):
manifestOptions
: spécifie les rendus vidéo générés dans le fichier manifeste vidéo assemblé et l'ordre des rendus. Consultez la documentation sur les options du fichier manifeste.adTracking
: permet de sélectionner le suivi des annonces côté client ou le suivi des annonces côté serveur. Cette option remplace la valeur de la configuration active pour la session.targetingParameters
: un tag d'emplacement publicitaire Google Ad Manager peut contenir des paramètres de ciblage qui peuvent être mis à jour par session. Fournissez un mappage dans ce champ (par exemple, pour remplacer la macro[my_key]
par la chaînemy_value
, consultez l'exemple REST).
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud situé dans le champ Numéro du projet sur la page Paramètres IAMLOCATION
: emplacement dans lequel créer votre session (utilisez l'une des régions compatibles)Afficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
LIVE_CONFIG_ID
: identifiant défini par l'utilisateur pour la configuration active
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Avant d'essayer cet exemple, suivez les instructions de configuration de C# dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher C#.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration de Go dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher Go.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration de Java dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher Java.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration de Node.js dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher Node.js.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Avant d'essayer cet exemple, suivez les instructions de configuration de PHP dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher PHP.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration de Python dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher Python.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Avant d'essayer cet exemple, suivez les instructions de configuration de Ruby dans le guide de démarrage rapide de l'API Video Stitcher à l'aide de bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Video Stitcher Ruby.
Pour vous authentifier auprès de l'API Video Stitcher, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'API Video Stitcher génère un ID de session unique pour chaque requête. Une session expire si l'playUri
n'est pas demandée au cours des cinq dernières minutes.
Vous pouvez utiliser le STREAM_ID
renvoyé pour inspecter la session en direct.
Inspecter les sessions en direct activées par Google Ad Manager
Pour afficher les détails des tags d'emplacement publicitaire pour les sessions, utilisez l'outil de contrôle de l'activité des flux dans Ad Manager afin de consulter les détails sur les demandes d'annonces. Vous pouvez utiliser STREAM_ID
pour déboguer la session de diffusion. Pour trouver le STREAM_ID
d'une session en direct, consultez Obtenir une session.