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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"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

列出属于指定算法的自定义出价脚本。