REST Resource: guaranteedOrders

资源：GuaranteedOrder

有保证的订单。

有保证的订单是有保证的广告资源来源的父级实体。创建有保证广告资源来源时，必须为广告资源来源分配有保证的订单 ID。

JSON 表示法 
{
  "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.
}
字段
name

string

仅限输出。有保证订单的资源名称。
legacyGuaranteedOrderId

string

仅限输出。保证订单的旧版 ID。由原始广告交易平台分配。旧版 ID 在一个广告交易平台中是唯一的，但不能保证在所有有保证订单中都是唯一的。此 ID 在 SDF 和界面中使用。
exchange

enum (Exchange)

必需。不可变。有保证订单的来源广告交易平台。
guaranteedOrderId

string

仅限输出。有保证订单的唯一标识符。有保证的订单 ID 采用 {exchange}-{legacyGuaranteedOrderId} 格式。
displayName

string

必需。有保证订单的显示名称。

必须采用 UTF-8 编码，大小不得超过 240 字节。
status

object (GuaranteedOrderStatus)

有保证订单的状态设置。
updateTime

string (Timestamp format)

仅限输出。上次更新有保证订单时的时间戳。由系统分配。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
publisherName

string

必需。有保证订单的发布商名称。

必须采用 UTF-8 编码，大小不得超过 240 字节。
readAccessInherited

boolean

readWritePartnerId 的所有广告客户是否对有保证订单拥有读取权限。仅在已设置 readWritePartnerId 的情况下适用。如果为 True，则替换 readAdvertiserIds。
readAdvertiserIds[]

string (int64 format)

对有保证订单拥有读取权限的广告客户的 ID。

此字段不得包含分配给 readWriteAdvertiserId 的广告客户（如果已设置）。此字段中的所有广告客户都必须属于 readWritePartnerId，或者与 readWriteAdvertiserId 属于同一合作伙伴。
defaultAdvertiserId

string (int64 format)

仅限输出。有保证订单的默认广告客户的 ID。

默认广告客户是 readWriteAdvertiserId，如果未设置，则为 readAdvertiserIds 中列出的第一个广告客户。否则，系统不会设置默认广告客户。
defaultCampaignId

string (int64 format)

分配给保证订单的默认广告系列的 ID。

默认广告系列必须属于默认广告客户。

联合字段 read_write_accessor。必填。

对有保证订单拥有读写权限的合作伙伴或广告客户。read_write_accessor 只能是下列其中一项：
readWritePartnerId

string (int64 format)

对有保证的订单拥有读写权限的合作伙伴。
readWriteAdvertiserId

string (int64 format)

对保证订单拥有读写权限的广告客户。这也是有保证订单的默认广告客户。

GuaranteedOrderStatus

有保证订单的状态设置。

JSON 表示法 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
字段
entityStatus

enum (EntityStatus)

有保证的订单是否可投放。

可接受的值包括 ENTITY_STATUS_ACTIVE、ENTITY_STATUS_ARCHIVED 和 ENTITY_STATUS_PAUSED。默认值为 ENTITY_STATUS_ACTIVE。
entityPauseReason

string

用户提供的暂停此保证订单的原因。

必须采用 UTF-8 编码，长度不得超过 100 字节。

仅在 entityStatus 设置为 ENTITY_STATUS_PAUSED 时适用。
configStatus

enum (GuaranteedOrderConfigStatus)

仅限输出。有保证订单的配置状态。

可接受的值为 PENDING 和 COMPLETED。

必须先配置（填写必填字段、选择广告素材并选择默认广告系列）有保证订单，然后相应订单才能投放。目前，配置操作只能通过界面执行。

GuaranteedOrderConfigStatus

有保证订单的可能配置状态。

枚举
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED 此版本未指定审批状态或审批状态未知。
PENDING 有保证订单的开始状态。处于此状态的有保证订单需要先进行配置，然后才能投放。
COMPLETED 买方配置有保证订单后的状态。

方法

create

 创建新的有保证订单。

editGuaranteedOrderReadAccessors

 修改有保证订单的广告客户的读取权限。

get

 获取有保证订单。

list

 列出当前用户可以访问的有保证订单。

patch

 更新现有有保证订单。