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

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