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