DV360 Out of Home Seller API

Mit der DV360 Out of Home Seller API können Sie Inventar verwalten, Aufträge buchen, Creatives abrufen und Play-Ereignisse senden.

Dienst: dv360outofhomeseller.googleapis.com

Um diesen Dienst aufzurufen, empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken verwenden muss, um diesen Dienst aufzurufen, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet die folgenden Discovery-Dokumente:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://dv360outofhomeseller.googleapis.com

REST-Ressource: v1beta1

Methoden
lookupByExternalId POST /v1beta1:lookupByExternalId
Ruft alle Entitäten nach der in der Anfrage aufgeführten externen ID ab.

REST-Ressource: v1beta1.adPlays

Methoden
create POST /v1beta1/adPlays
Erstellt eine Anzeigenwiedergabe.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
Erstellt eine Wiedergabe mit externen IDs.

REST-Ressource: v1beta1.adUnits

Methoden
create POST /v1beta1/adUnits
Erstellt einen neuen Anzeigenblock.
delete DELETE /v1beta1/{name=adUnits/*}
Löscht einen vorhandenen Anzeigenblock.
get GET /v1beta1/{name=adUnits/*}
Ruft einen einzelnen Anzeigenblock ab.
list GET /v1beta1/adUnits
Listet Anzeigenblöcke auf.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
Aktualisiert einen vorhandenen Anzeigenblock.

REST-Ressource: v1beta1.availabilityOrders

Methoden
complete POST /v1beta1/{name=availabilityOrders/*}:complete
Kennzeichnet einen vorhandenen Verfügbarkeitsauftrag als abgeschlossen.
get GET /v1beta1/{name=availabilityOrders/*}
Ruft einen einzelnen Verfügbarkeitsauftrag ab.
list GET /v1beta1/availabilityOrders
Listet Verfügbarkeitsbestellungen auf.

REST-Ressource: v1beta1.availabilityOrders.availabilityLines

Methoden
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
Kennzeichnet eine vorhandene Verfügbarkeitszeile als abgeschlossen.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
Ruft eine einzelne Zeile für einen Verfügbarkeitsauftrag ab.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
Listet Zeilen für einen Verfügbarkeitsauftrag auf.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
Kennzeichnet eine vorhandene Verfügbarkeitszeile als abgelehnt.

REST-Ressource: v1beta1.creativeAssets

Methoden
get GET /v1beta1/{name=creativeAssets/*}
Ruft ein einzelnes Creative-Asset ab.
list GET /v1beta1/creativeAssets
Listet Creative-Assets auf.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
Aktualisiert ein vorhandenes Creative-Asset.

REST-Ressource: v1beta1.orders

Methoden
get GET /v1beta1/{name=orders/*}
Ruft einen einzelnen Auftrag ab.
list GET /v1beta1/orders
Listet Aufträge auf.
patch PATCH /v1beta1/{order.name=orders/*}
Aktualisiert eine bestehende Bestellung.

REST-Ressource: v1beta1.orders.lines

Methoden
book POST /v1beta1/{name=orders/*/lines/*}:book
Bucht eine vorhandene Werbebuchung.
get GET /v1beta1/{name=orders/*/lines/*}
Ruft eine einzelne Zeile für einen Auftrag ab.
list GET /v1beta1/{parent=orders/*}/lines
Listet Zeilen für einen Auftrag auf.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
Aktualisiert eine vorhandene Linie.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
Lehnt eine vorhandene Zeile ab.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
Reserviert eine vorhandene Linie.

REST-Ressource: v1beta1.orders.lines.assignments

Methoden
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
Genehmigt eine vorhandene Aufgabe.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
Lehnt eine vorhandene Zuweisung ab.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
Ruft eine einzelne Zuweisung für eine Zeile ab.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
Listet die Zuweisungen für eine Linie auf.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
Aktualisiert eine vorhandene Aufgabe.

REST-Ressource: v1beta1.products

Methoden
create POST /v1beta1/products
Erstellt ein neues Produkt.
get GET /v1beta1/{name=products/*}
Ruft ein einzelnes Produkt ab.
list GET /v1beta1/products
Listet Produkte auf.
patch PATCH /v1beta1/{product.name=products/*}
Aktualisiert ein vorhandenes Produkt.

REST-Ressource: v1.sellers.adPlays

Methoden
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
Erstellt neue Anzeigenwiedergaben im Batch.
create POST /v1/{parent=sellers/*}/adPlays
Erstellt eine Anzeigenwiedergabe.

REST-Ressource: v1.sellers.adUnits

Methoden
create POST /v1/{parent=sellers/*}/adUnits
Erstellt einen neuen Anzeigenblock.
delete DELETE /v1/{name=sellers/*/adUnits/*}
Löscht einen vorhandenen Anzeigenblock.
get GET /v1/{name=sellers/*/adUnits/*}
Ruft einen einzelnen Anzeigenblock ab.
list GET /v1/{parent=sellers/*}/adUnits
Listet Anzeigenblöcke auf.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
Aktualisiert einen vorhandenen Anzeigenblock.

REST-Ressource: v1.sellers.adUnits.impressionSchedules

Methoden
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
Aktualisiert Impressionspläne im Batch.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Erstellt einen neuen Zeitplan für Impressionen.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
Ruft einen einzelnen Zeitplan für Impressionen ab.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Listet Zeitpläne für Impressionen auf.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
Aktualisiert einen vorhandenen Zeitplan für Impressionen.

REST-Ressource: v1.sellers.availabilityOrders

Methoden
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
Kennzeichnet einen vorhandenen Verfügbarkeitsauftrag als abgeschlossen.
get GET /v1/{name=sellers/*/availabilityOrders/*}
Ruft einen einzelnen Verfügbarkeitsauftrag ab.
list GET /v1/{parent=sellers/*}/availabilityOrders
Listet Verfügbarkeitsbestellungen auf.

REST-Ressource: v1.sellers.availabilityOrders.availabilityLines

Methoden
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
Kennzeichnet eine vorhandene Verfügbarkeitszeile als abgeschlossen.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
Ruft eine einzelne Zeile für einen Verfügbarkeitsauftrag ab.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
Listet Zeilen für einen Verfügbarkeitsauftrag auf.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
Kennzeichnet eine vorhandene Verfügbarkeitszeile als abgelehnt.

REST-Ressource: v1.sellers.creativeAssets

Methoden
get GET /v1/{name=sellers/*/creativeAssets/*}
Ruft ein einzelnes Creative-Asset ab.
list GET /v1/{parent=sellers/*}/creativeAssets
Listet Creative-Assets auf.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
Aktualisiert ein vorhandenes Creative-Asset.

REST-Ressource: v1.sellers.orders

Methoden
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
Schließt die Buchung der Bestellung ab.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
Schließt die Auftragsreservierung ab.
create POST /v1/{parent=sellers/*}/orders
Erstellt einen neuen Auftrag.
get GET /v1/{name=sellers/*/orders/*}
Ruft einen einzelnen Auftrag ab.
list GET /v1/{parent=sellers/*}/orders
Listet Aufträge auf.
patch PATCH /v1/{order.name=sellers/*/orders/*}
Aktualisiert eine bestehende Bestellung.

REST-Ressource: v1.sellers.orders.lines

Methoden
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
Bucht eine vorhandene Werbebuchung.
create POST /v1/{parent=sellers/*/orders/*}/lines
Erstellt eine neue Zeile.
get GET /v1/{name=sellers/*/orders/*/lines/*}
Ruft eine einzelne Zeile für einen Auftrag ab.
list GET /v1/{parent=sellers/*/orders/*}/lines
Listet Zeilen für einen Auftrag auf.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
Aktualisiert eine vorhandene Linie.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
Lehnt eine vorhandene Zeile ab.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
Reserviert eine vorhandene Linie.

REST-Ressource: v1.sellers.orders.lines.assignments

Methoden
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
Genehmigt eine vorhandene Aufgabe.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
Lehnt eine vorhandene Zuweisung ab.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
Ruft eine einzelne Zuweisung für eine Zeile ab.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
Listet die Zuweisungen für eine Linie auf.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
Aktualisiert eine vorhandene Aufgabe.

REST-Ressource: v1.sellers.products

Methoden
create POST /v1/{parent=sellers/*}/products
Erstellt ein neues Produkt.
delete DELETE /v1/{name=sellers/*/products/*}
Löscht ein vorhandenes Produkt.
get GET /v1/{name=sellers/*/products/*}
Ruft ein einzelnes Produkt ab.
list GET /v1/{parent=sellers/*}/products
Listet Produkte auf.
patch PATCH /v1/{product.name=sellers/*/products/*}
Aktualisiert ein vorhandenes Produkt.