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 ( |
Các 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 đối tác trao đổi ban đầu chỉ định. Mã nhận dạng cũ là duy nhất trong một lần trao đổi, nhưng không đảm bảo là mã 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. Sàn giao dịch nơi đơn đặt hàng được đảm bảo bắt nguồn. |
guaranteedOrderId |
Chỉ có đầu ra. Giá trị 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 là mã 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 đảm bảo đượ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 là mã 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 các nhà quảng cáo có quyền đọc đơ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 trong đơ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 gán 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 nhóm Đố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 ( |
Các trường | |
---|---|
entityStatus |
Liệu đơn đặt hàng được đảm bảo có thể phân phát được 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á tốt này. Phải là mã UTF-8 với độ dài tối đa là 100 byte. Chỉ áp dụng khi bạn đặt |
configStatus |
Chỉ có đầu ra. Trạng thái cấu hình của đơn đặt hàng được đảm bảo. Giá trị được chấp nhận là Đơn đặt hàng được đảm bảo phải được định cấu hình (đ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) trước khi đơn đặt hàng có thể phân phát. Hiện tại, bạn chỉ có thể thực hiện hành động đị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ó cho đơ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 phải đượ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 đơn đặt hàng mới được đảm bảo. |
|
Nội dung chỉnh sửa sẽ đọc thông tin về nhà quảng cáo có đơn đặt hàng được đảm bảo. |
|
Nhận đơn đặt hàng được đảm bảo. |
|
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 đảm bảo hiện có. |