Clientanwendung auf die Arbeit mit Google Ad Manager vorbereiten

Erforderliche Informationen für Ihre Clientanwendungen erfassen

Ihnen sollten die folgenden Informationen vorliegen, die erforderlich sind, damit Google Ad Manager eine Livestreamsitzung erstellt:

Feld	Beschreibung
projectNumber	Die Google Cloud-Projektnummer, die zum Erstellen von Ad Manager-fähigen Sitzungen verwendet wird. Alternativ können Sie die Projekt-ID verwenden.
region	Die Region, in der die Live-Konfiguration registriert ist.
liveConfigId	Die ID der Livekonfiguration, die zum Registrieren des Livestreamereignisses mit der Video Stitcher API verwendet wird. Im Folgenden wird das Format für den vollständigen Namen der Konfigurationsressource gezeigt: projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID Die Konfigurations-ID ist der letzte Teil des vollständigen Namens (LIVE_CONFIG_ID). Der Speicherort der Konfiguration muss sich am selben Ort befinden, an dem Sie die Sitzung erstellen.
customAssetKey	Der benutzerdefinierte Asset-Schlüssel, der bei der Registrierung der Livekonfiguration erstellt wurde. Das IMA SDK benötigt diesen Wert, um den Stream zu erstellen.
networkCode	Die numerische Kennung für Ihr Ad Manager-Netzwerk.
OAuth token	Ein kurzlebiges OAuth-Token für das Dienstkonto mit der Rolle Video Stitcher User. Siehe Kurzlebige OAuth-Tokens generieren.

Tabelle 1. Erforderliche Informationen für Livestreamsitzungen mit aktiviertem Ad Manager

Kurzlebige OAuth-Tokens für Tests generieren

So generieren Sie ein kurzlebiges OAuth-Token, das mit dem Dienstkonto mit der Rolle Video Stitcher-Nutzer verknüpft ist:

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

2. Rufen Sie das OAuth 2.0-Inhabertoken vom Dienstkonto ab:

   gcloud auth print-access-token
   

Da dies ein kurzlebiges Token ist, müssen Sie es regelmäßig mit dem Befehl gcloud auth print-access-token neu generieren und die neuen Tokens an Ihre Clientanwendungen senden. Weitere Informationen zum Erstellen eines Produktionsdienstes zum Bereitstellen kurzlebiger Tokens finden Sie im folgenden Abschnitt.

Wichtig: Das Neugenerieren eines OAuth-Tokens ist ein zeitaufwendiger Vorgang. Versuchen Sie, ein OAuth-Token beim Erstellen von Sitzungen so oft wie möglich wiederzuverwenden. Mit dem Flag --lifetime können Sie die Lebensdauer eines Tokens verlängern.

Dienst erstellen, um Informationen für Ihre Clientanwendungen bereitzustellen

Erstellen Sie einen Dienst, der die erforderlichen Informationen bereitstellen kann, die an den Client übergeben werden sollen. Wenn die Anwendung Informationen zum Abspielen eines Livestreams von Ihrem Dienst anfordert, sollte der Dienst die in Tabelle 1 beschriebenen Informationen zurückgeben.

Insbesondere muss der Dienst in der Lage sein, Clientanwendungen sicher OAuth-Tokens bereitzustellen. Konfigurieren Sie diesen Dienst mithilfe von zwei Dienstkonten, von denen eines das andere imitiert. Ein Dienstkonto hat die Rolle Service Token Creator und erstellt ein OAuth-Token für das Dienstkonto mit der Rolle Video Stitcher User. Beispiel:

• Dienstkonto 1: Dies ist das Dienstkonto des Aufrufers. Dieses Konto hat die Berechtigung Service Token Creator für Dienstkonto 2 und übernimmt die Identität von Dienstkonto 2 für Clientanwendungen.
• Dienstkonto 2: Dies ist das Dienstkonto mit Berechtigung, das die Rolle Video Stitcher-Nutzer zum Erstellen von Sitzungen hat.

Informationen zum Bereitstellen eines OAuth-Tokens aus Ihrem Dienst, einschließlich Codebeispielen für die Clientbibliothek, finden Sie unter Kurzlebiges Zugriffstoken erstellen.