REST Resource: customBiddingAlgorithms.scripts

資源：CustomBiddingScript

單一自訂出價指令碼。

JSON 表示法 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "customBiddingScriptId": string,
  "createTime": string,
  "active": boolean,
  "state": enum (State),
  "errors": [
    {
      object (ScriptError)
    }
  ],
  "script": {
    object (CustomBiddingScriptRef)
  }
}
欄位
name

string

僅供輸出。自訂出價指令碼的資源名稱。
customBiddingAlgorithmId

string (int64 format)

僅供輸出。指令碼所屬的自訂出價演算法專屬 ID。
customBiddingScriptId

string (int64 format)

僅供輸出。自訂出價指令碼的專屬 ID。
createTime

string (Timestamp format)

僅供輸出。指令碼的建立時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
active

boolean

僅供輸出。是否由父項演算法使用指令碼評分。
state

enum (State)

僅供輸出。自訂出價指令碼的狀態。
errors[]

object (ScriptError)

僅供輸出。遭拒的自訂出價指令碼錯誤詳細資料。只有在 state 為 REJECTED 時，才會填入這個欄位。
script

object (CustomBiddingScriptRef)

已上傳指令碼檔案的參照。

狀態

自訂出價指令碼的可能狀態。

列舉
STATE_UNSPECIFIED 尚未指定指令碼狀態，或在這個版本中無法辨識指令碼狀態。
ACCEPTED 系統已接受指令碼計算曝光評分。
REJECTED 後端管道已拒絕指令碼。可能發生錯誤。
PENDING 系統正在處理指令碼，以便用於後端管道。

ScriptError

自訂出價指令碼的錯誤訊息。

JSON 表示法 
{
  "errorCode": enum (ErrorCode),
  "line": string,
  "column": string,
  "errorMessage": string
}
欄位
errorCode

enum (ErrorCode)

錯誤類型。
line

string (int64 format)

指令碼中擲回錯誤的行號。
column

string (int64 format)

指令碼中擲回錯誤的欄號。
errorMessage

string

詳細的錯誤訊息。

ErrorCode

自訂出價指令碼錯誤的可能錯誤代碼。

列舉
ERROR_CODE_UNSPECIFIED 未指定指令碼錯誤，或在這個版本中不知道指令碼錯誤。
SYNTAX_ERROR 指令碼語法有誤。
DEPRECATED_SYNTAX 指令碼使用已淘汰的語法。
INTERNAL_ERROR 處理指令碼時發生內部錯誤。

CustomBiddingScriptRef

所上傳自訂出價指令碼檔案的參照。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

在 media.download 中用於下載指令碼檔案的資源名稱。或使用 media.upload 上傳指令碼檔案。資源名稱的格式為 customBiddingAlgorithms/{customBiddingAlgorithmId}/scriptRef/{ref_id}。

方法

create

 建立新的自訂出價指令碼。

get

 取得自訂出價指令碼。

list

 列出屬於指定演算法的自訂出價指令碼。