حالات المنتجات

يمكنك استخدام مصدر productstatuses لعرض الحالة التفصيلية لمنتجاتك على Shopping.

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

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

المتطلبات

يجب اتّخاذ الإجراءات التالية للاطّلاع على حالات المنتجات:

  • تسجيل حسابك في وجهة
  • توفير رمز بلد صالح في أحد الحقول التالية:
    • حقل feedLabel
    • حقل shipping
    • على مستوى الخلاصة
    • إعدادات الشحن في حسابك

الحصول على حالة منتج

استخدِم productstatuses.get لعرض الـ حالة منتج.

يمكنك استخدام المَعلمة destinations في طلبات get وlist لعرض المشاكل في وجهة معيّنة. إذا لم تحدّد وجهة، يتم عرض المشاكل من جميع الوجهات المؤهّلة.

في ما يلي نموذج لطلب get مع مَعلمات طلب بحث اختيارية:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

تتضمّن جميع الردود من productstatuses.get الحقول التالية:

  • kind: تكون القيمة دائمًا content#productStatus.
  • creationDate: تاريخ إنشاء المنتج
  • lastUpdateDate: آخر مرة تم فيها تعديل المنتج
  • googleExpirationDate: تاريخ انتهاء صلاحية المنتج
  • productId: المعرّف بتنسيق REST للمنتج
  • title: عنوان المنتج
  • link: عنوان URL للمنتج
  • destinationStatuses: حالة المنتج في كل وجهة وبلد

لن يظهر الحقل itemLevelIssues في الردّ إلا إذا كان المنتج يعاني من مشاكل على مستوى السلعة في وقت طلبك.

في ما يلي نموذج لاستجابة JSON:

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

عرض جميع حالات المنتجات

استخدِم productstatuses.list لعرض جميع منتجاتك وحالاتها.

يمكنك استخدام المَعلمات التالية لتحسين طلب البحث:

  • destinations: الوجهة التي تريد عرض حالاتها
  • pageToken: تُستخدَم للحصول على الصفحات اللاحقة من النتائج. تحتوي كل صفحة على nextPageToken يمكنك استخدامه للحصول على الصفحة التالية في التسلسل.
  • maxResults: الحد الأقصى لعدد النتائج في كل صفحة

في ما يلي نموذج لطلب list مع مَعلمات طلب بحث اختيارية:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

في ما يلي نموذج لاستجابة JSON:

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

يمكنك اختبار طلب productstatuses.list بأمان في بيئة الإنتاج لأنّه لا يُجري أي تغييرات على بياناتك.

وجهات السفر

في ما يلي الوجهات التي يمكنك استخدامها لمنتجات Shopping:

  • shopping ads: منتجات "إعلانات Shopping"
  • ShoppingActions: منتجات "الشراء على Google"
  • surfaces across google: منتجات البيانات المجانية
  • shopping: منتجات "الإعلانات للمنتجات داخل المتجر"

المشاكل على مستوى السلعة

تتضمّن كل مشكلة على مستوى السلعة الحقول التالية:

  • code: رمز الخطأ الذي يُستخدَم لتحديد المشكلة
  • servability: يشير إلى ما إذا كان المنتج يظهر على النحو التالي:
    • disapproved: تمنع المشكلة ظهور المنتج.
    • unaffected: لا يزال المنتج يظهر.
  • resolution: يشير إلى ما إذا كان بإمكان التاجر حلّ المشكلة
  • attributeName: اسم السمة المتأثّرة
  • destination: الوجهة المتأثّرة
  • description: وصف المنتج
  • detail: معلومات إضافية حول المشكلة
  • documentation: يشير إلى المكان الذي يمكنك العثور فيه على المستندات حول المشكلة
  • applicableCountries: يشير إلى البُلدان التي تؤثّر فيها المشكلة على المنتج