Pour activer l'API Video Stitcher pour votre projet, veuillez contacter votre responsable de compte ou les équipes commerciales pour en savoir plus.

Cette page a été traduite par l'API Cloud Translation.

Créer une configuration pour un événement diffusé en direct

Pour l'intégration à Ad Manager, vous devez créer une configuration en direct pour un événement de diffusion en direct donné. L'API Video Stitcher enregistre cette configuration dans Ad Manager.

Créer un écran

Avant de créer la configuration du direct, vous devez créer un écran. L'API Video Stitcher insère une vidéo de bande-annonce par défaut lorsque les annonces ne peuvent pas être insérées. Vous devez enregistrer la vidéo de la bande-annonce avec l'API Video Stitcher pour indiquer la bande-annonce à utiliser en l'absence d'annonces. La vidéo de l'énumération peut être n'importe quel fichier MP4 avec au moins une piste audio.

Deux options s'offrent à vous pour créer cette série. Vous pouvez créer une sélection de chaînes par défaut dans votre compte Ad Manager ou créer des sélections à l'aide de l'API Video Stitcher.

Créer une série dans Ad Manager

Pour créer une série de chaînes par défaut dans votre compte Ad Manager, suivez la procédure décrite dans la section Créer une série pour remédier aux interruptions entre les contenus, puis passez à la section Créer la configuration en direct.

Créer une série d'images à l'aide de l'API Video Stitcher

Pour créer un slate à l'aide de l'API Video Stitcher, utilisez la méthode projects.locations.slates.create.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_NUMBER: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
LOCATION: emplacement dans lequel créer votre carte. Utilisez l'une des régions disponibles.
Afficher les emplacements
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
SLATE_ID: identifiant défini par l'utilisateur pour la liste. Cet identifiant 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.
SLATE_URL: URI public d'une vidéo MP4 avec au moins une piste audio (exemple de vidéo)
NETWORK_CODE: identifiant numérique de votre réseau Ad Manager. Vous le trouverez dans les Paramètres généraux du compte éditeur.
Important:Vous devez inclure l'objet gamSlate pour utiliser la plate-forme avec Google Ad Manager (GAM).

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID" | Select-Object -Expand Content

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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

Cette commande crée une opération de longue durée (LRO) que vous pouvez interroger pour suivre la progression. Copiez le OPERATION_ID renvoyé, qui est la dernière partie du champ name, pour l'utiliser dans la section suivante.

Vérifier le résultat

Utilisez la méthode projects.locations.operations.get pour vérifier si la carte a été créée. Si la réponse contient "done: false", répétez la commande jusqu'à ce qu'elle contienne "done: true".

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_NUMBER: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
LOCATION: emplacement des données. Utilisez l'une des régions disponibles.
Afficher les emplacements
- us-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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell (Windows)

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

Créer la configuration en direct

Pour créer la configuration, utilisez la méthode projects.locations.liveConfigs.create. Consultez la documentation de référence de la configuration en direct pour connaître les champs facultatifs (comme les en-têtes personnalisés).

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_NUMBER: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
LOCATION: emplacement dans lequel créer votre configuration en direct. Utilisez l'une des régions disponibles.
Afficher les emplacements
- us-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. Cet identifiant 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.
SOURCE_LIVESTREAM_URI: URL source du fichier manifeste de la vidéo en direct. L'API Video Stitcher doit y avoir accès. L'URL doit être accessible publiquement ou, si la signature d'URL est activée pour le CDN,une clé CDN enregistrée a été fournie à l'API Video Stitcher. Si vous avez créé une diffusion en direct de test à l'aide de l'API Live Stream, il s'agit de l'URI du fichier main.m3u8 ou main.mpd dans le bucket Cloud Storage.
```
AD_TAG_URI
```
: URL des métadonnées des annonces récupérées à partir des serveurs publicitaires. Pour l'intégration d'Ad Manager, il doit s'agir d'un tag publicitaire vidéo en direct Ad Manager valide. Pour obtenir un tag publicitaire valide, suivez la procédure décrite dans la section Générer des tags publicitaires vidéo et audio en apportant les modifications suivantes :
- Pour Trafic généré par les vidéos de flux en direct, activez le trafic généré par les vidéos de flux en direct.
- Pour le type de SDK du lecteur, sélectionnez SDK IMA de Google.
- Ajoutez le paramètre ad_rule=0 à la balise (par exemple, ajoutez &ad_rule=0 à la fin).
SLATE_ID: ID de l'écran à utiliser en l'absence d'annonces assemblées
Remarque:Si vous avez créé un écran de réseau par défaut à l'aide d'Ad Manager, supprimez le champ defaultSlate de la requête pour utiliser l'écran de réseau par défaut.
NETWORK_CODE: identifiant numérique de votre réseau Ad Manager. Vous le trouverez dans les Paramètres généraux du compte éditeur.
AD_TRACKING: comportement de suivi des annonces pour votre flux. Pour les intégrations du SDK IMA, utilisez CLIENT. Pour le suivi des annonces côté serveur, utilisez SERVER. Vous pouvez également remplacer cette valeur par session ultérieurement.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

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/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

L'API Video Stitcher enregistre de manière asynchrone la configuration dans votre compte Ad Manager. Cette opération peut prendre quelques minutes.

Cette commande crée une opération de longue durée (LRO) que vous pouvez interroger pour suivre la progression. Pour en savoir plus, consultez la section Vérifier le résultat.

Obtenir la configuration

Pour obtenir la configuration, utilisez la méthode projects.locations.liveConfigs.get.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_NUMBER: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
LOCATION: emplacement de la configuration en direct. Utilisez l'une des régions disponibles.
Afficher les emplacements
- us-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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

PowerShell (Windows)

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

Recherchez le champ customAssetKey et copiez le CUSTOM_ASSET_KEY renvoyé. Vous envoyez ces valeurs au SDK Interactive Media Ads (IMA) à l'étape suivante.

Aperçu

Préparer votre application cliente à fonctionner avec Google Ad Manager