YouTube verknüpfen

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

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

  1. Sie beantragen, 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. Du kannst einen Antrag, der verlängert wurde, widerrufen, bevor er akzeptiert wird. Außerdem kannst du ein verknüpftes Video entfernen, nachdem der Antrag akzeptiert wurde.
  2. Der Creator des Videos möchte, dass sein Video mit Ihrem Google Ads-Konto verknüpft wird. Sie können die Anfrage dann annehmen oder ablehnen.

In den einzelnen Szenarien werden die folgenden Methoden verwendet:

Szenario Aktion Anmerkungen
Szenario 1 Videoinformationen über die YouTube API abrufen Verwende die YouTube API, um die channel_id zu erhalten, an die die Anfrage für den Videolink gesendet werden soll, und die video_id des Videos, das du verlinken möchtest. video_id ist der 11‑stellige String, der in YouTube-Video-URLs zu finden ist, 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 dazu 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. So können Creator Ihre Marke besser kennenlernen. Die status der DataLink darf nicht festgelegt werden. Der Google Ads API-Server legt sie 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 die status zu untersuchen.
Anfrage widerrufen Mit der Methode DataLinkService.UpdateDataLink können Sie eine Verknüpfungsanfrage widerrufen, indem Sie den status des DataLink von REQUESTED in REVOKED ändern.
Link entfernen Mit DataLinkService.RemoveDataLink können Sie ein verknüpftes Video 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 von DataLink auf ENABLED (Anfrage annehmen) oder REJECTED (Anfrage ablehnen) zu aktualisieren.

Linkdetails abrufen

Sie können GoogleAdsService.Search oder GoogleAdsService.SearchStream verwenden, um die Ressource data_link abzufragen. Mit der folgenden Abfrage werden Details für 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'

In 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 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 versucht wird, einen nicht unterstützten Statusübergang durchzuführen (z. B. direkt von REVOKED zu ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS Wird ausgelöst, wenn bereits ein Datenlink für das Video vorhanden ist.
Zurück
Produktkonten verknüpfen
Weiter
Status ändern