- منبع: CssProduct
- مشخصهها
- قیمت
- ProductDetail
- ProductWeight
- ProductDimension
- گواهی
- HeadlineOfferInstallment
- HeadlineOfferSubscriptionCost
- SubscriptionPeriod
- CustomAttribute
- CssProductStatus
- DestinationStatus
- ItemLevelIssue
- روشها
منبع: CssProduct
«محصول سرویس مقایسه قیمت» پردازششده.
| نمایش JSON |
|---|
{ "name": string, "rawProvidedId": string, "contentLanguage": string, "feedLabel": string, "attributes": { object ( |
| فیلدها | |
|---|---|
name |
نام «محصول CSS». قالب: |
rawProvidedId |
فقط خروجی. شناسه خام یکتای شما برای محصول. |
contentLanguage |
فقط خروجی. کد زبان دوحرفی ISO 639-1 برای محصول. |
feedLabel |
فقط خروجی. برچسب فید برای محصول. |
attributes |
فقط خروجی. فهرستی از مشخصههای محصول. |
customAttributes[] |
فقط خروجی. فهرستی از مشخصههای سفارشی (ارائهشده توسط CSS). همچنین میتوان از آن برای ارسال هر مشخصه از مشخصات فید در شکل عمومی آن (برای مثال، |
cssProductStatus |
فقط خروجی. وضعیت محصول، مشکلات اعتبارسنجی دادهها، یعنی اطلاعات مربوط به محصولی که بهصورت ناهمگام محاسبه شده است. |
مشخصهها
مشخصههای محصول CSS.
| نمایش JSON |
|---|
{ "lowPrice": { object ( |
| فیلدها | |
|---|---|
lowPrice |
قیمت پایین محصول «سرویس مقایسه قیمت». |
highPrice |
قیمت بالای محصول CSS. |
headlineOfferPrice |
قیمت عنوان محصول CSS. |
headlineOfferShippingPrice |
قیمت عنوان محصول CSS. |
additionalImageLinks[] |
نشانی وب اضافی تصاویر محصول. |
productTypes[] |
دستههای مورد (قالببندیشده مانند مشخصات دادههای محصولات). |
sizeTypes[] |
برش مورد. میتوان از آن برای نشان دادن انواع اندازه ترکیبی برای اقلام پوشاک استفاده کرد. حداکثر دو نوع اندازه را میتوان ارائه کرد (نوع اندازه را ببینید. |
productDetails[] |
مشخصات فنی یا جزئیات بیشتر محصول. |
productWeight |
وزن محصول در واحدهای ارائهشده. مقدار باید بین ۰ (غیرشامل) و ۲۰۰۰ (شامل) باشد. |
productLength |
طول محصول برحسب واحدهای ارائهشده. مقدار باید بین ۰ (غیرشامل) و ۳۰۰۰ (شامل) باشد. |
productWidth |
عرض محصول در واحدهای ارائهشده. مقدار باید بین ۰ (غیرشامل) و ۳۰۰۰ (شامل) باشد. |
productHeight |
ارتفاع محصول در واحدهای ارائهشده. مقدار باید بین ۰ (غیرشامل) و ۳۰۰۰ (شامل) باشد. |
productHighlights[] |
نکتههای مهمی که مرتبطترین ویژگیهای اصلی محصول را توصیف میکند. |
certifications[] |
فهرستی از گواهینامههایی که «سرویس مقایسه قیمت» برای محصول موردنظر ادعا کرده است. |
expirationDate |
تاریخی که مورد باید منقضی شود، همانطور که هنگام درج مشخص شده است، در قالب ISO 8601. تاریخ انقضای واقعی در |
includedDestinations[] |
فهرست مقصدهایی که باید برای این هدف گنجانده شود (مطابق با چارگوشهای انتخاب علامتزدهشده در Merchant Center). مقصدهای پیشفرض همیشه گنجانده میشوند مگراینکه در مقادیر پشتیبانیشده عبارتاند از: - |
excludedDestinations[] |
فهرست مقصدهایی که باید برای این هدف کنار گذاشته شوند (مطابق با چارگوشهای انتخاب علامتنزده در Merchant Center). مقادیر پشتیبانیشده عبارتاند از: - |
headlineOfferInstallment |
تعداد و مبلغ اقساط برای پرداخت هزینه محصول. |
headlineOfferSubscriptionCost |
تعداد دورهها (ماه یا سال) و مبلغ پرداخت در هر دوره برای موردی که قرارداد اشتراک مرتبط دارد. |
cppLink |
نشانی وبی که مستقیماً به «صفحه جزئیات محصول» «سرویس مقایسه قیمت» پیوند میدهد. |
cppMobileLink |
نشانی وب برای نسخه بهینهسازیشده برای تلفن همراه «صفحه جزئیات محصول» «سرویس مقایسه قیمت». |
cppAdsRedirect |
به تبلیغکنندگان اجازه میدهد وقتی محصول در بافت «آگهیهای محصول» نشان داده میشود، نشانی وب مورد را لغو کنند. |
numberOfOffers |
تعداد محصولات CSS. |
headlineOfferCondition |
وضعیت پیشنهاد ویژه سرخط. |
headlineOfferLink |
پیوند به پیشنهاد ویژه سرخط. |
headlineOfferMobileLink |
پیوند تلفن همراه به پیشنهاد ویژه سرخط. |
title |
عنوان مورد. |
imageLink |
نشانی وب تصویر مورد. |
description |
شرح مورد. |
brand |
مشخصههای مرتبط با محصول.[14-36] نمانام مورد. |
mpn |
شماره قطعه سازنده (MPN) محصول. |
gtin |
«شماره جهانی محصول تجاری» (GTIN) کالا. |
googleProductCategory |
دسته Google برای کالا (طبقهبندی محصول Google را ببینید). هنگام جستجوی محصولات، این فیلد حاوی مقدار ارائهشده توسط کاربر خواهد بود. درحالحاضر هیچ راهی برای بازگرداندن دستههای محصول Google که بهطور خودکار اختصاص داده شدهاند ازطریق API وجود ندارد. |
adult |
اگر مورد برای بزرگسالان هدفیابی شده است، روی «درست» تنظیم کنید. |
multipack |
تعداد محصولات یکسان در بسته چندتایی تعیینشده توسط فروشنده. |
isBundle |
اینکه کالا بسته تعریفشده توسط فروشنده است یا نه. بسته عبارت است از گروهبندی سفارشی محصولات مختلف که توسط فروشنده با یک قیمت فروخته میشود. |
ageGroup |
گروه سنی هدف محصول. |
color |
رنگ مورد. |
gender |
جنسیت هدف مورد. |
material |
مادهای که مورد از آن ساخته شده است. |
pattern |
الگوی مورد (مثلاً خالخالی). |
size |
اندازه مورد. فقط یک مقدار مجاز است. برای انواع مختلف با اندازههای متفاوت، محصول جداگانهای برای هر اندازه با مقدار |
sizeSystem |
سیستمی که اندازه در آن مشخص شده است. برای اقلام پوشاک توصیه میشود. |
itemGroupId |
شناسه مشترک برای همه گونههای یک محصول. |
pause |
انتشار این مورد موقتاً متوقف خواهد شد. |
customLabel0 |
برچسب سفارشی ۰ برای گروهبندی سفارشی موارد در پویش Shopping. |
customLabel1 |
برچسب سفارشی ۱ برای گروهبندی سفارشی موارد در پویش Shopping. |
customLabel2 |
برچسب سفارشی ۲ برای گروهبندی سفارشی موارد در پویش Shopping. |
customLabel3 |
برچسب سفارشی ۳ برای گروهبندی سفارشی موارد در پویش Shopping. |
customLabel4 |
برچسب سفارشی ۴ برای گروهبندی سفارشی موارد در پویش Shopping. |
reviewCount |
تعداد مرورهای محصول. اگر |
minRating |
حداقل امتیاز ردهبندی محصول. اگر |
maxRating |
حداکثر امتیاز ردهبندی محصول. اگر |
rating |
میانگین امتیاز ردهبندی محصول. مقدار باید در محدوده [ |
قیمت
قیمت بهصورت عدد و واحد پول نشان داده میشود.
| نمایش JSON |
|---|
{ "amountMicros": string, "currencyCode": string } |
| فیلدها | |
|---|---|
amountMicros |
قیمت بهصورت عددی در میکرو نشان داده میشود (۱ میلیون میکرو معادل یک واحد استاندارد ارز است، برای مثال، ۱ دلار امریکا = ۱۰۰۰۰۰۰ میکرو). |
currencyCode |
واحد پول قیمت بااستفاده از سرواژه سهحرفی مطابق با ISO 4217. |
ProductDetail
جزئیات محصول.
| نمایش JSON |
|---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
| فیلدها | |
|---|---|
sectionName |
سرصفحه بخش که برای گروهبندی مجموعهای از جزئیات محصول استفاده میشود. |
attributeName |
نام جزئیات محصول. |
attributeValue |
مقدار جزئیات محصول. |
ProductWeight
وزن محصول.
| نمایش JSON |
|---|
{ "value": number, "unit": string } |
| فیلدها | |
|---|---|
value |
الزامی. وزن بهصورت عدد نشان داده میشود. وزن میتواند حداکثر چهار رقم اعشار داشته باشد. |
unit |
الزامی. واحد وزن. مقادیر پذیرفتنی عبارتاند از: * « |
ProductDimension
ابعاد محصول.
| نمایش JSON |
|---|
{ "value": number, "unit": string } |
| فیلدها | |
|---|---|
value |
الزامی. مقدار بُعد که بهصورت عدد نشان داده میشود. این مقدار میتواند حداکثر چهار رقم اعشار داشته باشد. |
unit |
الزامی. واحدهای ابعاد. مقادیر پذیرفتنی عبارتاند از: * « |
گواهی
گواهینامه محصول. از این مشخصه برای توصیف گواهینامههای مرتبط با محصول، مانند ردهبندیهای بهرهوری انرژی، استفاده کنید.
| نمایش JSON |
|---|
{ "name": string, "authority": string, "code": string } |
| فیلدها | |
|---|---|
name |
نام گواهینامه. درحالحاضر، رایجترین مقدار «EPREL» است که نشاندهنده گواهینامههای بازده انرژی در پایگاه داده «اداره ثبت محصول اروپایی ازنظر برچسب انرژی» (EPREL) در اتحادیه اروپا است. |
authority |
مرجع یا نهاد ارائهدهنده گواهینامه که مسئول صدور گواهینامه است. درحالحاضر، رایجترین مقدار برای برچسبهای انرژی در اتحادیه اروپا «EC» یا «European_Commission» است. |
code |
کد گواهینامه. برای مثال، برای گواهی EPREL با پیوند https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456، کد 123456 است. این کد برای «برچسبهای انرژی اروپا» الزامی است. |
HeadlineOfferInstallment
پیامی که نشاندهنده قسط است.
| نمایش JSON |
|---|
{ "months": string, "amount": { object ( |
| فیلدها | |
|---|---|
months |
تعداد قسطهایی که خریدار باید پرداخت کند. |
amount |
مبلغی که خریدار باید در ماه پرداخت کند. |
downpayment |
مبلغ پیشپرداخت نقدی که خریدار باید بپردازد. |
HeadlineOfferSubscriptionCost
SubscriptionCost محصول.
| نمایش JSON |
|---|
{ "period": enum ( |
| فیلدها | |
|---|---|
period |
نوع دوره اشتراک. مقادیر پشتیبانیشده: * « |
periodLength |
تعداد دورههای اشتراکی که خریدار باید پرداخت کند. |
amount |
مبلغی که خریدار باید بهازای هر دوره اشتراک پرداخت کند. |
SubscriptionPeriod
دوره اشتراک محصول.
| شمارشیها | |
|---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
نشان میدهد که دوره اشتراک نامشخص است. |
MONTH |
نشان میدهد که دوره اشتراک ماهانه است. |
YEAR |
نشان میدهد که دوره اشتراک سالانه است. |
CustomAttribute
پیامی که مشخصههای سفارشی را نشان میدهد. دقیقاً یکی از value یا groupValues نباید خالی باشد.
| نمایش JSON |
|---|
{
"groupValues": [
{
object ( |
| فیلدها | |
|---|---|
groupValues[] |
زیرمشخصههای موجود در این گروه مشخصه. اگر |
name |
نام مشخصه. |
value |
مقدار مشخصه. اگر |
CssProductStatus
وضعیت «محصول سرویس مقایسه قیمت»، مشکلات اعتبارسنجی دادهها، یعنی اطلاعات مربوط به «محصول سرویس مقایسه قیمت» که بهصورت ناهمگام محاسبه شده است.
| نمایش JSON |
|---|
{ "destinationStatuses": [ { object ( |
| فیلدها | |
|---|---|
destinationStatuses[] |
مقصدهای موردنظر برای محصول. |
itemLevelIssues[] |
فهرستی از همه مشکلات مرتبط با محصول. |
creationDate |
تاریخی که مورد در آن ایجاد شده است، در قالب ISO 8601. |
lastUpdateDate |
تاریخی که مورد آخرینبار بهروزرسانی شده است، در قالب ISO 8601. |
googleExpirationDate |
تاریخی که مورد منقضی میشود، در قالب ISO 8601. |
DestinationStatus
وضعیت مقصد وضعیت محصول.
| نمایش JSON |
|---|
{ "destination": string, "approvedCountries": [ string ], "pendingCountries": [ string ], "disapprovedCountries": [ string ] } |
| فیلدها | |
|---|---|
destination |
نام مقصد |
approvedCountries[] |
فهرست کدهای کشور (ISO 3166-1 alpha-2) که «محصول سرویس مقایسه قیمت» در آنها تأیید شده است. |
pendingCountries[] |
فهرست کدهای کشور (ISO 3166-1 alpha-2) که «محصول CSS» در آنها درانتظار تأیید است. |
disapprovedCountries[] |
فهرست کدهای کشور (ISO 3166-1 alpha-2) که «محصول سرویس مقایسه قیمت» در آنها رد شده است. |
ItemLevelIssue
ItemLevelIssue وضعیت محصول.
| نمایش JSON |
|---|
{ "code": string, "servability": string, "resolution": string, "attribute": string, "destination": string, "description": string, "detail": string, "documentation": string, "applicableCountries": [ string ] } |
| فیلدها | |
|---|---|
code |
کد خطای مشکل. |
servability |
این مشکل چگونه بر ارائه «محصول CSS» تأثیر میگذارد. |
resolution |
آیا مشکل توسط فروشنده قابلحل است یا نه. |
attribute |
نام مشخصه، اگر مشکل بهدلیل یک مشخصه ایجاد شده باشد. |
destination |
مقصدی که مشکل برای آن اعمال میشود. |
description |
شرح کوتاهی از مشکل به زبان انگلیسی. |
detail |
شرح مفصل مشکل به زبان انگلیسی. |
documentation |
نشانی وب صفحه وب برای کمک به حل این مشکل. |
applicableCountries[] |
فهرست کدهای کشور (ISO 3166-1 alpha-2) که مشکل در آنها برای «محصول CSS» اعمال میشود. |
روشها |
|
|---|---|
|
«محصول CSS» پردازششده را از حساب CSS Center شما بازیابی میکند. |
|
«محصولات CSS» پردازششده را در حساب CSS Center شما فهرست میکند. |