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