Wenn du die Video Stitcher API für dein Projekt aktivieren möchtest, wende dich bitte an deinen Account Manager oder den Vertrieb.

Diese Seite wurde von der Cloud Translation API übersetzt.

Konfiguration für ein Livestream-Ereignis erstellen

Für die Ad Manager-Verknüpfung musst du eine Livekonfiguration für ein bestimmtes Livestream-Ereignis erstellen. Die Video Stitcher API registriert diese Konfiguration in Ad Manager.

Slate erstellen

Bevor du die Livekonfiguration erstellst, musst du einen Slate erstellen. Die Video Stitcher API fügt ein Standard-Slate-Video ein, wenn keine Anzeigen eingefügt werden können. Du musst das Slate-Video bei der Video Stitcher API registrieren, um anzugeben, welches Slate verwendet werden soll, wenn keine Anzeigen ausgeliefert werden. Das Slate-Video kann eine beliebige MP4-Datei mit mindestens einem Audiotrack sein.

Du hast zwei Möglichkeiten, diesen Slate zu erstellen. Du kannst einen Standard-Slate für dein Netzwerk in deinem Ad Manager-Konto erstellen oder Slates mit der Video Stitcher API erstellen.

Slate in Ad Manager erstellen

Wenn du in deinem Ad Manager-Konto ein Standard-Netzwerk-Slate erstellen möchtest, folge der Anleitung unter Du hast ein Slate zum Füllen von Contentlücken erstellt und gehe dann zum Abschnitt Live-Konfiguration erstellen.

Slate mit der Video Stitcher API erstellen

Verwenden Sie die Methode projects.locations.slates.create, um mit der Video Stitcher API einen Slate zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: Der Speicherort, an dem die Liste erstellt werden soll. Verwenden Sie eine der unterstützten Regionen.
Standorte anzeigen
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
SLATE_ID: eine benutzerdefinierte Kennung für die Slate. Die ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe, das letzte Zeichen ein Buchstabe oder eine Ziffer sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
SLATE_URL: der öffentliche URI für ein MP4-Video mit mindestens einem Audiotrack (Beispielvideo)
NETWORK_CODE: Die numerische Kennung für dein Ad Manager-Netzwerk. Du findest sie in den globalen Einstellungen des Publisher-Kontos.
Wichtig:Du musst das Objekt gamSlate angeben, um die Slate mit Google Ad Manager (GAM) zu verwenden.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Mit diesem Befehl wird ein Vorgang mit langer Ausführungszeit erstellt, den Sie abfragen können, um den Fortschritt zu verfolgen. Kopieren Sie den zurückgegebenen OPERATION_ID, der der letzte Teil des Felds name ist, und verwenden Sie ihn im nächsten Abschnitt.

Ergebnis prüfen

Mit der Methode projects.locations.operations.get kannst du prüfen, ob der Slate erstellt wurde. Wenn die Antwort "done: false" enthält, wiederholen Sie den Befehl, bis die Antwort "done: true" enthält.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: Speicherort der Daten; verwenden Sie eine der unterstützten Regionen.
Standorte anzeigen
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
OPERATION_ID: die Kennzeichnung für den Vorgang

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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"
    }
  }
}

Live-Konfiguration erstellen

Verwenden Sie zum Erstellen der Konfiguration die Methode projects.locations.liveConfigs.create. Optionale Felder wie benutzerdefinierte Header finden Sie in der Referenzdokumentation zur Live-Konfiguration.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: Der Speicherort, an dem die Live-Konfiguration erstellt werden soll. Verwenden Sie eine der unterstützten Regionen.
Standorte anzeigen
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: eine benutzerdefinierte Kennung für die Livekonfiguration. Die ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe, das letzte Zeichen ein Buchstabe oder eine Ziffer sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
SOURCE_LIVESTREAM_URI: die Quell-URL zum Livestream-Videomanifest. Auf diese Datei muss die Video Stitcher API zugreifen können. Die URL muss entweder öffentlich zugänglich sein oder, wenn die URL-Signatur für das CDN aktiviert ist,muss der Video Stitcher API ein registrierter CDN-Schlüssel zur Verfügung gestellt werden. Wenn du einen Test-Livestream mit der Live Stream API erstellt hast, ist dies der URI der main.m3u8- oder main.mpd-Datei im Cloud Storage-Bucket.
```
AD_TAG_URI
```
: Die URL für Anzeigenmetadaten, die von Ad-Servern abgerufen werden. Bei der Ad Manager-Integration muss dies ein gültiges Ad Manager-Anzeigen-Tag für Livevideos sein. Um ein gültiges Anzeigen-Tag zu erhalten, folgen Sie der Anleitung unter Video- und Audioanzeigen-Tags generieren, wobei Sie die folgenden Änderungen vornehmen:
- Aktivieren Sie unter Livetraffic die Option „Livetraffic“.
- Wähle als Art des Player SDK Google IMA SDK aus.
- Fügen Sie dem Tag den Parameter ad_rule=0 hinzu (z. B. &ad_rule=0 ans Ende).
SLATE_ID: Die ID des Slates, der verwendet werden soll, wenn keine zusammengefügten Anzeigen vorhanden sind.
Hinweis:Wenn du einen Standard-Netzwerk-Slate mit Ad Manager erstellt hast, entferne das Feld defaultSlate aus der Anfrage, damit der Standard-Netzwerk-Slate verwendet wird.
NETWORK_CODE: Die numerische Kennung für Ihr Ad Manager-Netzwerk. Sie finden sie in den globalen Einstellungen des Publisher-Kontos.
AD_TRACKING: das Anzeigen-Tracking-Verhalten für deinen Stream. Verwende für IMA SDK-Integrationen CLIENT. Verwenden Sie für das serverseitige Anzeigen-Tracking SERVER. Sie können diesen Wert später auch pro Sitzung überschreiben.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Die Video Stitcher API registriert die Konfiguration asynchron in deinem Ad Manager-Konto. Dies kann einige Minuten dauern.

Mit diesem Befehl wird ein Vorgang mit langer Ausführungszeit erstellt, den Sie abfragen können, um den Fortschritt zu verfolgen. Weitere Informationen finden Sie unter Ergebnis prüfen.

Konfiguration abrufen

Verwenden Sie die Methode projects.locations.liveConfigs.get, um die Konfiguration abzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: Speicherort der Live-Konfiguration; verwenden Sie eine der unterstützten Regionen.
Standorte anzeigen
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID: die benutzerdefinierte Kennung für die Livekonfiguration

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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"
}

Suchen Sie das Feld customAssetKey und kopieren Sie den zurückgegebenen CUSTOM_ASSET_KEY-Wert. Diese Werte werden in einem nachfolgenden Schritt an das Interactive Media Ads (IMA) SDK gesendet.

Zurück

Übersicht

Weiter

Clientanwendung für die Zusammenarbeit mit Google Ad Manager vorbereiten