يمكنك استخدام المورد
accountstatuses
للاطّلاع على حالة حسابك على Merchant Center أو
حساب متعدّد العملاء (MCA) وكل الحسابات الفرعية المرتبطة به.
يمكن للتجّار الذين يملكون عدة متاجر أو علامات تجارية على الإنترنت تُباع على مواقع إلكترونية منفصلة أن يكون لديهم حسابات فرعية ضمن حساب متعدّد العملاء.
تقع على عاتق التجّار مسؤولية الالتزام بسياسات إعلانات Shopping والبيانات المجانية. يحتفظ Google Shopping بالحق في تنفيذ هذه السياسات والاستجابة المناسبة إذا وجدنا محتوى أو سلوكًا ينتهكها.
راجِع مرجع مشاكل الحساب للحصول على تفاصيل عن المشاكل الشائعة في الحساب.
accountstatuses.get
يمكنك استخدام accountstatuses.get
لعرض معلومات حالة الحساب لحساب تاجر واحد.
يمكنك استخدام مَعلمة destination
لتحديد مشاكل المنتجات التي يتم عرضها. عندما لا يتم تحديد وجهة، يتضمّن الرد التلقائي
حالات destination: Shopping
.
في ما يلي نموذج طلب، فيه merchantId
هو رقم تعريف حساب متعدّد العملاء وaccountId
هو حساب فرعي تابع لهذا الحساب المتعدّد العملاء:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
للحصول على معلومات عن حالة الحساب لحساب مستقل، يمكنك الاتصال بالرقم accountstatuses.get
باستخدام رقم تعريف الحساب نفسه لكل من merchantId
وaccountId
.
تعرض هذه الطريقة المشاكل على مستوى الحساب والسلعة. يمكنك استخدام مراجع إعلانات Shopping والبيانات المجانية لإصلاح المشكلة accountLevelIssues
التي تظهر في الردّ من accountstatuses.get
.
إليك نموذج ردّ بشأن حساب فرعي تم تعليقه بسبب مخالفة "الصفحة المقصودة لا تعمل".
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"numItems": "5"
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"numItems": "3"
}
]
}
]
}
accountstatuses.list
يمكنك استخدام accountstatuses.list
لعرض معلومات حالة الحساب على جميع
الحسابات الفرعية للحساب المتعدّد العملاء.
يمكنك استخدام الفلاتر مع accountstatuses.list
لفلترة مشاكل المنتجات حسب
الوجهة. عند عدم تحديد وجهة، سيشمل الاستجابة حالات
destination: Shopping
.
في ما يلي نموذج طلب للحصول على معلومات حالة الحساب لجميع الحسابات الفرعية
ضمن merchantId
للحساب المتعدّد العملاء:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
إليك نموذج الرد:
{
"kind": "content#accountstatusesListResponse",
"resources": [
{
"kind": "content#accountStatus",
"accountId": "1234567",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
},
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
]
}
عند استدعاء accountstatuses.list
لحساب غير متعدّد العملاء (على سبيل المثال، حساب مستقل على Merchant Center)، يؤدي ذلك إلى عرض خطأ 403
.
في ما يلي نموذج للرد على الاتصال بالرقم accountstatuses.list
لحساب مستقل:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "forbidden",
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
],
"code": 403,
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
}
وضع الدفعة
تؤدي accountstatuses.custombatch
بطريقة GET
إلى إرجاع معلومات حالة
الحساب لحسابات فرعية متعددة في حساب متعدد العملاء.
يشتمل طلب JSON على merchantId
لرقم حساب الحساب المتعدّد العملاء، وaccountId
للحساب الفرعي، وقيمة batchId
فريدة وmethod
تم ضبطها على get
.
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
في ما يلي نموذج نص JSON لطلب:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
في ما يلي نموذج لنص استجابة JSON:
{
"kind": "content#accountstatusesCustomBatchResponse",
"entries": [
{
"batchId": 9,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1212121212",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
},
{
"batchId": 99,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1313131313",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
}
]
}
اختبار المرجع "حالات الحساب"
في المثال التالي، نحصل على حالة الحساب متعدّد العملاء (MCA) ونعرضه في قائمة وcustombatch.get
:
الحصول على حالة الحساب الفرعي لحساب متعدّد العملاء باستخدام
accountstatuses.get
يمكنك الحصول على
merchantId
وaccountId
من خلال تنفيذGET
في نقطة نهاية واجهة برمجة التطبيقات:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
من المفترَض أن تتلقّى رمز الحالة
HTTP 200
لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON.
يمكنك الاطّلاع على حالة الحساب الفرعي لحساب متعدّد العملاء باستخدام
accountstatuses.list
.عليك إجراء عملية GET إلى نقطة نهاية واجهة برمجة التطبيقات باستخدام
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
من المفترَض أن تتلقّى رمز الحالة
HTTP 200
لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON للبياناتmerchantId
التي تم إرسالها.
عرض حسابات فرعية متعددة للحساب المتعدّد العملاء في الوضع المجمّع باستخدام
accountstatuses.custombatch
يمكنك إنشاء ملف JSON صالح باستخدام الطرق
accountID
وmerchant ID
والطريقةget
.نفِّذ طلب POST على نقطة نهاية واجهة برمجة التطبيقات:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
من المفترَض أن تتلقّى رمز الحالة
HTTP 200
لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON.