תביעה לבעלות על דף הבית של חנות. כדי להריץ את השיטה הזו נדרשת הרשאת אדמין.
אם כבר הוגשה תלונה על הפרת זכויות יוצרים בדף הבית, המערכת תבדוק שוב את האימות (אלא אם המוכר פטור מהגשת תלונה על הפרת זכויות יוצרים, והפטור הזה כולל גם פטור מאימות) ותחזיר תשובה על כך שהבדיקה הסתיימה בהצלחה. אם כבר לא ניתן לאמת את הבעלות, תוחזר שגיאה, אבל התלונה לא תבוטל. במקרה של כשל, תוחזר הודעת שגיאה קנוניקלית: * PERMISSION_DENIED: למשתמש אין את ההרשאות הנדרשות בחשבון MC הזה. * FAILED_PRECONDITION: - החשבון הוא לא חשבון Merchant Center. - לחשבון MC אין דף בית. - הבקשה נכשלה (במקרה כזה, הודעת השגיאה תכלול פרטים נוספים).
בקשת HTTP
POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
חובה. השם של דף הבית שרוצים לטעון בעלות עליו. פורמט: |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "overwrite": boolean } |
שדות | |
---|---|
overwrite |
זה שינוי אופציונלי. כשהאפשרות הזו מוגדרת כ- |
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Homepage
.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/content
למידע נוסף, ראו סקירה כללית על OAuth 2.0.