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 از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

مورد نیاز. نام صفحه اصلی برای ادعا. قالب: accounts/{account}/homepage

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "overwrite": boolean
}
فیلدها
overwrite

boolean

اختیاری. وقتی روی true تنظیم شود، این گزینه هرگونه ادعای موجود در وب‌سایت درخواستی را حذف می‌کند و آن را با ادعایی از حسابی که درخواست می‌کند جایگزین می‌کند.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Homepage است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.