حالة الحساب

يمكنك استخدام المرجع accountstatuses للاطّلاع على حالة حسابك على Merchant Center أو حساب متعدّد العملاء (MCA) وكل الحسابات الفرعية المرتبطة به.

بالنسبة إلى التجّار الذين يملكون متاجر أو علامات تجارية متعددة على الإنترنت يتم بيعها على مواقع إلكترونية منفصلة، يمكنهم اختيار امتلاك حسابات فرعية ضمن حساب متعدّد العملاء (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.

في ما يلي نموذج طلب للحصول على معلومات حالة الحساب لجميع الحسابات الفرعية ضمن حساب MCA 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 لحساب غير تابع لخدمة MCA (مثل حساب مستقل على 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"
      }
     }
    ]
   }
  }
 ]
}

اختبار المورد Account Statuses (حالات الحساب)

في المثال التالي، نحصل على حالة حساب MCA وإدراجها وإدراجها في custombatch.get:

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

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

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

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

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

   1. نفِّذ GET إلى نقطة نهاية واجهة برمجة التطبيقات باستخدام merchantId:

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

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

3. يمكنك الاطّلاع على حسابات فرعية متعدّدة لحساب MCA في وضع الدُفعة باستخدام accountstatuses.custombatch.

   1. أنشِئ ملف JSON صالحًا باستخدام accountID وmerchant ID وطريقة get.

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

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

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