YouTube verknüpfen

Die Google Ads API unterstützt die Verknüpfung von YouTube-Videos mit Ihrem Google Ads-Konto. In diesem Leitfaden 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 deinem Konto verknüpft werden, je nachdem, wer den Vorgang startet:

1. Sie stellen eine Anfrage, um ein Video mit Ihrem Konto zu verknüpfen. In diesem Fall senden Sie eine Anfrage an einen Creator, die dieser annehmen muss, damit die Verknüpfung mit seinem Video hergestellt werden kann. Du kannst eine Anfrage, die verlängert wurde, widerrufen, bevor sie angenommen wird. Außerdem kannst du ein verknüpftes Video entfernen, nachdem die Anfrage angenommen wurde.
2. Der Creator des Videos beantragt, 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 über die YouTube API abrufen	Verwende die YouTube API, um die channel_id abzurufen, an die die Verknüpfungsanfrage für das Video gesendet werden soll, und die video_id des Videos, das du verknüpfen möchtest. Die video_id ist die 11-stellige Zeichenfolge 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 Methode DataLinkService.CreateDataLink, um eine Verknüpfungsanfrage zu erstellen. Geben Sie dabei 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 anzugeben, damit Creator Ihre Marke besser verstehen. Der status des DataLink sollte nicht festgelegt werden. Der Google Ads API-Server legt diesen Wert 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 Methode DataLinkService.UpdateDataLink, um eine Verknüpfungsanfrage zu widerrufen. Ändern Sie dazu den status des DataLink von REQUESTED in REVOKED.
	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 Methode DataLinkService.UpdateDataLink, um den Status des DataLink auf ENABLED zu aktualisieren, um die Anfrage anzunehmen, oder auf 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-Videolinks 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'

Die folgenden häufigen Fehler können in diesem Workflow auftreten:

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