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 نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است.

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
}
فیلدها
lowPrice

object ( Price )

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

highPrice

object ( Price )

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

headlineOfferPrice

object ( Price )

قیمت سرفصل محصول CSS.

headlineOfferShippingPrice

object ( Price )

قیمت سرفصل محصول CSS.

productTypes[]

string

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

sizeTypes[]

string

برش مورد. می توان از آن برای نشان دادن انواع اندازه های ترکیبی برای اقلام پوشاک استفاده کرد. حداکثر دو نوع اندازه قابل ارائه است (به [https://support.google.com/merchants/answer/6324497](نوع اندازه) مراجعه کنید).

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 در آینده خیلی دور باشد، ممکن است زودتر باشد. توجه: ممکن است 2+ روز از تاریخ انقضا طول بکشد تا مورد واقعاً حذف شود.

includedDestinations[]

string

فهرست مقصدهایی که باید برای این هدف درج شود (مطابق با کادرهای انتخاب شده در Merchant Center) است. مقاصد پیش‌فرض همیشه گنجانده می‌شوند مگر اینکه در excludedDestinations ارائه شده باشند.

excludedDestinations[]

string

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

headlineOfferInstallment

object ( HeadlineOfferInstallment )

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

headlineOfferSubscriptionCost

object ( HeadlineOfferSubscriptionCost )

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

cppAdsRedirect

string

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

numberOfOffers

string ( int64 format)

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

headlineOfferCondition

string

شرایط پیشنهاد سرفصل.

title

string

عنوان مورد.

description

string

توضیحات مورد.

brand

string

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

mpn

string

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

gtin

string

شماره کالای تجاری جهانی ( GTIN ) مورد.

googleProductCategory

string

دسته بندی مورد توسط Google (به طبقه بندی محصولات Google مراجعه کنید). هنگام پرس و جو از محصولات، این فیلد حاوی مقدار ارائه شده توسط کاربر خواهد بود. در حال حاضر هیچ راهی برای بازگرداندن دسته‌های محصولات Google اختصاص داده شده خودکار از طریق 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

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

قیمت

قیمت به صورت عدد و ارز نشان داده شده است.

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

string ( int64 format)

قیمت به عنوان یک عدد در میکرو نشان داده می شود (1 میلیون میکرو معادل واحد استاندارد واحد پولی فرد است، به عنوان مثال، 1 USD = 1000000 میکرون).

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 )

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

HeadlineOfferSubscriptionCost

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

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

enum ( SubscriptionPeriod )

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

periodLength

string ( int64 format)

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

amount

object ( Price )

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

دوره اشتراک

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

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

CustomAttribute

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

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

object ( CustomAttribute )

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

name

string

نام صفت.

value

string

مقدار صفت. اگر value خالی نیست، groupValues ​​باید خالی باشد.

CssProductStatus

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

نمایندگی 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 تایید نشده است.

ItemLevelIssue

ItemLevelIssue وضعیت محصول.

نمایندگی 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

URL یک صفحه وب برای کمک به حل این مشکل.

applicableCountries[]

string

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

روش ها

get

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

list

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