REST Resource: orders.lines.assignments

资源:分配

将广告素材绑定到行的分配。

JSON 表示法
{
  "name": string,
  "externalId": string,
  "creativeAsset": string,
  "state": enum (State),

  // Union field disapproval_type can be only one of the following:
  "disapproval": {
    object (Disapproval)
  },
  "adUnitDisapprovals": {
    object (AdUnitCreativeDisapprovals)
  }
  // End of list of possible types for union field disapproval_type.
}
字段
name

string

仅限输出。广告素材分配的资源名称,格式为:orders/{order_id}/lines/{line_id}/assignments/{id}

externalId

string

可选。可能是卖家在他们自己的系统中管理的 ID。一旦设置,不太可能改变。它不应在内部使用,也不会强制执行限制条件。

creativeAsset

string

仅限输出。将为该订单项投放的广告素材资源。格式 = creativeAssets/123

state

enum (State)

仅限输出。如果状态为 STATE_DISAPPROVED,则必须提供拒登详情。

联合字段 disapproval_type。仅限输出。作业的拒批详情。可以是订单项级或广告单元级。在分配或广告单元一级指定的分配拒批详情。这样,您就可以提供仅针对该行所定位的广告单元子集的拒登详情。disapproval_type 只能是下列其中一项:
disapproval

object (Disapproval)

适用于所有广告单元的分配关系的拒登详情。

adUnitDisapprovals

object (AdUnitCreativeDisapprovals)

按广告单元细分的拒登信息。

分配状态的可能值。

枚举
STATE_UNSPECIFIED 在此版本中未指定分配状态或分配状态未知时的默认值。
STATE_PENDING_REVIEW 当买方提供广告素材详情且卖方审核待处理时。
STATE_APPROVED 当广告素材获得卖方批准时。
STATE_DISAPPROVED 当广告素材被卖方拒登时。必须提供拒登详情。
STATE_REVOKED 当广告素材被买方或系统撤消时。

AdUnitCreativeDisapprovals

广告单元拒登原因。

JSON 表示法
{
  "disapprovals": {
    string: {
      object (Disapproval)
    },
    ...
  }
}
字段
disapprovals

map (key: string, value: object (Disapproval))

键为广告单元名称(例如 adUnits/123),值为拒登信息。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

方法

approve

批准现有分配。

disapprove

拒绝现有的分配。

get

检索订单项的各个分配。

list

列出线条的分配。

patch

更新现有作业。