Häufig gestellte Fragen

Allgemein

Was ist die neueste Version der API?

Die neueste Version der API, die in diesem Dokument angegeben wird, ist v3.

Kann ich mit dieser API Leistungsdaten abrufen?

Nein. Sie können die Bid Manager API verwenden, um Display & Video 360-Offlineberichte zu erstellen, abzurufen und auszuführen.

API verwenden

Welche URL verwende ich für den Zugriff auf die API?

https://displayvideo.googleapis.com

Welche Authentifizierungsmethoden werden unterstützt?

OAuth 2.0 ist die einzige unterstützte Authentifizierungsmethode.

Display & Video 360 API-Anfragen müssen für den folgenden Bereich autorisiert werden:

• https://www.googleapis.com/auth/display-video

Anfragen an den users-Dienst müssen auch für den folgenden zusätzlichen Bereich autorisiert werden:

• https://www.googleapis.com/auth/display-video-user-management

Ich möchte Code schreiben. Wo finde ich Clientbibliotheken?

Weitere Informationen finden Sie im Leitfaden zu Clientbibliotheken.

Was ist, wenn ich keine Clientbibliothek verwenden möchte?

Wir empfehlen Ihnen, eine unserer Clientbibliotheken zu verwenden. Sie können aber auch über direkte HTTP-Anfragen mit der Display & Video 360 API interagieren.

Es ist schwieriger, einige komplexere Methoden wie advertisers.assets.upload und media.upload direkt in HTTP-Anfragen zu übersetzen. Beispiele für HTTP-Anfragen für diese Methoden mit cURL finden Sie in unseren Leitfäden zu Creatives und zur benutzerdefinierten Gebotseinstellung.

Welche Display & Video 360-Berechtigungen benötige ich?

Damit Sie die Display & Video 360 API verwenden können, muss das authentifizierende Google-Konto ein Display & Video 360-Nutzer mit Zugriff auf relevante Partner oder Werbetreibende sein.

Der Display & Video 360-Nutzer muss eine der folgenden Nutzerrollen haben, damit die entsprechenden Partner oder Werbetreibenden Folgendes tun können:

• Nur Lesen: Rufen Sie Ressourcen mit get- oder list-Aufrufen ab, ausgenommen user-Ressourcen.
• Standard: Ressourcen abrufen, erstellen und aktualisieren. Rufen Sie user-Ressourcen mit Berechtigungen für dieselben Partner oder Werbetreibenden ab.
• Administrator: Rufen Sie Ressourcen ab, erstellen und aktualisieren Sie sie. user-Ressourcen für die von Ihnen verwalteten Partner oder Werbetreibenden abrufen, erstellen und gewähren.

Wie aktualisiere ich „YouTube und Partner“-Ressourcen mithilfe der API?

Mit der Display & Video 360 API können keine YouTube und Partner-Ressourcen erstellt oder aktualisiert werden. Sie können Ressourcen für YouTube und Partner im Bulk erstellen oder aktualisieren. Laden Sie dazu strukturierte Datendateien (Structured Data Files, SDFs) über die Display & Video 360-Benutzeroberfläche hoch. Weitere Informationen zum Hochladen von Dateien mit strukturierten Daten finden Sie auf der Anleitungsseite zu „YouTube und Partner“-Ressourcen.

Wie kann ich meine Anzeigen auf bestimmte Standorte ausrichten?

Das geografische Targeting kann Werbebuchungen mithilfe der folgenden Targeting-Typen zugewiesen werden:

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Rufen Sie die Targeting-Options-IDs für die ersten drei Targeting-Typen mit targetingTypes.targetingOptions.search ab. Rufen Sie Ressourcen für Standortlisten mit dem Dienst advertisers.locationLists ab und verwalten Sie sie.

Darüber hinaus können Sie auch eine ID für die TARGETING_TYPE_POI-Targeting-Option erstellen, um die Anzeigen direkt auf einen Umkreis um bestimmte Breiten- und Längengrade auszurichten.

Ich sehe, dass ich strukturierte Datendateien über die API herunterladen kann. Aber wie lade ich sie hoch?

Der Upload von Dateien mit strukturierten Daten wird von der Display & Video 360 API nicht unterstützt. Wir empfehlen, stattdessen die von der API bereitgestellten Methoden CREATE, PATCH und DELETE zu verwenden, um Ressourcen zu verwalten. Wenn Sie Ressourcen weiterhin mit SDFs verwalten möchten, können Sie diese Dateien auf der Display & Video 360-Benutzeroberfläche aktualisieren.

Support

Gibt es bei der API bekannte Probleme oder Einschränkungen?

In unserem Leitfaden zu Nutzungslimits gibt es Limits für die Anzahl der Anfragen, die von Ihrem Projekt pro Sekunde gestellt werden können.