Cette page explique comment gérer les configurations de VOD. Les configurations de VOD permettent de configurer les sessions de VOD. Pour en savoir plus, consultez la documentation REST.
Avant de commencer
Pour créer une session de VOD, vous devez d'abord configurer un encodeur qui génère un fichier manifeste HLS ou DASH source pour l'élément VOD. Ces fichiers manifestes contiennent certains repères d'annonces aux limites de coupure publicitaire, qui sont identifiés par l'API Video Stitcher à des fins d'assemblage d'annonces. Vous pouvez utiliser l'API Transcoder pour créer une tâche de transcodage afin de générer des fichiers manifestes à partir de types de fichiers multimédias tels que MP4 ou MOV.
Pour en savoir plus sur les repères d'annonces HLS et DASH compatibles, consultez la documentation sur les repères d'annonces.
Définir une configuration de VOD
Lorsque vous définissez une configuration de VOD, les champs suivants sont obligatoires:
sourceUri
adTagUri
sourceUri
spécifie l'URL du fichier manifeste HLS ou DASH de l'élément VOD source dans lequel insérer des annonces. L'API Video Stitcher renvoie une URL de lecture HLS si l'URL fournie fait référence à un fichier manifeste HLS et à une URL de lecture DASH si l'URL fournie fait référence à un fichier manifeste DASH. Vous pouvez utiliser un fichier manifeste existant ou créer vos propres fichiers sources de VOD.
adTagUri
spécifie l'URL de l'ad server qui renvoie les métadonnées de l'annonce.
Enregistrer une configuration de VOD
Pour enregistrer une configuration de VOD, utilisez la méthode projects.locations.vodConfigs.create
.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement de création de votre configuration de VOD (utilisez l'une des régions disponibles)Afficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: identifiant défini par l'utilisateur pour la configuration de VOD. Cet ID ne peut contenir que des lettres minuscules, des chiffres et des traits d'union. Le premier caractère doit être une lettre, le dernier doit être une lettre ou un chiffre, et l'ID complet ne doit pas dépasser 63 caractères.VOD_URI
: URI du contenu multimédia à assembler. Cet URI doit faire référence à un fichier manifeste MPEG-DASH (MPD) ou HLS (M3U8). Utilisez un URI public ou un URI non signé pour lequel vous avez enregistré une clé CDN.AD_TAG_URI
: URI public du tag d'emplacement publicitaire. Si vous n'en avez pas, vous pouvez utiliser un exemple d'annonce vidéo pré-roll VMAP.
Corps JSON de la requête :
{ "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI" }
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/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create", "cancelRequested": false, "apiVersion": "v1" }, "done": false }
name
, pour l'utiliser dans la section suivante.
Vérifier le résultat
Pour vérifier si la configuration de VOD a été créée, utilisez la méthode projects.locations.operations.get
. Si la réponse contient "done: false"
, répétez la commande jusqu'à ce que la réponse contienne "done: true"
.
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement des données. Utilisez l'une des régions disponibles.Afficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
OPERATION_ID
: identifiant de l'opération
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/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig", "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" } }
Obtenir une configuration de VOD
Pour obtenir les détails d'une configuration de VOD spécifique, utilisez la méthode projects.locations.vodConfigs.get
.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement de la configuration de VOD ; utilisez l'une des régions disponiblesAfficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: identifiant défini par l'utilisateur pour la configuration de VOD
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/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" }
Mettre à jour une configuration de VOD
Pour mettre à jour une configuration de VOD, utilisez la méthode projects.locations.vodConfigs.patch
. L'exemple suivant met à jour le champ sourceUri
.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement de la configuration de VOD ; utilisez l'une des régions disponiblesAfficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: identifiant défini par l'utilisateur pour la configuration de VODVOD_URI
: URI mis à jour du contenu multimédia à assembler.
Corps JSON de la requête :
{ "sourceUri": "VOD_URI" }
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/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "update" }, "done": false }
Répertorier toutes les configurations de VOD enregistrées
Pour répertorier toutes les configurations de VOD enregistrées pour un emplacement donné dans un projet, utilisez la méthode projects.locations.vodConfigs.list
.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement des configurations de VOD (utilisation de l'une des régions disponibles)Afficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "vodConfigs": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "state": "READY" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/my-other-vod-config", "sourceUri": "my-other-vod-stream-uri", "adTagUri": "my-other-ad-tag-uri", "state": "READY" } }
Résultats supplémentaires
La réponse curl
peut inclure un nextPageToken
, que vous pouvez utiliser pour récupérer des résultats supplémentaires:
{ "vodConfigs": [ ... ], "nextPageToken": "NEXT_PAGE_TOKEN" }
Vous pouvez envoyer une autre requête curl
, y compris la valeur de NEXT_PAGE_TOKEN, pour répertorier les configurations supplémentaires. Ajoutez le code suivant à l'URL dans l'appel d'API précédent:
?pageToken=NEXT_PAGE_TOKEN
Pour en savoir plus sur l'utilisation de ce jeton, consultez la bibliothèque cliente correspondante.
Supprimer une configuration de VOD
Si une configuration de VOD enregistrée n'est plus nécessaire, supprimez-la à l'aide de la méthode projects.locations.vodConfigs.delete
.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT_NUMBER
: numéro de votre projet Google Cloud. Il se trouve dans le champ Numéro du projet de la page Paramètres IAM.LOCATION
: emplacement de la configuration de VOD ; utilisez l'une des régions disponiblesAfficher les lieuxus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: identifiant défini par l'utilisateur pour la configuration de VOD
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/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "delete" }, "done": false }