REST Resource: accounts.products

منبع: محصول

محصول پردازش شده، از چندین [ورودی محصول][[google.shopping.content.bundles.Products.ProductInput] پس از اعمال قوانین و منابع داده تکمیلی ساخته شده است. این محصول پردازش شده با آنچه در حساب Merchant Center شما و در تبلیغات خرید و سایر سطوح در سراسر Google نشان داده شده است مطابقت دارد. هر محصول دقیقاً از یک ورودی محصول منبع داده اولیه و چندین ورودی منبع داده تکمیلی ساخته شده است. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده به‌روز شده بازیابی شود.

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

نمایندگی JSON
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
زمینه های
name

string

نام محصول. قالب: "{product.name=accounts/{account}/products/{product}}"

channel

enum ( ChannelEnum )

فقط خروجی کانال محصول

offerId

string

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

contentLanguage

string

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

feedLabel

string

فقط خروجی برچسب خوراک برای محصول

dataSource

string

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

attributes

object ( Attributes )

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

customAttributes[]

object ( CustomAttribute )

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

productStatus

object ( ProductStatus )

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

versionNumber

string ( int64 format)

فقط خروجی نشان دهنده نسخه موجود (تازه بودن) محصول است که می توان از آن برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده کرد.

در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی محصول موجود باشد، از درج جلوگیری می شود. قرار دادن مجدد (به عنوان مثال، بازخوانی محصول پس از 30 روز) را می توان با versionNumber انجام داد.

فقط برای درج در منابع داده اولیه پشتیبانی می شود.

اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

ویژگی های

ویژگی های.

نمایندگی JSON
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
زمینه های
expirationDate

string ( Timestamp format)

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

disclosureDate

string ( Timestamp format)

زمانی که یک پیشنهاد در نتایج جستجو در سطوح YouTube Google در قالب ISO 8601 قابل مشاهده است. برای اطلاعات بیشتر به [تاریخ افشا]( https://support.google.com/merchants/answer/13034208 ) مراجعه کنید.

availabilityDate

string ( Timestamp format)

روزی که یک محصول پیش‌سفارش شده برای تحویل در قالب ISO 8601 در دسترس قرار می‌گیرد.

price

object ( Price )

قیمت کالا.

installment

object ( Installment )

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

subscriptionCost

object ( SubscriptionCost )

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

loyaltyPoints

object ( LoyaltyPoints )

امتیازات وفاداری که کاربران پس از خرید کالا دریافت می کنند. فقط ژاپن

loyaltyPrograms[]

object ( LoyaltyProgram )

فهرستی از اطلاعات برنامه وفاداری که برای نشان دادن مزایای وفاداری (مثلاً قیمت بهتر، امتیازات و غیره) برای کاربر این مورد استفاده می‌شود.

productTypes[]

string

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

salePrice

object ( Price )

قیمت فروش کالا اعلام شده است.

salePriceEffectiveDate

object ( Interval )

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

productHeight

object ( ProductDimension )

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

productLength

object ( ProductDimension )

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

productWidth

object ( ProductDimension )

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

productWeight

object ( ProductWeight )

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

shipping[]

object ( Shipping )

قوانین حمل و نقل

freeShippingThreshold[]

object ( FreeShippingThreshold )

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

shippingWeight

object ( ShippingWeight )

وزن کالا برای حمل و نقل

shippingLength

object ( ShippingDimension )

طول کالا برای حمل و نقل

shippingWidth

object ( ShippingDimension )

عرض کالا برای حمل و نقل

shippingHeight

object ( ShippingDimension )

ارتفاع کالا برای حمل و نقل

sizeTypes[]

string

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

taxes[]

object ( Tax )

اطلاعات مالیاتی.

unitPricingMeasure

object ( UnitPricingMeasure )

اندازه و ابعاد یک آیتم.

unitPricingBaseMeasure

object ( UnitPricingBaseMeasure )

ترجیح مخرج قیمت واحد.

adsLabels[]

string

شبیه به adsGrouping است، اما فقط روی CPC کار می کند.

costOfGoodsSold

object ( Price )

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

productDetails[]

object ( ProductDetail )

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

productHighlights[]

string

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

displayAdsSimilarIds[]

string

توصیه های مشخص شده توسط تبلیغ کننده

promotionIds[]

string

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

includedDestinations[]

string

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

excludedDestinations[]

string

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

shoppingAdsExcludedCountries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) برای حذف پیشنهاد از مقصد تبلیغات خرید. کشورهای این لیست از کشورهایی که در تنظیمات منبع داده پیکربندی شده اند حذف می شوند.

cloudExportAdditionalProperties[]

object ( CloudExportAdditionalProperties )

فیلدهای اضافی برای صادرات به برنامه Cloud Retail.

certifications[]

object ( Certification )

گواهینامه های محصول، به عنوان مثال برای برچسب زدن بهینه انرژی محصولات ثبت شده در پایگاه داده EPREL اتحادیه اروپا . برای اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.

autoPricingMinPrice

object ( Price )

حفاظتی در پروژه‌های «تخفیف‌های خودکار» ( https://support.google.com/merchants/answer/10295759 ) و «تبلیغات پویا» ( https://support.google.com/merchants/answer/13949249 ) که تخفیف در پیشنهادات بازرگانان کمتر از این مقدار نباشد و در نتیجه ارزش و سودآوری پیشنهاد حفظ شود.

identifierExists

boolean

زمانی که مورد دارای شناسه های منحصر به فرد محصول متناسب با دسته خود، مانند GTIN، MPN و نام تجاری نباشد، این مقدار را روی false تنظیم کنید. اگر ارائه نشده باشد، پیش‌فرض‌ها به درست است.

isBundle

boolean

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

title

string

عنوان مورد.

description

string

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

adult

boolean

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

ageGroup

string

گروه سنی مورد نظر

availability

string

وضعیت در دسترس بودن مورد

brand

string

نام تجاری کالا.

color

string

رنگ مورد.

condition

string

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

gender

string

جنسیت مورد نظر

googleProductCategory

string

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

gtin

string

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

itemGroupId

string

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

material

string

ماده ای که مورد از آن ساخته شده است.

mpn

string

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

pattern

string

الگوی مورد (به عنوان مثال، نقطه پولکا).

sellOnGoogleQuantity

string ( int64 format)

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

maxHandlingTime

string ( int64 format)

حداکثر زمان رسیدگی به محصول (در روزهای کاری).

minHandlingTime

string ( int64 format)

حداقل زمان رسیدگی به محصول (در روزهای کاری).

shippingLabel

string

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

transitTimeLabel

string

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

size

string

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

sizeSystem

string

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

taxCategory

string

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

energyEfficiencyClass

string

کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.

minEnergyEfficiencyClass

string

کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.

maxEnergyEfficiencyClass

string

کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.

multipack

string ( int64 format)

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

adsGrouping

string

برای گروه بندی موارد به روش دلخواه استفاده می شود. فقط برای CPA٪، در غیر این صورت دلسرد می شود.

adsRedirect

string

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

displayAdsId

string

یک شناسه برای یک مورد برای کمپین های بازاریابی مجدد پویا.

displayAdsTitle

string

عنوان یک مورد برای کمپین های بازاریابی مجدد پویا.

displayAdsValue

number

حاشیه پیشنهادی برای کمپین های بازاریابی مجدد پویا.

pickupMethod

string

گزینه pick up برای مورد.

pickupSla

string

جدول زمانی تحویل کالا از فروشگاه.

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

externalSellerId

string

برای حساب های چند فروشنده مورد نیاز است. اگر در بازاری هستید که محصولاتی را برای فروشندگان مختلف در حساب چند فروشنده خود آپلود می کنید، از این ویژگی استفاده کنید.

pause

string

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

structuredTitle

object ( ProductStructuredTitle )

عنوان ساختاریافته، برای عناوین تولید شده به صورت الگوریتمی (AI).

structuredDescription

object ( ProductStructuredDescription )

توصیف ساختاریافته، برای توصیفات تولید شده به صورت الگوریتمی (AI).

قسط

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

نمایندگی JSON
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
زمینه های
months

string ( int64 format)

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

amount

object ( Price )

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

downpayment

object ( Price )

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

creditType

string

نوع پرداخت اقساطی. مقادیر پشتیبانی شده عبارتند از: * " finance " * " lease "

هزینه اشتراک

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

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

امتیازات وفاداری

پیامی که نشان دهنده امتیازات وفاداری است.

نمایندگی JSON
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
زمینه های
name

string

نام برنامه امتیاز وفاداری. توصیه می شود نام را به 12 کاراکتر تمام عرض یا 24 کاراکتر رومی محدود کنید.

pointsValue

string ( int64 format)

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

ratio

number

نسبت یک نقطه هنگام تبدیل به ارز. Google ارز را بر اساس تنظیمات Merchant Center فرض می‌کند. اگر نسبت حذف شود، به طور پیش فرض روی 1.0 قرار می گیرد.

برنامه وفاداری

پیامی که نشان دهنده برنامه وفاداری است.

نمایندگی JSON
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
زمینه های
programLabel

string

برچسب برنامه وفاداری. این یک برچسب داخلی است که به طور منحصر به فرد رابطه بین یک نهاد تجاری و یک نهاد برنامه وفاداری را مشخص می کند. برچسب باید ارائه شود تا سیستم بتواند دارایی های زیر (مثلاً قیمت و امتیاز) را با یک تاجر مرتبط کند. برنامه مربوطه باید به حساب تاجر مرتبط باشد.

tierLabel

string

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

price

object ( Price )

قیمت برای اعضای ردیف داده شده، یعنی قیمت تخفیف فوری. باید کوچکتر یا برابر با قیمت معمولی باشد.

cashbackForFutureUse

object ( Price )

بازگشت نقدی که می تواند برای خریدهای بعدی استفاده شود.

loyaltyPoints

string ( int64 format)

میزان امتیازات وفاداری کسب شده در خرید.

ابعاد محصول

ابعاد محصول.

نمایندگی JSON
{
  "value": number,
  "unit": string
}
زمینه های
value

number

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

unit

string

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

وزن محصول

وزن محصول.

نمایندگی JSON
{
  "value": number,
  "unit": string
}
زمینه های
value

number

ضروری. وزن به عنوان یک عدد نشان داده شده است. وزن می تواند حداکثر دقت چهار رقم اعشار را داشته باشد.

unit

string

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

حمل دریایی

حمل و نقل محصول.

نمایندگی JSON
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
زمینه های
price

object ( Price )

قیمت ثابت حمل و نقل، به عنوان یک عدد نشان داده شده است.

country

string

کد قلمرو CLDR کشوری که یک کالا به آن ارسال می شود.

region

string

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

service

string

شرح رایگان کلاس خدمات یا سرعت تحویل.

locationId

string ( int64 format)

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

locationGroupName

string

مکانی که حمل و نقل در آن قابل اجرا است، که با نام گروه مکان نشان داده شده است.

postalCode

string

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

minHandlingTime

string ( int64 format)

حداقل زمان رسیدگی (شامل) بین زمان دریافت سفارش و ارسال در روزهای کاری. 0 به این معنی است که اگر سفارش قبل از زمان قطعی اتفاق بیفتد، در همان روز دریافت ارسال می شود. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] فقط می‌تواند همراه با [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] باشد. اما اگر [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] وجود داشته باشد، لازم نیست.

maxHandlingTime

string ( int64 format)

حداکثر زمان رسیدگی (شامل) بین زمان دریافت سفارش و ارسال در روزهای کاری. 0 به این معنی است که اگر سفارش قبل از زمان قطعی اتفاق بیفتد، در همان روز دریافت ارسال می شود. در صورت ارائه سرعت حمل و نقل، هر دو [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] و [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] مورد نیاز هستند. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] اختیاری است اگر [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] وجود داشته باشد.

minTransitTime

string ( int64 format)

حداقل زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 0 به این معنی است که سفارش در همان روز تحویل تحویل می شود. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] فقط می‌تواند همراه با [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] باشد. اما اگر [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] وجود داشته باشد، لازم نیست.

maxTransitTime

string ( int64 format)

حداکثر زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 0 به این معنی است که سفارش در همان روز تحویل تحویل می شود. در صورت ارائه سرعت حمل و نقل، هر دو [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] و [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] مورد نیاز هستند. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] اختیاری است اگر [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] وجود داشته باشد.

آستانه ارسال رایگان

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

نمایندگی JSON
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
زمینه های
country

string

کد قلمرو CLDR کشوری که یک کالا به آن ارسال می شود.

priceThreshold

object ( Price )

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

وزن حمل و نقل

وزن حمل و نقل محصول

نمایندگی JSON
{
  "value": number,
  "unit": string
}
زمینه های
value

number

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

unit

string

واحد ارزش.

ابعاد حمل و نقل

ابعاد حمل و نقل محصول

نمایندگی JSON
{
  "value": number,
  "unit": string
}
زمینه های
value

number

ابعاد محصول مورد استفاده برای محاسبه هزینه حمل و نقل کالا.

unit

string

واحد ارزش.

مالیات

مالیات محصول

نمایندگی JSON
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
زمینه های
rate

number

درصد نرخ مالیاتی که بر قیمت کالا اعمال می شود.

country

string

کشوری که در آن کالا مشمول مالیات است، به عنوان کد قلمرو CLDR مشخص شده است.

region

string

منطقه جغرافیایی که نرخ مالیات بر آن اعمال می شود.

taxShip

boolean

اگر برای حمل و نقل مالیات دریافت می شود، روی true تنظیم کنید.

locationId

string ( int64 format)

شناسه عددی مکانی که نرخ مالیات بر آن اعمال می‌شود، همانطور که در API AdWords تعریف شده است.

postalCode

string

محدوده کد پستی که نرخ مالیات بر آن اعمال می‌شود، که با کد پستی، پیشوند کد پستی با استفاده از علامت *، محدوده بین دو کد پستی یا دو پیشوند کد پستی با طول مساوی نشان داده می‌شود. مثال: 94114، 94*، 94002-95460، 94*-95*.

UnitPricingMeasure

UnitPricingMeasure محصول.

نمایندگی JSON
{
  "value": number,
  "unit": string
}
زمینه های
value

number

اندازه گیری یک مورد.

unit

string

واحد اندازه گیری.

UnitPricingBaseMeasure

UnitPricingBaseMeasure محصول.

نمایندگی JSON
{
  "value": string,
  "unit": string
}
زمینه های
value

string ( int64 format)

مخرج قیمت واحد.

unit

string

واحد مخرج.

جزئیات محصول

جزئیات محصول

نمایندگی JSON
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
زمینه های
sectionName

string

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

attributeName

string

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

attributeValue

string

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

CloudExportAdditionalProperties

ویژگی محصول برای Cloud Retail API. به عنوان مثال، ویژگی های یک محصول تلویزیونی می تواند "صفحه نمایش" یا "اندازه صفحه" باشد.

نمایندگی JSON
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
زمینه های
textValue[]

string

مقدار متنی ویژگی داده شده به عنوان مثال، "8K(UHD)" می تواند یک مقدار متنی برای یک محصول تلویزیونی باشد. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند. حداکثر اندازه رشته 256 کاراکتر است.

intValue[]

string ( int64 format)

مقادیر صحیح ویژگی داده شده به عنوان مثال، 1080 برای وضوح صفحه نمایش محصول تلویزیون. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند.

floatValue[]

number

مقادیر شناور ویژگی داده شده. به عنوان مثال برای یک محصول تلویزیونی 1.2345. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند.

propertyName

string

نام ملک داده شده به عنوان مثال، "Resolution-Screen" برای یک محصول تلویزیونی. حداکثر اندازه رشته 256 کاراکتر است.

boolValue

boolean

مقدار بولی ویژگی داده شده به عنوان مثال برای یک محصول تلویزیون، اگر صفحه نمایش UHD باشد، «درست» یا «نادرست» است.

minValue

number

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

maxValue

number

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

unitCode

string

واحد دارایی داده شده به عنوان مثال، "Pixels" برای یک محصول تلویزیونی. حداکثر اندازه رشته 256 بایت است.

گواهینامه

گواهینامه محصول، در ابتدا برای انطباق با برچسب گذاری بهره وری انرژی اتحادیه اروپا با استفاده از پایگاه داده EU EPREL معرفی شد.

نمایندگی JSON
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
زمینه های
certificationAuthority

string

مرجع صدور گواهینامه، به عنوان مثال "European_Commission". حداکثر طول 2000 کاراکتر است.

certificationName

string

نام گواهی، به عنوان مثال "EPREL". حداکثر طول 2000 کاراکتر است.

certificationCode

string

کد گواهینامه حداکثر طول 2000 کاراکتر است.

certificationValue

string

ارزش گواهینامه (همچنین به عنوان کلاس، سطح یا درجه نیز شناخته می شود)، به عنوان مثال "A+"، "C"، "طلا". حداکثر طول 2000 کاراکتر است.

ProductStructuredTitle

عنوان ساختاریافته، برای عناوین تولید شده به صورت الگوریتمی (AI).

نمایندگی JSON
{
  "digitalSourceType": string,
  "content": string
}
زمینه های
digitalSourceType

string

نوع منبع دیجیتال، به عنوان مثال "trained_algorithmic_media". پیروی از IPTC حداکثر طول 40 کاراکتر است.

content

string

متن عنوان حداکثر 150 کاراکتر است

ProductStructuredDescription

توصیف ساختاریافته، برای توصیفات تولید شده به صورت الگوریتمی (AI).

نمایندگی JSON
{
  "digitalSourceType": string,
  "content": string
}
زمینه های
digitalSourceType

string

نوع منبع دیجیتال، به عنوان مثال "trained_algorithmic_media". پیروی از IPTC حداکثر طول 40 کاراکتر است.

content

string

متن توضیحات حداکثر 5000 کاراکتر است

وضعیت محصول

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

نمایندگی 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
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
زمینه های
reportingContext

enum ( ReportingContextEnum )

نام زمینه گزارش.

approvedCountries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) که پیشنهاد مورد تایید قرار گرفته است.

pendingCountries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) که پیشنهاد در انتظار تأیید است.

disapprovedCountries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که در آن پیشنهاد رد شده است.

ItemLevelIssue

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

نمایندگی JSON
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
زمینه های
code

string

کد خطای مشکل

severity

enum ( Severity )

چگونه این موضوع بر ارائه پیشنهاد تأثیر می گذارد.

resolution

string

آیا این موضوع می تواند توسط تاجر حل شود یا خیر.

attribute

string

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

reportingContext

enum ( ReportingContextEnum )

زمینه گزارش دهی که این مسئله در مورد آن اعمال می شود.

description

string

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

detail

string

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

documentation

string

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

applicableCountries[]

string

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

شدت

این موضوع چگونه بر ارائه محصول تأثیر می گذارد.

Enums
SEVERITY_UNSPECIFIED مشخص نشده است.
NOT_IMPACTED این موضوع یک هشدار است و تأثیر مستقیمی بر روی محصول ندارد.
DEMOTED محصول تنزل یافته و به احتمال زیاد عملکرد محدودی در نتایج جستجو دارد
DISAPPROVED Issue محصول را تایید نمی کند.

مواد و روش ها

get

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

list

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