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, um die Verknüpfung zu seinem Video herzustellen. Sie können eine Anfrage, die verlängert wurde, widerrufen, bevor sie angenommen wird. Außerdem können Sie ein verknüpftes Video entfernen, nachdem es angenommen 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 | Verwenden Sie die Methode
DataLinkService.UpdateDataLink, um eine Verknüpfungsanfrage zu widerrufen. Ändern Sie dazu den status der
DataLink von REQUESTED in REVOKED. |
|
| 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 (zum Annehmen) oder REJECTED (zum Ablehnen) der Anfrage 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. |