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

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

راجِع مشاكل المنتجات للحصول على تفاصيل حول المشاكل الشائعة.

تقع على عاتق التجّار مسؤولية الالتزام بسياسات إعلانات Shopping والبيانات المجانية. تحتفظ خدمة 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: يشير إلى البلدان التي تؤثر فيها المشكلة في المنتج.