Method: accounts.homepage.claim

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

אם כבר הוגשה תלונה על הפרת זכויות יוצרים בדף הבית, המערכת תבדוק שוב את האימות (אלא אם המוכר פטור מהגשת תלונה על הפרת זכויות יוצרים, והפטור הזה כולל גם פטור מאימות) ותחזיר תשובה על כך שהבדיקה הסתיימה בהצלחה. אם כבר לא ניתן לאמת את הבעלות, תוחזר שגיאה, אבל התלונה לא תבוטל. במקרה של כשל, תוחזר הודעת שגיאה קנוניקלית: * PERMISSION_DENIED: למשתמש אין את ההרשאות הנדרשות בחשבון MC הזה. * FAILED_PRECONDITION: - החשבון הוא לא חשבון 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.