REST Resource: accounts.cssProducts

منبع: CssProduct

محصول CSS پردازش شده.

نمایش JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
فیلدها
name

string

نام محصول CSS. فرمت: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

فقط خروجی. شناسه خام منحصر به فرد شما برای محصول.

contentLanguage

string

فقط خروجی. کد زبان دو حرفی ISO 639-1 برای محصول.

feedLabel

string

فقط خروجی. برچسب تغذیه برای محصول.

attributes

object ( Attributes )

فقط خروجی. فهرستی از ویژگی‌های محصول.

customAttributes[]

object ( CustomAttribute )

فقط خروجی. فهرستی از ویژگی‌های سفارشی (ارائه شده توسط CSS). همچنین می‌توان از آن برای ارسال هر ویژگی از مشخصات فید به شکل عمومی آن استفاده کرد (برای مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به صراحت توسط API در معرض نمایش قرار نگرفته‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در گوگل، مفید است.

cssProductStatus

object ( CssProductStatus )

فقط خروجی. وضعیت یک محصول، مسائل اعتبارسنجی داده‌ها، یعنی اطلاعات مربوط به یک محصول که به صورت ناهمزمان محاسبه می‌شود.

ویژگی‌ها

ویژگی‌های محصول CSS.

نمایش JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
فیلدها
lowPrice

object ( Price )

قیمت پایین محصول CSS.

highPrice

object ( Price )

قیمت بالای محصول CSS.

headlineOfferPrice

object ( Price )

قیمت اصلی محصول CSS.

headlineOfferShippingPrice

object ( Price )

قیمت اصلی محصول CSS.

productTypes[]

string

دسته بندی های کالا (با فرمت مشخصات داده محصولات ).

sizeTypes[]

string

برش کالا. می‌توان از آن برای نمایش انواع سایزهای ترکیبی برای پوشاک استفاده کرد. حداکثر دو نوع سایز می‌تواند ارائه شود (به نوع سایز مراجعه کنید).

productDetails[]

object ( ProductDetail )

مشخصات فنی یا جزئیات بیشتر محصول.

productWeight

object ( ProductWeight )

وزن محصول به واحدهای ارائه شده. این مقدار باید بین 0 (به جز وزن خالص) و 2000 (شامل وزن خالص) باشد.

productLength

object ( ProductDimension )

طول محصول بر اساس واحدهای ارائه شده. مقدار باید بین 0 (به جز) و 3000 (شامل) باشد.

productWidth

object ( ProductDimension )

عرض محصول بر اساس واحدهای ارائه شده. مقدار باید بین 0 (به جز عرض محصول) و 3000 (شامل عرض محصول) باشد.

productHeight

object ( ProductDimension )

ارتفاع محصول در واحدهای ارائه شده. مقدار باید بین 0 (به جز ارتفاع محصول) و 3000 (شامل ارتفاع محصول) باشد.

productHighlights[]

string

نکات برجسته‌ای که مرتبط‌ترین ویژگی‌های یک محصول را توصیف می‌کنند.

certifications[]

object ( Certification )

فهرستی از گواهینامه‌های مورد ادعای CSS برای محصول مورد نظر.

expirationDate

string ( Timestamp format)

تاریخی که کالا باید در آن تاریخ منقضی شود، همانطور که هنگام درج مشخص شده است، در قالب ISO 8601. تاریخ انقضای واقعی در productstatuses به صورت googleExpirationDate نمایش داده می‌شود و اگر expirationDate خیلی دور باشد، ممکن است زودتر باشد. توجه: ممکن است حذف واقعی کالا بیش از ۲ روز از تاریخ انقضا طول بکشد.

includedDestinations[]

string

فهرست مقصدهایی که باید برای این هدف لحاظ شوند (مطابق با کادرهای انتخاب‌شده در مرکز فروشندگان). مقصدهای پیش‌فرض همیشه لحاظ می‌شوند، مگر اینکه در excludedDestinations ارائه شده باشند.

excludedDestinations[]

string

فهرست مقاصدی که باید برای این هدف حذف شوند (مطابق با کادرهای انتخاب نشده در مرکز فروشندگان).

headlineOfferInstallment

object ( HeadlineOfferInstallment )

تعداد و مبلغ اقساط برای پرداخت یک کالا.

headlineOfferSubscriptionCost

object ( HeadlineOfferSubscriptionCost )

تعداد دوره‌ها (ماه‌ها یا سال‌ها) و مبلغ پرداختی در هر دوره برای یک کالا با قرارداد اشتراک مرتبط.

cppAdsRedirect

string

به تبلیغ‌کنندگان اجازه می‌دهد تا هنگام نمایش محصول در متن تبلیغات محصول، URL کالا را نادیده بگیرند.

numberOfOffers

string ( int64 format)

تعداد محصولات CSS.

headlineOfferCondition

string

وضعیت پیشنهاد اصلی.

title

string

عنوان کالا.

description

string

شرح کالا.

brand

string

ویژگی‌های مرتبط با محصول.[14-36] برند کالا.

mpn

string

شماره قطعه سازنده ( MPN ) کالا.

gtin

string

شماره جهانی قلم تجاری ( GTIN ) قلم.

googleProductCategory

string

دسته‌بندی گوگل برای کالا (به دسته‌بندی محصولات گوگل مراجعه کنید). هنگام جستجوی محصولات، این فیلد حاوی مقداری خواهد بود که کاربر ارائه داده است. در حال حاضر هیچ راهی برای بازیابی دسته‌بندی‌های خودکار اختصاص داده شده به محصولات گوگل از طریق API وجود ندارد.

adult

boolean

اگر آیتم برای بزرگسالان در نظر گرفته شده است، روی true تنظیم کنید.

multipack

string ( int64 format)

تعداد محصولات یکسان در یک بسته‌بندی چندگانه تعریف‌شده توسط فروشنده.

isBundle

boolean

اینکه آیا کالا به صورت بسته‌ی تعریف‌شده توسط فروشنده است یا خیر. بسته، گروه‌بندی سفارشی از محصولات مختلف است که توسط یک فروشنده با یک قیمت واحد فروخته می‌شود.

ageGroup

string

گروه سنی هدف کالا.

color

string

رنگ کالا.

gender

string

جنسیت مورد نظر برای کالا.

material

string

ماده‌ای که کالا از آن ساخته شده است.

pattern

string

طرح روی کالا (مثلاً طرح خال‌خالی).

size

string

اندازه کالا. فقط یک مقدار مجاز است. برای انواع با اندازه‌های مختلف، برای هر اندازه یک محصول جداگانه با مقدار itemGroupId یکسان وارد کنید (به [https://support.google.com/merchants/answer/6324492](تعریف اندازه) مراجعه کنید).

sizeSystem

string

سیستمی که در آن اندازه مشخص شده است. برای اقلام پوشاک توصیه می‌شود.

itemGroupId

string

شناسه مشترک برای همه انواع یک محصول.

pause

string

انتشار این مطلب موقتاً متوقف خواهد شد.

customLabel0

string

برچسب سفارشی ۰ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.

customLabel1

string

برچسب سفارشی ۱ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.

customLabel2

string

برچسب سفارشی ۲ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.

customLabel3

string

برچسب سفارشی ۳ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.

customLabel4

string

برچسب سفارشی ۴ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.

reviewCount

string ( int64 format)

تعداد نظرات مربوط به محصول. در صورت ارائه rating الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.

minRating

string ( int64 format)

حداقل امتیاز رتبه‌بندی محصول. در صورت ارائه rating الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.

maxRating

string ( int64 format)

حداکثر امتیاز رتبه‌بندی محصول. در صورت ارائه rating الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.

rating

number

میانگین امتیاز رتبه‌بندی محصول. این مقدار باید در محدوده [ minRating ، maxRating ] باشد. این امتیاز هنگام نمایش در صفحه محصول، با یک رقم اعشار به مقیاس [1، 5] نرمال‌سازی می‌شود. در صورت وجود، reviewCount ، minRating و maxRating نیز الزامی هستند. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.

قیمت

قیمت به صورت عدد و واحد پول نمایش داده می‌شود.

نمایش JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
فیلدها
amountMicros

string ( int64 format)

قیمتی که به صورت عددی بر حسب میکرو نمایش داده می‌شود (۱ میلیون میکرو معادل واحد استاندارد پول رایج یک کشور است، برای مثال، ۱ دلار آمریکا = ۱۰۰۰۰۰۰ میکرو).

currencyCode

string

واحد پول قیمت با استفاده از اختصارات سه حرفی مطابق با استاندارد ISO 4217 .

جزئیات محصول

جزئیات محصول.

نمایش JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
فیلدها
sectionName

string

سربرگ بخش برای گروه‌بندی مجموعه‌ای از جزئیات محصول استفاده می‌شود.

attributeName

string

نام جزئیات محصول.

attributeValue

string

ارزش جزئیات محصول.

وزن محصول

وزن محصول.

نمایش JSON 
{
  "value": number,
  "unit": string
}
فیلدها
value

number

الزامی. وزن به صورت عدد نمایش داده می‌شود. حداکثر دقت وزن می‌تواند چهار رقم اعشار باشد.

unit

string

الزامی. واحد وزن. مقادیر قابل قبول عبارتند از: * " g " * " kg " * " oz " * " lb "

ابعاد محصول

ابعاد محصول.

نمایش JSON 
{
  "value": number,
  "unit": string
}
فیلدها
value

number

الزامی. مقدار بُعد که به صورت یک عدد نمایش داده می‌شود. این مقدار می‌تواند حداکثر دقت چهار رقم اعشار را داشته باشد.

unit

string

الزامی. واحدهای ابعاد. مقادیر قابل قبول عبارتند از: * " in " * " cm "

صدور گواهینامه

گواهینامه محصول. از این ویژگی برای توصیف گواهینامه‌های مرتبط با یک محصول، مانند رتبه‌بندی بهره‌وری انرژی، استفاده کنید.

نمایش JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
فیلدها
name

string

نام گواهینامه. در حال حاضر، رایج‌ترین مقدار "EPREL" است که نشان‌دهنده گواهینامه‌های بهره‌وری انرژی در پایگاه داده ثبت اروپایی برچسب‌گذاری انرژی (EPREL) اتحادیه اروپا است.

authority

string

مرجع یا نهاد صدور گواهینامه مسئول صدور گواهینامه. در حال حاضر، رایج‌ترین مقدار برای برچسب‌های انرژی در اتحادیه اروپا "EC" یا "European_Commission" است.

code

string

کد گواهینامه. به عنوان مثال، برای گواهینامه EPREL با لینک https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 کد 123456 است. این کد برای برچسب‌های انرژی اروپایی الزامی است.

پیشنهاد ویژه اقساط

پیامی که نشان دهنده قسط است.

نمایش JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
فیلدها
months

string ( int64 format)

تعداد اقساطی که خریدار باید پرداخت کند.

amount

object ( Price )

مبلغی که خریدار باید ماهانه بپردازد.

downpayment

object ( Price )

مبلغ پیش‌پرداختی که خریدار باید بپردازد.

پیشنهاد ویژههزینه اشتراک

هزینه اشتراک محصول.

نمایش JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
فیلدها
period

enum ( SubscriptionPeriod )

نوع دوره اشتراک. مقادیر پشتیبانی شده عبارتند از: * " month " * " year "

periodLength

string ( int64 format)

تعداد دوره‌های اشتراکی که خریدار باید پرداخت کند.

amount

object ( Price )

مبلغی که خریدار باید برای هر دوره اشتراک بپردازد.

دوره اشتراک

دوره اشتراک محصول.

انوم‌ها
SUBSCRIPTION_PERIOD_UNSPECIFIED نشان می‌دهد که مدت اشتراک مشخص نیست.
MONTH نشان می‌دهد که دوره اشتراک یک ماه است.
YEAR نشان می‌دهد که دوره اشتراک به صورت سال است.

ویژگی سفارشی

پیامی که نشان‌دهنده‌ی ویژگی‌های سفارشی است. دقیقاً یکی از value یا groupValues ​​نباید خالی باشد.

نمایش JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
فیلدها
groupValues[]

object ( CustomAttribute )

زیرصفت‌ها درون این گروه ویژگی. اگر groupValues ​​خالی نباشد، value باید خالی باشد.

name

string

نام ویژگی.

value

string

مقدار ویژگی. اگر value خالی نباشد، groupValues ​​باید خالی باشد.

وضعیت محصول Css

وضعیت Css Product، مسائل مربوط به اعتبارسنجی داده‌ها، یعنی اطلاعات مربوط به Css Product که به صورت ناهمزمان محاسبه می‌شوند.

نمایش JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
فیلدها
destinationStatuses[]

object ( DestinationStatus )

مقاصد در نظر گرفته شده برای محصول.

itemLevelIssues[]

object ( ItemLevelIssue )

فهرستی از تمام مشکلات مرتبط با محصول.

creationDate

string ( Timestamp format)

تاریخ ایجاد آیتم، با فرمت ISO 8601 .

lastUpdateDate

string ( Timestamp format)

تاریخ آخرین به‌روزرسانی مورد، با فرمت ISO 8601 .

googleExpirationDate

string ( Timestamp format)

تاریخ انقضای کالا، با فرمت ISO 8601 .

وضعیت مقصد

وضعیت مقصدِ محصول.

نمایش JSON 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
فیلدها
destination

string

نام مقصد

approvedCountries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که محصول CSS در آنها تأیید شده است.

pendingCountries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که محصول CSS در انتظار تأیید در آنها است.

disapprovedCountries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که محصول CSS در آنها رد شده است.

شماره سطح آیتم

شماره آیتم سطح مربوط به وضعیت محصول.

نمایش JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
فیلدها
code

string

کد خطای مربوط به مشکل.

servability

string

چگونه این مشکل بر ارائه محصول CSS تأثیر می‌گذارد.

resolution

string

اینکه آیا مشکل توسط فروشنده قابل حل است یا خیر.

attribute

string

نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.

destination

string

مقصدی که مشکل به آن مربوط می‌شود.

description

string

شرح مختصری از مشکل به زبان انگلیسی.

detail

string

شرح مفصلی از مشکل به زبان انگلیسی.

documentation

string

آدرس اینترنتی یک صفحه وب برای کمک به حل این مشکل.

applicableCountries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) که در آن موضوع مربوط به محصول CSS است.

روش‌ها

get

 محصول CSS پردازش‌شده را از حساب CSS Center شما بازیابی می‌کند.

list

 محصولات CSS پردازش‌شده را در حساب CSS Center شما فهرست می‌کند.