Pour activer l'API Video Stitcher pour votre projet, veuillez contacter votre responsable de compte ou le service commercial 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é. La L'API Video Stitcher enregistre cette configuration auprès d'Ad Manager.

Créer un écran

Avant de créer la configuration active, 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. Toi Vous devez enregistrer une vidéo d'écran avec l'API Video Stitcher pour indiquer l'écran à utiliser. en l'absence d'annonces. La vidéo de l'écran peut être n'importe quel fichier MP4 avec au moins un élément la piste audio.

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

Créer un écran 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 Créer une série pour combler les lacunes entre les contenus, puis passez à la section Créer la configuration en direct.

Créer un écran à l'aide de l'API Video Stitcher

Pour créer un écran avec l'API Video Stitcher, utilisez la classe projects.locations.slates.create .

Avant d'utiliser les données de requête ci-dessous, 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 dans lequel créer votre carte. Utilisez l'une des régions disponibles.
Afficher les lieux
- 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 le caractère L'ID entier 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 un Opération de longue durée (LRO) que vous pouvez interroger pour suivre la progression. Copiez l'élément renvoyé. OPERATION_ID, qui est la dernière partie du champ name, que nous utiliserons 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 que la réponse contienne "done: true".

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

PROJECT_NUMBER: numéro de votre projet Google Cloud celui-ci se trouve dans le champ Numéro du projet des paramètres IAM page
LOCATION : emplacement des données. Utilisez l'une des régions disponibles.
Afficher les lieux
- 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 : numéro de votre projet Google Cloud, 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 lieux
- 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 le caractère L'ID entier 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 pouvoir y accéder. 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 a créé un test de la diffusion en direct à l'aide de l'API Live Stream, il s'agit de l'URI de la main.m3u8 ou main.mpd dans le bucket Cloud Storage.
```
AD_TAG_URI
```
: URL des métadonnées de l'annonce. récupérées à partir des serveurs de publicité ; pour l'intégration d'Ad Manager, il doit s'agir d'un le tag publicitaire vidéo en direct Ad Manager. Pour obtenir un tag d'emplacement publicitaire valide, suivez les instructions Générer des tags d'emplacement publicitaire vidéo et audio en y apportant les modifications suivantes:
- Pour Trafic en temps réel, activez le trafic en temps réel.
- Dans le champ Type de SDK du lecteur, sélectionnez SDK IMA de Google.
- Ajoutez le paramètre ad_rule=0 à la balise (par exemple, &ad_rule=0). à la fin).
SLATE_ID: ID de l'écran à utiliser dans 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 la configuration de manière asynchrone de 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 Vérifiez 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 : numéro de votre projet Google Cloud, 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 lieux
- 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 IMA (Interactive Media Ads) lors d'une étape ultérieure.

Aperçu

Préparer votre application cliente à utiliser Google Ad Manager