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.