Clientanwendung für die Zusammenarbeit mit Google Ad Manager vorbereiten

Erforderliche Informationen für Ihre Clientanwendungen erfassen

Du solltest die folgenden Informationen haben, die für die Erstellung einer Livestreamsitzung in Google Ad Manager erforderlich sind:

Feld	Beschreibung
projectNumber	Die Google Cloud-Projektnummer (PROJECT_NUMBER), die zum Erstellen von Ad Manager-fähigen Sitzungen verwendet wird. Alternativ können Sie auch die Projekt-ID verwenden.
region	Der Speicherort (LOCATION), an dem die Livekonfiguration registriert ist.
liveConfigId	Die Live-Konfigurations-ID, mit der das Livestreamereignis bei der Video Stitcher API registriert wurde. Im Folgenden sehen Sie das Format für den vollständigen Namen der Konfigurationsressource: 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 mit dem Speicherort übereinstimmen, an dem du die Sitzung erstellst.
customAssetKey	Der benutzerdefinierte Asset-Schlüssel (CUSTOM_ASSET_KEY), der bei der Registrierung der Livekonfiguration erstellt wurde. Der Wert ist für das IMA SDK erforderlich, um den Stream zu erstellen.
networkCode	Die numerische Kennung (NETWORK_CODE) für Ihr Ad Manager-Netzwerk.
oAuthToken	Ein kurzlebiges OAuth-Token für das Dienstkonto mit der Rolle Video Stitcher User. Weitere Informationen finden Sie unter Kurzlebige OAuth-Tokens generieren.

Tabelle 1. Erforderliche Informationen für Ad Manager-kompatible Livestreamsitzungen

Kurzlebige OAuth-Tokens für Tests generieren

So generieren Sie ein kurzlebiges OAuth-Token, das mit dem Dienstkonto mit der Rolle Video Stitcher User 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 aus dem Dienstkonto ab:

   gcloud auth print-access-token

Da es sich um ein kurzlebiges Token handelt, müssen Sie es regelmäßig mit dem Befehl gcloud auth print-access-token neu generieren und die neuen Tokens an Ihre Clientanwendungen senden. Im folgenden Abschnitt finden Sie weitere Informationen zum Erstellen eines Produktionsdienstes für kurzlebige Tokens.

Wichtig :Das Generieren eines OAuth-Tokens ist ein zeitaufwendiger Vorgang. Versuche, ein OAuth-Token beim Erstellen von Sitzungen nach Möglichkeit wiederzuverwenden. Sie können die Gültigkeitsdauer eines Tokens mit dem Flag --lifetime verlängern.

Dienst zum Bereitstellen von Informationen für Ihre Clientanwendungen erstellen

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 deinem Dienst anfordert, sollte der Dienst die in Tabelle 1 beschriebenen Informationen zurückgeben.

Insbesondere muss der Dienst OAuth-Tokens auf sichere Weise für Clientanwendungen bereitstellen können. Konfigurieren Sie diesen Dienst mit zwei Dienstkonten, wobei eines sich als das andere ausgibt. 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 Ersteller von Diensttokens für Dienstkonto 2 und übernimmt die Identität von Dienstkonto 2 für Clientanwendungen.
• Dienstkonto 2: Das ist das Dienstkonto mit Berechtigungen, das die Rolle Video Stitcher User hat, um Sitzungen zu erstellen.

Informationen zum Bereitstellen eines OAuth-Tokens über Ihren Dienst, einschließlich Codebeispielen für Clientbibliotheken, finden Sie unter Kurzlebiges Zugriffstoken erstellen.