REST Resource: guaranteedOrders

{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // Union field read_write_accessor can be only one of the following:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of list of possible types for union field read_write_accessor.
}

string

Chỉ có đầu ra. Tên tài nguyên của đơn đặt hàng được đảm bảo.

string

Chỉ có đầu ra. Mã cũ của đơn đặt hàng được đảm bảo. Do sàn giao dịch ban đầu chỉ định. Mã cũ không trùng lặp trong một sàn giao dịch nhưng chúng tôi không đảm bảo sẽ 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.

enum (Exchange)

Bắt buộc. Bất biến. Sàn giao dịch nơi bắt nguồn đơn đặt hàng được đảm bảo.

string

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 {exchange}-{legacyGuaranteedOrderId}.

string

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.

object (GuaranteedOrderStatus)

Chế độ cài đặt trạng thái của đơn đặt hàng được đảm bảo.

string (Timestamp format)

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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string

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.

boolean

Liệu tất cả các nhà quảng cáo của readWritePartnerId có quyền đọc đơn đặt hàng được đảm bảo hay không. Chỉ áp dụng nếu bạn đặt readWritePartnerId. Nếu True, sẽ ghi đè readAdvertiserIds.

string (int64 format)

Mã 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 readWriteAdvertiserId nếu đã đặt trường này. Tất cả các nhà quảng cáo trong trường này phải thuộc về readWritePartnerId hoặc cùng một đối tác với readWriteAdvertiserId.

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng 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à readWriteAdvertiserId hoặc nếu bạn chưa đặt giá trị này, thì nhà quảng cáo đầu tiên được liệt kê trong readAdvertiserIds. Nếu không, sẽ không có nhà quảng cáo mặc định.

string (int64 format)

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.

string (int64 format)

Đối tác có quyền đọc/ghi đối với đơn đặt hàng được đảm bảo.

string (int64 format)

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.

{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}

enum (EntityStatus)

Cho dù đơn đặt hàng được đảm bảo có thể phân phát hay không.

Các giá trị được chấp nhận là ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED và ENTITY_STATUS_PAUSED. Giá trị mặc định là ENTITY_STATUS_ACTIVE.

string

Lý do do người dùng đưa ra để tạm dừng đơn đặt hàng được đảm bảo này.

Phải được mã hoá UTF-8 với độ dài tối đa là 100 byte.

Chỉ áp dụng khi bạn đặt entityStatus thành ENTITY_STATUS_PAUSED.

enum (GuaranteedOrderConfigStatus)

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à PENDING và COMPLETED.

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) 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 thao tác định cấu hình thông qua giao diện người dùng.