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

Folgen Sie dieser Anleitung, 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 API.

   Enable the API

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 Video Stitcher Admin role to the service account.

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

      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 API.

    Enable the API

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 Video Stitcher Admin role to the service account.

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

       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 der gcloud CLI. 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 autorisierst du den Zugriff und rufst die Video Stitcher API auf.

Dienstkonto mit Berechtigungen zum Erstellen von Sitzungen erstellen

Da ein OAuth-Token an eine Clientanwendung übergeben wird, solltest du ein separates Dienstkonto mit nur Berechtigungen zum Erstellen einer Sitzung erstellen. So kann ein gehacktes OAuth-Token deine Ressourcen wie VOD-/Live-Konfigurationen oder CDN-Schlüssel nicht gefährden.

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 Video Stitcher User role to the service account.

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

   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.

Livestream einrichten

Wenn du Anzeigen in einen Livestream einfügst, folge der Anleitung in diesem Abschnitt oder dieser Anleitung für VOD.

Dienstkonto mit dem 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 Livestream-Ereignisse in deinem Namen erstellen. Gehen Sie dazu so vor, um Ihrem Dienstkonto Zugriff zu gewähren:

1. Melden Sie sich in Google Ad Manager (GAM) an.
2. Klicken Sie auf Verwaltung > Globale Einstellungen.
3. Der API-Zugriff muss aktiviert sein.
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ähle eine Rolle aus, die die Berechtigung Videocontent mit der dynamischen Anzeigenbereitstellung des Video-Stitching-Tools von Google Cloud verwalten enthält. Du solltest speziell für die Verwaltung dieses Dienstkontos eine benutzerdefinierte Rolle mit dem Namen Livestream-Manager erstellen. Die benutzerdefinierte Rolle sollte mindestens die folgenden Berechtigungen haben:
   • Videocontent mit der dynamischen Anzeigenbereitstellung des Video-Stitching-Tools von Google Cloud verwalten
   • Creatives ansehen (erforderlich für die vorherige Berechtigung)
   • Videocontent, Sets und Metadaten aufrufen
   • Contentquellen ansehen
7. Wenn in Ihrem Ad Manager-Netzwerk Teams verwendet werden, müssen Sie dem Nutzer des Dienstkontos das Team „Alle Entitäten“ zuweisen.
8. Klicken Sie auf Speichern und bestätigen Sie, dass das Dienstkonto hinzugefügt werden soll.

Livestream erstellen

Du kannst eine der Live Stream API-Kurzanleitungen verwenden, um einen Livestream einzurichten. Sowohl HLS- als auch MPEG-DASH-Livestreams werden unterstützt (siehe Anforderungen an das Quellmanifest). Dieser Vorgang ist optional. Du kannst auch einen eigenen Livestream verwenden.

In den Kurzanleitungen für die Live Stream API werden Standardanmeldedaten für Anwendungen für die Authentifizierung verwendet. Du kannst aber auch das bereits eingerichtete Dienstkonto verwenden. Das Dienstkonto muss für diese Option die Rolle Livestream-Bearbeiter haben.

Lassen Sie den Livestream aktiv. Führen Sie die Schritte im Abschnitt Bereinigen erst aus, wenn Sie mit dem Livestream fertig sind.

Anforderungen an das Quellmanifest

Die Video Stitcher API registriert die Konfiguration in Ad Manager, indem sie das Quellmanifest analysiert. Das Quellmanifest muss je nach Format bestimmte Eigenschaften haben.

HLS

• Das Containerformat kann folgendermaßen sein:
  • MPEG-TS-Muxing
  • unmuxed MPEG-TS
  • unmuxed FMP4
• Mindestens eine Version im Manifest mit den folgenden (richtig ausgefüllten) Feldern:
  • Codecs
  • Bandbreite

MPEG-DASH

• MPD@type auf „dynamisch“ (@type="dynamic") festgelegt ist
• MPD@profiles enthält das ISO-Live-Profil urn:mpeg:dash:profile:isoff-live:2011
• Es sollte mehrere Zeiträume enthalten, von denen jeder mindestens ein Anpassungsset enthält.
• Jedes Anpassungs-Set enthält eine oder mehrere Darstellungen.
• Die Darstellungen enthalten oder erben eine SegmentTemplate mit der $Number$- oder $Time$-ID.
• @segmentAlignment für alle Anpassungssätze auf „wahr“ gesetzt
• Darstellungen dürfen nicht leer sein.

VOD-Stream einrichten

Wenn du Anzeigen in einen VOD-Stream einfügst, folge der Anleitung in diesem Abschnitt oder der Anleitung für einen Livestream.

VOD-Quelldateien erstellen

Für diesen Workflow ist eine MPEG-DASH-Manifestdatei (MPD) oder eine HLS-Manifestdatei (M3U8) sowie die zugehörigen Segmentdateien erforderlich. Du kannst deine eigenen vorhandenen VOD-Dateien verwenden oder VOD-Quelldateien mit der Transcoder API erstellen.