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 Links zu Ihrem Konto hinzufügen und daraus entfernen.
Videos verknüpfen
Videos können auf zwei Arten mit Ihrem Konto verknüpft werden, je nachdem, wer den Vorgang startet:
- 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, damit die Verknüpfung zu seinem Video hergestellt werden kann. Sie können eine Anfrage, die verlängert wurde, widerrufen, bevor sie akzeptiert wird. Außerdem können Sie 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 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, oder die video_id des Videos, das du verlinken 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. 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 prüfen. |
|
| Anfrage widerrufen | Mit der Methode
DataLinkService.UpdateDataLink können Sie eine Verknüpfungsanfrage widerrufen, indem Sie den status der
DataLink von REQUESTED in REVOKED ändern. |
|
| Link entfernen | Mit
DataLinkService.RemoveDataLink kannst du 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üpfungsanfragen annehmen oder ablehnen | Verwenden Sie die Methode
DataLinkService.UpdateDataLink, um den Status von DataLink auf ENABLED (Anfrage annehmen) oder REJECTED (Anfrage ablehnen) zu aktualisieren. |
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. |