À l'aide de l'API Video Stitcher, vous créez une session en direct chaque fois que vous lancez la lecture d'un flux en direct dans lequel les annonces diffusées par Google Ad Manager sont assemblées dynamiquement pendant les pauses 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 en direct. Pour l'intégration à Google Ad Manager, assurez-vous que l'objet
gamLiveConfig
est défini. - Si vous spécifiez une ardoise, assurez-vous que l'objet
gamSlate
est défini sur l'ardoise que vous enregistrez.
Créer une session en direct
Pour créer une session en direct directement à l'aide de l'API, utilisez la méthode projects.locations.liveSessions.create
.
Le champ liveConfig
est le seul champ obligatoire dans le corps JSON. Vous pouvez définir ou remplacer les paramètres facultatifs suivants par session en direct (comme indiqué dans l'exemple REST suivant) :
manifestOptions
: spécifie les rendus vidéo générés dans le fichier manifeste de la vidéo assemblée et l'ordre des rendus. Consultez la documentation sur les options du fichier manifeste.adTracking
: sélectionnez le suivi des annonces côté client ou côté serveur. Cette valeur remplace celle de la configuration en direct pour la session.targetingParameters
: un tag d'emplacement publicitaire Google Ad Manager peut contenir des paramètres de ciblage pouvant être mis à jour par session. Fournissez une mise en correspondance 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 ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: numéro de votre Google Cloud projet indiqué dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement dans lequel créer votre session. Utilisez l'une des régions disponibles.Afficher les zones géographiquesus-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 en direct
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 pour C# du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour Go du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour Java du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour Node.js du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour PHP du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour Python du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 pour Ruby du guide de démarrage rapide de l'API Video Stitcher à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur les API Video Stitcher en langage 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 le playUri
n'est pas demandé dans les cinq dernières minutes.
Vous pouvez utiliser l'élément 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'annonce pour les sessions, utilisez l'outil de contrôle de l'activité des flux dans Ad Manager pour afficher les détails des demandes d'annonces. Vous pouvez utiliser STREAM_ID
pour déboguer la session de flux. Pour trouver le STREAM_ID
d'une session en direct, consultez Obtenir une session.