Tài nguyên: Đảm bảo đơn đặt hàng
Đơn đặt hàng được đảm bảo.
Đơn đặt hàng được đảm bảo là thực thể mẹ của nguồn khoảng không quảng cáo được đảm bảo. Khi tạo nguồn khoảng không quảng cáo được đảm bảo, mã đơn hàng được đảm bảo phải được chỉ định cho nguồn khoảng không quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của đơn đặt hàng được đảm bảo. |
legacyGuaranteedOrderId |
Chỉ có đầu ra. Mã cũ của đơn đặt hàng được đảm bảo. Do nền tảng trao đổi ban đầu chỉ định. Mã cũ là duy nhất trong một sàn giao dịch nhưng không được đảm bảo là duy nhất trên tất cả các đơn đặt hàng được đảm bảo. Mã này được dùng trong SDF và giao diện người dùng. |
exchange |
Bắt buộc. Không thể thay đổi. Trao đổi nơi đơn đặt hàng được đảm bảo bắt nguồn. |
guaranteedOrderId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của đơn đặt hàng được đảm bảo. Mã đơn hàng được đảm bảo có định dạng |
displayName |
Bắt buộc. Tên hiển thị của đơn đặt hàng được đảm bảo. Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte. |
status |
Chế độ cài đặt trạng thái của đơn đặt hàng được đảm bảo. |
updateTime |
Chỉ có đầu ra. Dấu thời gian khi đơn đặt hàng được cam kết giá được cập nhật lần gần đây nhất. Do hệ thống chỉ định. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
publisherName |
Bắt buộc. Tên nhà xuất bản của đơn đặt hàng được đảm bảo. Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte. |
readAccessInherited |
Liệu tất cả các nhà quảng cáo của |
readAdvertiserIds[] |
Mã nhận dạng của nhà quảng cáo có quyền đọc đối với đơn đặt hàng được đảm bảo. Trường này không được bao gồm nhà quảng cáo được chỉ định cho |
defaultAdvertiserId |
Chỉ có đầu ra. Mã của nhà quảng cáo mặc định của đơn đặt hàng được đảm bảo. Nhà quảng cáo mặc định là |
defaultCampaignId |
Mã của chiến dịch mặc định được chỉ định cho đơn đặt hàng được đảm bảo. Chiến dịch mặc định phải thuộc về nhà quảng cáo mặc định. |
Trường hợp Đối tác hoặc nhà quảng cáo có quyền đọc/ghi đối với đơn đặt hàng được đảm bảo. |
|
readWritePartnerId |
Đối tác có quyền đọc/ghi đối với đơn đặt hàng được đảm bảo. |
readWriteAdvertiserId |
Nhà quảng cáo có quyền đọc/ghi đối với đơn đặt hàng được đảm bảo. Đây cũng là nhà quảng cáo mặc định của đơn đặt hàng được đảm bảo. |
GuaranteedOrderStatus
Chế độ cài đặt trạng thái của đơn đặt hàng được đảm bảo.
Biểu diễn dưới dạng JSON |
---|
{ "entityStatus": enum ( |
Trường | |
---|---|
entityStatus |
Đơn đặt hàng được đảm bảo có thể được phân phát hay không. Các giá trị được chấp nhận là |
entityPauseReason |
Lý do do người dùng đưa ra để tạm dừng đơn đặt hàng được cam kết giá này. Phải được mã hoá UTF-8 với độ dài tối đa là 100 byte. Chỉ áp dụng khi |
configStatus |
Chỉ có đầu ra. Trạng thái cấu hình của đơn đặt hàng được đảm bảo. Các giá trị được chấp nhận là Bạn phải định cấu hình đơn đặt hàng được đảm bảo (điền vào các trường bắt buộc, chọn mẫu quảng cáo và chọn chiến dịch mặc định) thì đơn đặt hàng đó mới có thể phân phát. Hiện tại, bạn chỉ có thể thực hiện thao tác định cấu hình thông qua giao diện người dùng. |
GuaranteedOrderConfigStatus
Các trạng thái cấu hình có thể có của đơn đặt hàng được đảm bảo.
Enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
Trạng thái phê duyệt không được chỉ định hoặc không xác định trong phiên bản này. |
PENDING |
Trạng thái bắt đầu của đơn đặt hàng được đảm bảo. Đơn đặt hàng được đảm bảo ở trạng thái này cần được định cấu hình trước khi có thể phân phát. |
COMPLETED |
Trạng thái sau khi người mua định cấu hình đơn đặt hàng được đảm bảo. |
Phương thức |
|
---|---|
|
Tạo một đơn đặt hàng mới được đảm bảo. |
|
Nội dung chỉnh sửa đọc các nhà quảng cáo của đơn đặt hàng được đảm bảo. |
|
Nhận đơn đặt hàng được cam kết giá. |
|
Liệt kê các đơn đặt hàng được đảm bảo mà người dùng hiện tại có thể truy cập. |
|
Cập nhật một đơn đặt hàng được cam kết giá hiện có. |