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)

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

使用 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"。
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

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