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 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 widerrufen, die gesendet wurde, bevor sie angenommen wurde, 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, oder die video_id des Videos, das Sie verknüpfen möchten. Die video_id kann auch aus der URL eines Videos abgerufen werden, indem die 11 Zeichen nach "v=" extrahiert werden.
Verknüpfungsanfrage erstellen Verwenden Sie die DataLinkService.CreateDataLink Methode , um eine Verknüpfungsanfrage zu erstellen. Optional können Sie youtube_video.channel_id angeben, um den mit dem Video verknüpften Kanal explizit zu identifizieren. 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-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'

Im Rahmen dieses Workflows können die folgenden häufigen Fehler auftreten:

Fehlercode Erklärung
DataLinkError.PERMISSION_DENIED Der Kunde hat keine Berechtigung, diese Aktion auszuführen.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID Es konnte keine Videoverknüpfung erstellt werden, da die Video-ID ungültig ist.
Zurück
Produktkonten verknüpfen
Weiter
Änderungsstatus