REST Resource: accounts.icons

资源:图标

合作伙伴图标的相关信息。

JSON 表示法
{
  "name": string,
  "imageData": string,
  "state": enum (State),
  "iconUri": string,
  "reference": string,
  "disapprovalReason": enum (DisapprovalReason)
}
字段
name

string

必需。图标的资源名称,格式为 accounts/{account_id}/icons/{icon_id}。使用 icon_id,通过 accounts.brands API 将图标与品牌相关联。

imageData

string (bytes format)

必需。仅限输入。图标内容,必须采用 PNG 格式或可转换为 PNG。

使用 base64 编码的字符串。

state

enum (State)

仅供输出。图标的当前状态。

iconUri

string

仅供输出。已获批准的图标由 Google 托管的 URI。仅适用于状态为 APPROVED 的图标。

reference

string

(可选)用于跟踪图标的值。它可能是系统中图标的主键,也可能是图标的文件名。Google 不会使用此值。

disapprovalReason

enum (DisapprovalReason)

仅供输出。图标遭拒原因。仅适用于状态为 REJECTED 的图标。

状态

可能的图标状态。

枚举
STATE_UNSPECIFIED 默认值。
NEW Google 已收到该图标,正在审核其内容。
APPROVED 此图标已获批准,可以公开展示。您可以将已获批准的图标与品牌相关联。
REJECTED 图标遭拒。Google 不会显示此图标。

DisapprovalReason

图标被拒登的可能原因。

枚举
DISAPPROVAL_REASON_UNSPECIFIED 未指定。
NOT_LIKE_SITE 图标图片与广告客户的最终到达网址上的网站图标或图片不匹配。
OFFENSIVE 图标图片包含令人反感的内容。
LOW_QUALITY 图标图片画质低。
ANIMATED 图标图片采用动画形式。
BAD_BACKGROUND 图标图片没有透明或白色背景。
TEXT_TOO_SMALL 图标图片包含的文字过小。

方法

create

上传新图标并开始审核流程。

get

返回与请求 URI 中指定的图标资源名称相关联的 Icon 实例。

list

返回合作伙伴帐号的 Icon