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 不會顯示這個圖示。

拒登原因

圖示遭到拒登的可能原因。

列舉
DISAPPROVAL_REASON_UNSPECIFIED 未指定。
NOT_LIKE_SITE 圖示圖片與廣告客戶最終到達網址中的網站小圖示或圖片不符。
OFFENSIVE 圖示圖片包含令人反感的內容。
LOW_QUALITY 圖示圖片品質不佳。
ANIMATED 圖示圖片是動畫的,
BAD_BACKGROUND 圖示圖片沒有透明或非白色背景。
TEXT_TOO_SMALL 圖示圖片包含的文字過小。

方法

create

上傳新圖示並開始審查程序。

get

傳回與要求 URI 中指定的圖示資源名稱相關聯的 Icon 執行個體。

list

傳回合作夥伴帳戶的 Icon