DV360 Out of Home Seller API

API Người bán ngoài nhà của DV360 cho phép quản lý khoảng không quảng cáo, đơn đặt hàng đặt trước, nhận mẫu quảng cáo và gửi các sự kiện phát quảng cáo.

Dịch vụ: dv360outofhomeseller.googleapis.com

Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau đây khi đưa ra yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một thông số kỹ thuật mà máy đọc được để mô tả và sử dụng các API REST. API này được dùng để xây dựng thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với các API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp các tài liệu khám phá sau:

Điểm cuối dịch vụ

Điểm cuối dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối của dịch vụ sau đây và tất cả các URI bên dưới đều liên quan đến điểm cuối của dịch vụ này:

  • https://dv360outofhomeseller.googleapis.com

Tài nguyên REST: v1beta1

Phương thức
lookupByExternalId POST /v1beta1:lookupByExternalId
Truy xuất tất cả thực thể theo mã nhận dạng bên ngoài nêu trong yêu cầu.

Tài nguyên REST: v1beta1.adPlays

Phương thức
create POST /v1beta1/adPlays
Tạo lượt phát quảng cáo.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
Tạo một lượt phát quảng cáo có các giá trị nhận dạng bên ngoài.

Tài nguyên REST: v1beta1.adUnits

Phương thức
create POST /v1beta1/adUnits
Tạo đơn vị quảng cáo mới.
delete DELETE /v1beta1/{name=adUnits/*}
Xoá đơn vị quảng cáo hiện có.
get GET /v1beta1/{name=adUnits/*}
Truy xuất một đơn vị quảng cáo riêng lẻ.
list GET /v1beta1/adUnits
Liệt kê các đơn vị quảng cáo.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
Cập nhật một đơn vị quảng cáo hiện có.

Tài nguyên REST: v1beta1.availabilityOrders

Phương thức
complete POST /v1beta1/{name=availabilityOrders/*}:complete
Đánh dấu một đơn đặt hàng hiện có là hoàn tất.
get GET /v1beta1/{name=availabilityOrders/*}
Truy xuất một đơn đặt hàng tình trạng còn hàng riêng lẻ.
list GET /v1beta1/availabilityOrders
Liệt kê các đơn đặt hàng theo tình trạng còn hàng.

Tài nguyên REST: v1beta1.availabilityOrders.availabilityLines

Phương thức
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
Đánh dấu một dòng tình trạng rảnh/bận hiện có là hoàn tất.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
Truy xuất một dòng riêng lẻ của một đơn đặt hàng tình trạng còn hàng.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
Liệt kê các dòng cho đơn đặt hàng còn hàng.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
Đánh dấu một dòng tình trạng còn hàng hiện có là bị từ chối.

Tài nguyên REST: v1beta1.creativeAssets

Phương thức
get GET /v1beta1/{name=creativeAssets/*}
Truy xuất thành phần mẫu quảng cáo riêng lẻ.
list GET /v1beta1/creativeAssets
Liệt kê các thành phần mẫu quảng cáo.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
Cập nhật một thành phần mẫu quảng cáo hiện có.

Tài nguyên REST: v1beta1.orders

Phương thức
get GET /v1beta1/{name=orders/*}
Truy xuất một đơn đặt hàng riêng lẻ.
list GET /v1beta1/orders
Liệt kê đơn đặt hàng.
patch PATCH /v1beta1/{order.name=orders/*}
Cập nhật một đơn đặt hàng hiện có.

Tài nguyên REST: v1beta1.orders.lines

Phương thức
book POST /v1beta1/{name=orders/*/lines/*}:book
Đặt một tuyến hiện có.
get GET /v1beta1/{name=orders/*/lines/*}
Truy xuất một dòng riêng lẻ cho một đơn đặt hàng.
list GET /v1beta1/{parent=orders/*}/lines
Liệt kê các dòng cho một đơn đặt hàng.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
Cập nhật một dòng hiện có.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
Từ chối một dòng hiện có.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
Đặt trước một dòng hiện có.

Tài nguyên REST: v1beta1.orders.lines.assignments

Phương thức
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
Phê duyệt một bài tập hiện có.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
Từ chối một bài tập hiện có.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
Truy xuất thao tác gán riêng lẻ cho một dòng.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
Liệt kê bài tập được giao cho một dòng.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
Cập nhật một bài tập hiện có.

Tài nguyên REST: v1beta1.products

Phương thức
create POST /v1beta1/products
Tạo sản phẩm mới.
get GET /v1beta1/{name=products/*}
Truy xuất một sản phẩm riêng lẻ.
list GET /v1beta1/products
Liệt kê sản phẩm.
patch PATCH /v1beta1/{product.name=products/*}
Cập nhật một sản phẩm hiện có.

Tài nguyên REST: v1.sellers.adPlays

Phương thức
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
Tạo hàng loạt lượt phát quảng cáo mới.
create POST /v1/{parent=sellers/*}/adPlays
Tạo lượt phát quảng cáo.

Tài nguyên REST: v1.sellers.adUnits

Phương thức
create POST /v1/{parent=sellers/*}/adUnits
Tạo đơn vị quảng cáo mới.
delete DELETE /v1/{name=sellers/*/adUnits/*}
Xoá đơn vị quảng cáo hiện có.
get GET /v1/{name=sellers/*/adUnits/*}
Truy xuất một đơn vị quảng cáo riêng lẻ.
list GET /v1/{parent=sellers/*}/adUnits
Liệt kê các đơn vị quảng cáo.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
Cập nhật một đơn vị quảng cáo hiện có.

Tài nguyên REST: v1.sellers.adUnits.impressionSchedules

Phương thức
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
Cập nhật lịch gửi lượt hiển thị theo lô.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Tạo lịch hiển thị mới.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
Truy xuất lịch biểu hiển thị riêng lẻ.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Liệt kê lịch hiển thị.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
Cập nhật lịch hiển thị hiện tại.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.availabilityOrders

Phương thức
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
Đánh dấu một đơn đặt hàng hiện có là hoàn tất.
get GET /v1/{name=sellers/*/availabilityOrders/*}
Truy xuất một đơn đặt hàng tình trạng còn hàng riêng lẻ.
list GET /v1/{parent=sellers/*}/availabilityOrders
Liệt kê các đơn đặt hàng theo tình trạng còn hàng.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.availabilityOrders.availabilityLines

Phương thức
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
Đánh dấu một dòng tình trạng rảnh/bận hiện có là hoàn tất.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
Truy xuất một dòng riêng lẻ của một đơn đặt hàng tình trạng còn hàng.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
Liệt kê các dòng cho đơn đặt hàng còn hàng.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
Đánh dấu một dòng tình trạng còn hàng hiện có là bị từ chối.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.creativeAssets

Phương thức
get GET /v1/{name=sellers/*/creativeAssets/*}
Truy xuất thành phần mẫu quảng cáo riêng lẻ.
list GET /v1/{parent=sellers/*}/creativeAssets
Liệt kê các thành phần mẫu quảng cáo.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
Cập nhật một thành phần mẫu quảng cáo hiện có.

Tài nguyên REST: v1.sellers.orders

Phương thức
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
Hoàn tất yêu cầu đặt vé.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
Hoàn tất yêu cầu đặt chỗ.
create POST /v1/{parent=sellers/*}/orders
Tạo đơn đặt hàng mới.
get GET /v1/{name=sellers/*/orders/*}
Truy xuất một đơn đặt hàng riêng lẻ.
list GET /v1/{parent=sellers/*}/orders
Liệt kê đơn đặt hàng.
patch PATCH /v1/{order.name=sellers/*/orders/*}
Cập nhật một đơn đặt hàng hiện có.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.orders.lines

Phương thức
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
Đặt một tuyến hiện có.
create POST /v1/{parent=sellers/*/orders/*}/lines
Tạo một dòng mới.
get GET /v1/{name=sellers/*/orders/*/lines/*}
Truy xuất một dòng riêng lẻ cho một đơn đặt hàng.
list GET /v1/{parent=sellers/*/orders/*}/lines
Liệt kê các dòng cho một đơn đặt hàng.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
Cập nhật một dòng hiện có.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
Từ chối một dòng hiện có.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
Đặt trước một dòng hiện có.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.orders.lines.assignments

Phương thức
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
Phê duyệt một bài tập hiện có.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
Từ chối một bài tập hiện có.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
Truy xuất thao tác gán riêng lẻ cho một dòng.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
Liệt kê bài tập được giao cho một dòng.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
Cập nhật một bài tập hiện có.

Tài nguyên Kiến trúc chuyển trạng thái đại diện (REST): v1.sellers.products

Phương thức
create POST /v1/{parent=sellers/*}/products
Tạo sản phẩm mới.
delete DELETE /v1/{name=sellers/*/products/*}
Xoá một sản phẩm hiện có.
get GET /v1/{name=sellers/*/products/*}
Truy xuất một sản phẩm riêng lẻ.
list GET /v1/{parent=sellers/*}/products
Liệt kê sản phẩm.
patch PATCH /v1/{product.name=sellers/*/products/*}
Cập nhật một sản phẩm hiện có.