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

更新現有作業。