Method: accounts.homepage.claim

• طلب HTTP
• مَعلمات المسار
• نص الطلب
  • تمثيل JSON
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

يُستخدَم للمطالبة بالصفحة الرئيسية لمتجر. يتطلّب تنفيذ هذه الطريقة إذن وصول المشرف.

إذا سبق أن تمّت المطالبة بالموقع الإلكتروني الرئيسي، ستتم إعادة التحقّق من عملية إثبات الهوية (ما لم يكن التاجر معفىً من المطالبة بالموقع الإلكتروني، ما يُعفيه أيضًا من إثبات الهوية) وسيتم عرض رسالة تأكيد. إذا تعذّر إثبات الملكية، ستظهر رسالة خطأ، ولكن لن يتمّ إلغاء المطالبة. في حال تعذّر إكمال العملية، ستظهر رسالة خطأ أساسية: * PERMISSION_DENIED: لا يملك المستخدم الأذونات اللازمة في حساب Merchant Center هذا. * FAILED_PRECONDITION: - الحساب ليس حسابًا على Merchant Center. - لا يتضمّن حساب Merchant Center صفحة رئيسية. - تعذّر المطالبة (في هذه الحالة، ستتضمّن رسالة الخطأ المزيد من التفاصيل).

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name	string مطلوب. اسم الصفحة الرئيسية المطلوب المطالبة بها التنسيق: accounts/{account}/homepage

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{ "overwrite": boolean }

الحقول
overwrite	boolean اختيارية: عند ضبط هذا الخيار على true، يزيل هذا الخيار أي مطالبة حالية على الموقع الإلكتروني المطلوب ويستبدلها بمطالبات من الحساب الذي يقدّم الطلب.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Homepage.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.