حالة الحساب

يمكنك استخدام المورد 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:

1. الحصول على حالة الحساب الفرعي لحساب متعدّد العملاء باستخدام accountstatuses.get

   1. يمكنك الحصول على merchantId وaccountId من خلال تنفيذ GET في نقطة نهاية واجهة برمجة التطبيقات:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      

   2. من المفترَض أن تتلقّى رمز الحالة HTTP 200 لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON.

2. يمكنك الاطّلاع على حالة الحساب الفرعي لحساب متعدّد العملاء باستخدام accountstatuses.list.

   1. عليك إجراء عملية GET إلى نقطة نهاية واجهة برمجة التطبيقات باستخدام merchantId:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      

   2. من المفترَض أن تتلقّى رمز الحالة HTTP 200 لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON للبيانات merchantId التي تم إرسالها.

3. عرض حسابات فرعية متعددة للحساب المتعدّد العملاء في الوضع المجمّع باستخدام accountstatuses.custombatch

   1. يمكنك إنشاء ملف JSON صالح باستخدام الطرق accountID وmerchant ID والطريقة get.

   2. نفِّذ طلب POST على نقطة نهاية واجهة برمجة التطبيقات:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
      

   3. من المفترَض أن تتلقّى رمز الحالة HTTP 200 لتحقيق النجاح، وقائمة حالة الحساب بتنسيق JSON.