REST Resource: accounts.brands

משאב: מותג

הגדרה של סמל ושם לתצוגה ברמת המותג. אחרי האישור, הסמל והשם לתצוגה יופיעו בתוצאות החיפוש של נכסים שהשותף הקצה למותג הזה.

ייצוג ב-JSON 
{
  "name": string,
  "displayNames": [
    {
      object (LocalizedText)
    }
  ],
  "submittedDisplayNames": [
    {
      object (LocalizedText)
    }
  ],
  "activeDisplayNames": [
    {
      object (LocalizedText)
    }
  ],
  "displayNameState": enum (ReviewState),
  "displayNameDisapprovalReason": [
    {
      object (DisplayNameDisapprovalReason)
    }
  ],
  "icon": string,
  "submittedIcon": string,
  "activeIcon": string,
  "activeIconUri": string,
  "iconState": enum (ReviewState),
  "iconDisapprovalReasons": [
    enum (ImageDisapprovalReason)
  ],
  "propertyCount": string
}
שדות
name

string

פלט בלבד. שם המשאב של המותג בפורמט accounts/{account_id}/brands/{brandId}. הערך brandId תואם למזהה המותג של השותף שמשמש להתאמת דף הנחיתה ולמזהה המותג ברמת הנכס.

מותג ברירת מחדל מוחל על נכסים שלא משויך להם מותג. ה-brandId של המותג שמוגדר כברירת מחדל הוא NO_BRAND_ID. אפשר לאחזר ולעדכן אותו כמו כל מותג מוגדר.
displayNames[]

object (LocalizedText)

קלט בלבד. השם שמוצג ב-Google עבור הנכסים של המותג. הגדרת השמות המוצגים נדרשת רק אם רוצים לבטל את השם המוצג של דף הנחיתה או את השם המוצג ברמת החשבון של המותג. ‫Google בודקת את השמות המוצגים כדי לוודא שהתוכן מתאים. אם יש כמה שפות, Google תציג את השמות לתצוגה רק אחרי שתאשר את כל השפות.
submittedDisplayNames[]

object (LocalizedText)

פלט בלבד. השמות המוצגים של המותג שנשלחו בכל השפות שצוינו, מופיעים רק אם השם המוצג חדש או נדחה בשפה כלשהי.
activeDisplayNames[]

object (LocalizedText)

פלט בלבד. השמות המוצגים הפעילים של המותג בכל השפות שצוינו. השדה הזה מופיע רק אם השם המוצג אושר בכל השפות שצוינו.
displayNameState

enum (ReviewState)

פלט בלבד. מצב הבדיקה של השמות המוצגים של המותג, שרלוונטי לכל השמות המוצגים בשפות שונות. אם יש שמות מוצגים שנשלחו ושמות מוצגים פעילים, הכוונה היא לשמות המוצגים שנשלחו.
displayNameDisapprovalReason[]

object (DisplayNameDisapprovalReason)

פלט בלבד. הסיבה לפסילה של השם המוצג. ההגדרה הזו חלה רק על שמות מוצגים עם סטטוס הביקורת 'נדחה'.
icon

string

קלט בלבד. accounts.icon של המותג, שמזהה את הסמל של המותג. הערך מתייחס לשם המשאב של הסמל בפורמט accounts/{account_id}/icons/{icon_id}.
submittedIcon

string

פלט בלבד. accounts.icon שהמותג שלח. הערך מתייחס לשם המשאב של הסמל בפורמט accounts/{account_id}/icons/{icon_id}. סמל שנשלח הוא סמל חדש או סמל שנדחה.
activeIcon

string

פלט בלבד. accounts.icon. הערך מתייחס לשם המשאב של הסמל בפורמט accounts/{account_id}/icons/{icon_id}. סמל פעיל הוא סמל שאושר.
activeIconUri

string

פלט בלבד. כתובת ה-URL של הסמל הפעיל, מופיעה רק כשהסמל אושר.
iconState

enum (ReviewState)

פלט בלבד. מצב הבדיקה של סמל המותג. אם מוצגים גם סמל שנשלח וגם סמל פעיל, הכוונה היא לסמל שנשלח.
iconDisapprovalReasons[]

enum (ImageDisapprovalReason)

פלט בלבד. הסיבות לפסילה של הסמל. ההגדרה חלה רק על סמלים שנשלחו עם סטטוס REJECTED.
propertyCount

string (int64 format)

פלט בלבד. מספר הנכסים עם מזהה המותג המתאים.

ReviewState

מצבי הבדיקה האפשריים של הסמל או השם המוצג המשויכים.

טיפוסים בני מנייה (enum)
REVIEW_STATE_UNSPECIFIED ערך ברירת המחדל.
REVIEW_STATE_NEW ‫Google בודקת את הסמל או את השם לתצוגה.
APPROVED הסמל או השם המוצג אושרו ומוכנים להצגה לציבור.
REJECTED הסמל או השם לתצוגה נדחים. ‫Google לא תציג אותו.

DisplayNameDisapprovalReason

הסיבה לדחיית השם המוצג בשפה מסוימת.

ייצוג ב-JSON 
{
  "languageCode": string,
  "disapprovalReason": enum (DisapprovalReason)
}
שדות
languageCode

string

השפה של השם לתצוגה שנפסל.
disapprovalReason

enum (DisapprovalReason)

הסיבה לדחייה.

DisapprovalReason

סיבות אפשריות לכך ששם לתצוגה לא אושר.

טיפוסים בני מנייה (enum)
DISAPPROVAL_REASON_UNSPECIFIED לא צוין.
PUNCTUATION הפורמט של השם המוצג לא תקין או שהוא מכיל סימני פיסוק.
MARKETING_LANGUAGE השם לתצוגה מכיל שפה שיווקית.
LANDING_PAGE_NOT_MATCHED השם לתצוגה לא תואם לדף הנחיתה.
NOT_BRAND_NAME נראה שהשם לתצוגה לא מייצג מותג.

Methods

create

 יצירת מותג חדש.

get

 הפונקציה מחזירה את מופע Brand שמשויך לשם משאב המותג של ה-URI של הבקשה.

list

 מחזירה את המותגים של חשבון שותף.

patch

 עדכון של מותג.