Hinweis

Auf dieser Seite erfahren Sie, wie Sie ein Google Cloud-Projekt einrichten und Dienstkonten für den Zugriff auf das Projekt konfigurieren.

Google Cloud-Projekt einrichten

Führen Sie die folgenden Schritte aus, um ein Google Cloud-Projekt einzurichten.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Video Stitcher and Live Stream APIs.

   Enable the APIs

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Video Stitcher Admin, Live Stream Editor, Storage Admin.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

6. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

7. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

   Example: Linux or macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Example: Windows

   For PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

   For example:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   For command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Replace KEY_PATH with the path of the JSON file that contains your credentials.

8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

9. Make sure that billing is enabled for your Google Cloud project.

10. Enable the Video Stitcher and Live Stream APIs.

    Enable the APIs

11. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

       Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

       In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the following roles to the service account: Video Stitcher Admin, Live Stream Editor, Storage Admin.

       To grant a role, find the Select a role list, then select the role.

       To grant additional roles, click Add another role and add each additional role.

       Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
    6. Click Continue.

    7. Click Done to finish creating the service account.

       Do not close your browser window. You will use it in the next step.

12. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

13. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

    Example: Linux or macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Example: Windows

    For PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

    For example:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    For command prompt:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Replace KEY_PATH with the path of the JSON file that contains your credentials.

14. Install the Google Cloud CLI.

15. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.
16. Testen Sie die Authentifizierungsumgebung mit dem gcloud-Tool. Prüfen Sie, ob der folgende Befehl einen Textstring ohne Fehler ausgibt:

    gcloud auth application-default print-access-token

Dienstkonto aktivieren

1. Legen Sie in Ihrem Terminal das aktive Projekt für gcloud-Befehle fest. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.

   gcloud config set project YOUR_PROJECT_ID
   

2. Aktivieren Sie das Dienstkonto. Ersetzen Sie PATH_TO_YOUR_SERVICE_KEY durch den Pfad zur JSON-Datei, die Sie auf Ihren lokalen Computer heruntergeladen haben.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
   

Mit diesem Dienstkonto autorisieren Sie den Zugriff und rufen die Video Stitcher API auf.

Dienstkonto mit Ad Manager-Konto verknüpfen

Nachdem das Dienstkonto erstellt wurde, müssen Sie es mit Ihrem Ad Manager-Konto verknüpfen. So kann die Video Stitcher API in Ihrem Namen Livestream-Ereignisse erstellen. Gehen Sie dazu so vor, um Zugriff auf Ihr Dienstkonto zu gewähren:

1. Melden Sie sich in Google Ad Manager (GAM) an.
2. Klicken Sie auf Admin > Globale Einstellungen.
3. Stellen Sie sicher, dass der API-Zugriff aktiviert ist.
4. Klicken Sie auf Dienstkontonutzer hinzufügen.
5. Füllen Sie das Formular aus, einschließlich der E-Mail-Adresse des zuvor erstellten Dienstkontos.
6. Wählen Sie eine Rolle aus, die die Berechtigung Videoinhalte mit dynamischer Anzeigenbereitstellung aus Google Cloud Video Stitcher verwalten umfassen muss. Für die Verwaltung dieses Dienstkontos müssen Sie eine benutzerdefinierte Rolle mit dem Namen Livestream-Manager erstellen. Die benutzerdefinierte Rolle sollte mindestens die folgenden Berechtigungen haben:
   • Videoinhalte mit der dynamischen Anzeigenbereitstellung von Google Cloud Video Stitcher verwalten
   • Creatives ansehen (erforderlich durch die vorherige Berechtigung)
   • Videocontent, Sets und Metadaten ansehen
   • Contentquellen ansehen
7. Klicken Sie auf Speichern und bestätigen Sie das Hinzufügen des Dienstkontos.

Dienstkonto erstellen, das nur Berechtigungen zum Erstellen von Sitzungen hat

Da ein OAuth-Token an eine Clientanwendung übergeben wird, erstellen Sie ein separates Dienstkonto, das ausschließlich Berechtigungen zum Erstellen einer Sitzung hat. So kann ein gehacktes OAuth-Token Ihre Ressourcen wie CDN-Schlüssel und Livestreamereignisse nicht beeinträchtigen.

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the following roles to the service account: Video Stitcher User.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click Add another role and add each additional role.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.

7. Click Done to finish creating the service account.

   Do not close your browser window. You will use it in the next step.

Create a service account key:

1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Live-Stream erstellen

Du kannst einen der Livestreams API-Kurzanleitungen verwenden, um einen Livestream einzurichten. Sowohl HLS- als auch MPEG-DASH-Livestreams werden unterstützt. Weitere Informationen findest du in den Anforderungen für das Quellmanifest. Diese Vorgehensweise ist optional. Du kannst deinen eigenen vorhandenen Livestream verwenden.

In den Schnellstarts der Live Stream API werden zur Authentifizierung die Standardanmeldedaten für Anwendungen verwendet. Sie können jedoch auch das bereits eingerichtete Dienstkonto verwenden. Bei dieser Option muss das Dienstkonto die Rolle Livestream-Bearbeiter haben.

Der Livestream muss aktiv bleiben. Führen Sie die Schritte im Abschnitt Bereinigen erst aus, wenn Sie den Livestream abgeschlossen haben.

Anforderungen an Quellmanifeste

Die Video Stitcher API registriert die Konfiguration in Ad Manager, indem das Quellmanifest geparst wird. Das Quellmanifest muss je nach Format bestimmte Merkmale haben.

HLS

• Das Containerformat kann Folgendes sein:
  • Gemuxtes MPEG-TS
  • nicht gemischtes MPEG-TS
  • nicht muxiertes FMP4
• Mindestens eine Wiedergabe im Manifest mit den folgenden (korrekt ausgefüllten) Feldern:
  • Codecs
  • Bandbreite

MPEG-DASH

• MPD@type auf „dynamisch“ festgelegt (@type="dynamic")
• MPD@profiles enthält das ISO-Live-Profil urn:mpeg:dash:profile:isoff-live:2011
• Ein oder mehrere Perioden, die jeweils einen oder mehrere Anpassungssätze enthalten
• Jeder Anpassungssatz enthält eine oder mehrere Darstellungen
• Die Darstellungen enthalten oder übernehmen eine SegmentTemplate mit der Kennung $Number$ oder $Time$
• @segmentAlignment für alle Anpassungssätze auf „true“ festgelegt
• Angaben zur Darstellung müssen angegeben werden