تتم المطالبة بملكية الصفحة الرئيسية لمتجر. يتطلّب تنفيذ هذه الطريقة إذن وصول إداري.
إذا سبق أن تمّت المطالبة بملكية الصفحة الرئيسية، ستتم إعادة التحقّق من عملية إثبات الملكية (إلا إذا تم إعفاء التاجر من المطالبة، ما يتم إعفاء التاجر أيضًا من المطالبة) وسيتم عرض ردّ ناجح. إذا تعذّر إثبات الملكية، سيتم عرض رسالة خطأ، ولكن لن يتم محو المطالبة. في حال تعذّر إكمال العملية، ستظهر رسالة خطأ أساسية: * 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 |
مطلوب. اسم الصفحة الرئيسية المطلوب المطالبة بها تنسيق الملف: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "overwrite": boolean } |
الحقول | |
---|---|
overwrite |
اختياريّ. عند ضبط هذا الخيار على |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Homepage
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.