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 VOD-Asset-Sitzung 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), den das IMA SDK zum Erstellen der VOD-Sitzung verwenden soll.
vodConfigId	Die VOD-Konfigurations-ID, mit der der VOD-Stream 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/vodConfigs/VOD_CONFIG_ID Die VOD-Konfigurations-ID ist der letzte Teil des vollständigen Namens (VOD_CONFIG_ID). Die Konfiguration muss sich am selben Speicherort befinden, an dem du die VOD-Sitzung erstellst.
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 Sitzungen mit Ad Manager-kompatiblen VOD-Assets

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, der kurzlebige Tokens bereitstellt.

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 VOD-Assets 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.