يمكنك استخدام المرجع 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
: منتجات إعلانات ShoppingShoppingActions
: الشراء على منتجات Googlesurfaces across google
: المنتجات الواردة في البيانات المجانيةshopping
: منتجات الإعلانات للمنتجات داخل المتجر
المشاكل على مستوى السلع
تتضمّن كل مشكلة على مستوى السلعة الحقول التالية:
code
: رمز الخطأ المستخدَم لتحديد المشكلةservability
: تشير هذه السمة إلى ما إذا كان المنتج يظهر على النحو التالي:disapproved
: المشكلة تمنع عرض المنتج.unaffected
: لا يزال المنتج معروضًا.
resolution
: يشير إلى ما إذا كان بإمكان التاجر حلّ المشكلة.attributeName
: اسم السمة المتأثرة.destination
: الوجهة المتأثرةdescription
: وصف المنتجdetail
: تقدّم هذه السمة معلومات إضافية عن المشكلة.documentation
: تشير إلى مكان العثور على المستندات المتعلّقة بالمشكلة.applicableCountries
: تشير هذه السمة إلى البلدان التي تؤثّر فيها المشكلة في المنتج.