REST Resource: accounts.cssProducts

منبع: CssProduct

«محصول سرویس مقایسه قیمت» پردازش‌شده.

نمایش 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" }) استفاده کرد. این برای ارسال مشخصه‌هایی که به‌طور صریح توسط میانای برنامه‌سازی کاربردی نشان داده نشده‌اند، مانند مشخصه‌های اضافی مورداستفاده برای «با 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,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
فیلدها
lowPrice

object (Price)

قیمت پایین محصول «سرویس مقایسه قیمت».

highPrice

object (Price)

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

headlineOfferPrice

object (Price)

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

headlineOfferShippingPrice

object (Price)

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

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 (Timestamp format)

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

includedDestinations[]

string

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

مقادیر پشتیبانی‌شده عبارت‌اند از: - css_ads_experiences - css_organic_experiences

excludedDestinations[]

string

فهرست مقصدهایی که باید برای این هدف کنار گذاشته شوند (مطابق با چارگوش‌های انتخاب علامت‌نزده در Merchant Center).

مقادیر پشتیبانی‌شده عبارت‌اند از: - css_ads_experiences - css_organic_experiences

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

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

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

برچسب سفارشی ۰ برای گروه‌بندی سفارشی موارد در پویش Shopping.

customLabel1

string

برچسب سفارشی ۱ برای گروه‌بندی سفارشی موارد در پویش Shopping.

customLabel2

string

برچسب سفارشی ۲ برای گروه‌بندی سفارشی موارد در پویش Shopping.

customLabel3

string

برچسب سفارشی ۳ برای گروه‌بندی سفارشی موارد در پویش Shopping.

customLabel4

string

برچسب سفارشی ۴ برای گروه‌بندی سفارشی موارد در پویش Shopping.

reviewCount

string (int64 format)

تعداد مرورهای محصول. اگر rating ارائه شود، الزامی است.

minRating

string (int64 format)

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

maxRating

string (int64 format)

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

rating

number

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

قیمت

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

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

string (int64 format)

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

currencyCode

string

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

ProductDetail

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

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

string

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

attributeName

string

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

attributeValue

string

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

ProductWeight

وزن محصول.

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

number

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

unit

string

الزامی. واحد وزن. مقادیر پذیرفتنی عبارت‌اند از: * «g» * «kg» * «oz» * «lb»

ProductDimension

ابعاد محصول.

نمایش 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 است. این کد برای «برچسب‌های انرژی اروپا» الزامی است.

HeadlineOfferInstallment

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

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

string (int64 format)

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

amount

object (Price)

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

downpayment

object (Price)

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

HeadlineOfferSubscriptionCost

SubscriptionCost محصول.

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

enum (SubscriptionPeriod)

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

periodLength

string (int64 format)

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

amount

object (Price)

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

SubscriptionPeriod

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

شمارشی‌ها
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

وضعیت «محصول سرویس مقایسه قیمت»، مشکلات اعتبارسنجی داده‌ها، یعنی اطلاعات مربوط به «محصول سرویس مقایسه قیمت» که به‌صورت ناهمگام محاسبه شده است.

نمایش 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.

DestinationStatus

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

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

string

نام مقصد

approvedCountries[]

string

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

pendingCountries[]

string

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

disapprovedCountries[]

string

فهرست کدهای کشور (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

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 شما فهرست می‌کند.