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