حالة الحساب

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

التجّار الذين لديهم عدّة متاجر على الإنترنت أو علامات تجارية تُباع في حسابات منفصلة قد تختار المواقع الإلكترونية إنشاء حسابات فرعية ضمن حساب متعدّد العملاء.

تقع على عاتق التجّار مسؤولية الالتزام ببنود سياسة Shopping إعلانات ومجانية البيانات Google تحتفظ خدمة Shopping بالحق في فرض هذه السياسات والاستجابة لها بشكل مناسب. إذا وجدنا محتوًى أو سلوكًا يخالف هذه السياسات

الاطّلاع على مرجع مشاكل الحساب للحصول على تفاصيل عن المشاكل الشائعة في الحساب.

accountstatuses.get

يمكنك استخدام accountstatuses.get لعرض معلومات حالة الحساب حساب تاجر واحد.

يمكنك استخدام مَعلمة destination للتحكّم في المشاكل المتعلّقة بالمنتجات . إذا لم يتم تحديد وجهة، فإن الاستجابة التلقائية تتضمن حالات destination: Shopping.

في ما يلي نموذج طلب، حيث يكون merchantId هو رقم تعريف حساب متعدّد العملاء (MCA) 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 لرقم حساب الحساب متعدّد العملاء (MCA)، تم ضبط 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"
      }
     }
    ]
   }
  }
 ]
}

اختبار المرجع "حالات الحساب"

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

  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.