YouTube verknüpfen

Die Google Ads API unterstützt die Verknüpfung von YouTube-Videos mit Ihrem Google Ads-Konto. In dieser Anleitung wird erläutert, wie Sie mit der API Verknüpfungen zu Ihrem Konto hinzufügen und entfernen.

Videos verknüpfen

Videos können auf zwei Arten mit Ihrem Konto verknüpft werden, je nachdem, wer den Vorgang startet:

1. Sie fordern an, dass ein Video mit Ihrem Konto verknüpft wird. In diesem Fall senden Sie eine Anfrage an einen Creator, die er annehmen muss, um die Verknüpfung zu seinem Video herzustellen. Sie können eine Anfrage, die gesendet wurde, widerrufen, bevor sie angenommen wird, und ein verknüpftes Video entfernen, nachdem es angenommen wurde.
2. Der Creator des Videos fordert an, dass sein Video mit Ihrem Google Ads-Konto verknüpft wird. Sie können die Anfrage dann annehmen oder ablehnen.

In jedem Szenario werden die folgenden Methoden verwendet:

Szenario	Aktion	Anmerkungen
Szenario 1	Videoinformationen aus der YouTube API abrufen	Verwenden Sie die YouTube API um die channel_id abzurufen, an die die Anfrage zur Videoverknüpfung gesendet werden soll, und die video_id des Videos, das Sie verknüpfen möchten. Die video_id ist der 11-stellige String in YouTube-Video-URLs, z. B. der Parameter v in www.youtube.com/watch?v=VIDEO_ID oder der Pfad in youtu.be/VIDEO_ID.
	Verknüpfungsanfrage erstellen	Verwenden Sie die DataLinkService.CreateDataLink Methode , um eine Verknüpfungsanfrage zu erstellen. Geben Sie sowohl youtube_video.channel_id als auch youtube_video.video_id an, um das Video und den zugehörigen Kanal zu identifizieren. Ab Version 24 können Sie auch youtube_link_metadata.brand_channel_id angeben, um die ID des verknüpften YouTube-Markenkanals bereitzustellen, damit Creator Ihre Marke besser verstehen. Der status des DataLink sollte nicht festgelegt werden. Der Google Ads API-Server legt ihn nach erfolgreichem Abschluss des API-Aufrufs auf REQUESTED fest.
	Status einer Anfrage prüfen	Verwenden Sie GoogleAdsService.SearchStream oder GoogleAdsService.Search, um die Ressource data_link abzufragen und ihren status zu prüfen.
	Anfrage widerrufen	Verwenden Sie die DataLinkService.UpdateDataLink Methode , um eine Verknüpfungsanfrage zu widerrufen, indem Sie den status des DataLink von REQUESTED in REVOKED ändern.
	Verknüpfung aufheben	Verwenden Sie DataLinkService.RemoveDataLink, um ein verknüpftes Video zu entfernen.
Szenario 2	Einladung abrufen	Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream , um die Ressource data_link abzufragen. Filtern Sie nach status = PENDING_APPROVAL, um Verknüpfungsanfragen zu finden, die Sie annehmen oder ablehnen können.
	Verknüpfungsanfrage annehmen oder ablehnen	Verwenden Sie die DataLinkService.UpdateDataLink Methode, um den Status des DataLink in ENABLED zu ändern, um die Anfrage anzunehmen, oder in REJECTED, um sie abzulehnen.

Verknüpfungsdetails abrufen

Sie können GoogleAdsService.Search oder GoogleAdsService.SearchStream verwenden, um die Ressource data_link abzufragen. Mit der folgenden Abfrage werden Details zu YouTube-Videoverknüpfungen abgerufen, einschließlich der YouTube-Video-ID und der Kanal-ID:

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

Bei diesem Workflow können die folgenden häufigen Fehler auftreten:

Fehlercode	Erklärung
DataLinkError.PERMISSION_DENIED	Der Kunde ist nicht berechtigt, diese Aktion auszuführen.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Es konnte keine Videoverknüpfung erstellt werden, da die Video-ID ungültig ist.
DataLinkError.INVALID_STATUS	Wird ausgelöst, wenn der aktuelle Status der Datenverknüpfung für den angeforderten Vorgang ungültig ist.
DataLinkError.INVALID_UPDATE_STATUS	Wird ausgelöst, wenn bei einer Aktualisierung ein nicht unterstützter Statusübergang versucht wird (z. B. ein direkter Übergang von REVOKED zu ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS	Wird ausgelöst, wenn bereits eine Datenverknüpfung für das Video vorhanden ist.