Die Google Ads API unterstützt die Verknüpfung von YouTube-Videos mit Ihrem Google Ads-Konto. In dieser Anleitung wird beschrieben, wie Sie mithilfe 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:
- Sie möchten, dass ein Video mit Ihrem Konto verknüpft wird. In diesem Fall senden Sie eine Anfrage an einen Creator, die er akzeptieren muss, damit die Verknüpfung mit seinem Video hergestellt werden kann. Sie können einen Antrag, der verlängert wurde, zurückziehen, bevor er akzeptiert wird. Sie können auch ein verknüpftes Video entfernen, nachdem es akzeptiert wurde.
- 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 jedem Szenario werden die folgenden Methoden verwendet:
| Szenario | Aktion | Anmerkungen |
|---|---|---|
| Situation 1 | Videoinformationen über die YouTube API abrufen | Verwende die YouTube API, um die channel_id zu erhalten, an die die Videoverknüpfungsanfrage gesendet werden soll, oder die video_id des Videos, das du verknüpfen möchtest. Die video_id kann auch aus der URL eines Videos abgerufen werden, indem die 11 Zeichen nach "v=" abgerufen werden. |
| Verknüpfungsanfrage erstellen | Verwenden Sie die Methode
DataLinkService.CreateDataLink, um eine Verknüpfungsanfrage zu erstellen. Der Wert status der DataLink sollte nicht festgelegt sein. Der Google Ads API-Server setzt ihn nach erfolgreichem Abschluss des API-Aufrufs auf REQUESTED. |
|
| Status einer Anfrage prüfen | Verwenden Sie GoogleAdsService.SearchStream oder GoogleAdsService.Search, um die Ressource data_link abzufragen und ihre
status zu prüfen. |
|
| Anfrage widerrufen | Verwenden Sie die Methode
DataLinkService.UpdateDataLink, um einen Verknüpfungsantrag zu widerrufen. Ändern Sie dazu das status des
DataLink von REQUESTED in REVOKED. |
|
| Verknüpfung entfernen | Über
DataLinkService.RemoveDataLink kannst du ein verknüpftes Video entfernen. |
|
| Situation 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 zu aktualisieren, um die Anfrage zu akzeptieren, oder auf REJECTED, um sie abzulehnen. |
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 |
Ein Videolink konnte nicht erstellt werden, da die Video-ID ungültig ist. |