Method: accounts.homepage.claim

תביעה לבעלות על דף הבית של חנות. כדי להפעיל את השיטה הזו נדרשת הרשאת אדמין.

אם כבר נתבעה בעלות על דף הבית, המערכת תבדוק שוב את האימות (אלא אם למוכר פטור מתביעת בעלות, שגם הוא פטור מאימות) ותחזיר תשובה מוצלחת. אם כבר לא ניתן לאמת את הבעלות, תוחזר שגיאה, אבל התלונה לא תבוטל. במקרה של כשל, תוחזר הודעת שגיאה קנונית: * permission_DENIED: למשתמש אין את ההרשאות הנדרשות בחשבון MC הזה; * FAILED_PRE conditions: - החשבון אינו חשבון Merchant Center; - לחשבון MC אין דף בית. - התביעה נכשלה (במקרה זה, הודעת השגיאה תכלול פרטים נוספים).

בקשת HTTP

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. השם של דף הבית שעליו רוצים לתבוע בעלות. פורמט: accounts/{account}/homepage

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "overwrite": boolean
}
שדות
overwrite

boolean

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

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Homepage.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.