Package google.shopping.merchant.products.v1beta

فهرست مطالب

• ProductInputsService (رابط)
• ProductsService (رابط)
• Attributes (پیام)
• Certification (پیام)
• CloudExportAdditionalProperties (پیام)
• DeleteProductInputRequest (پیام)
• FreeShippingThreshold (پیام)
• GetProductRequest (پیام)
• InsertProductInputRequest (پیام)
• Installment (پیام)
• ListProductsRequest (پیام)
• ListProductsResponse (پیام)
• LoyaltyPoints (پیام)
• LoyaltyProgram (پیام)
• Product (پیام)
• ProductDetail (پیام)
• ProductDimension (پیام)
• ProductInput (پیام)
• ProductStatus (پیام)
• ProductStatus.DestinationStatus (پیام)
• ProductStatus.ItemLevelIssue (پیام)
• ProductStatus.ItemLevelIssue.Severity (تعدادی)
• ProductStructuredDescription (پیام)
• ProductStructuredTitle (پیام)
• ProductWeight (پیام)
• Shipping (پیام)
• ShippingDimension (پیام)
• ShippingWeight (پیام)
• SubscriptionCost (پیام)
• SubscriptionPeriod (تعدادی)
• Tax (پیام)
• UnitPricingBaseMeasure (پیام)
• UnitPricingMeasure (پیام)

ProductInputsService

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

DeleteProductInput
rpc DeleteProductInput( DeleteProductInputRequest ) returns ( Empty ) ورودی محصول را از حساب Merchant Center شما حذف می کند. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده بازیابی شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/content برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

InsertProductInput

rpc InsertProductInput( InsertProductInputRequest ) returns ( ProductInput ) ورودی محصول را در حساب Merchant Center شما آپلود می کند. اگر ورودی با همان contentLanguage، offerId و dataSource از قبل وجود داشته باشد، این روش جایگزین آن ورودی می شود. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده بازیابی شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/content برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

خدمات محصولات

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

GetProduct
rpc GetProduct( GetProductRequest ) returns ( Product ) محصول پردازش شده را از حساب Merchant Center شما بازیابی می کند. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول نهایی به‌روز شده بازیابی شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/content برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

لیست محصولات

rpc ListProducts( ListProductsRequest ) returns ( ListProductsResponse ) محصولات پردازش شده را در حساب Merchant Center شما فهرست می کند. پاسخ ممکن است حاوی موارد کمتری نسبت به اندازه صفحه باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده به‌روز شده بازیابی شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/content برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ویژگی های

ویژگی های.

زمینه های
additional_image_links[]	string نشانی‌های اینترنتی اضافی از تصاویر مورد.
expiration_date	Timestamp تاریخی که در آن آیتم باید منقضی شود، همانطور که در هنگام درج مشخص شده است، در قالب ISO 8601 . تاریخ انقضای واقعی در productstatuses به عنوان googleExpirationDate نشان داده می شود و اگر expirationDate در آینده خیلی دور باشد، ممکن است زودتر باشد.
disclosure_date	Timestamp زمانی که یک پیشنهاد در نتایج جستجو در سطوح YouTube Google در قالب ISO 8601 قابل مشاهده است. برای اطلاعات بیشتر به [تاریخ افشا]( https://support.google.com/merchants/answer/13034208 ) مراجعه کنید.
availability_date	Timestamp روزی که یک محصول پیش‌سفارش شده برای تحویل در قالب ISO 8601 در دسترس قرار می‌گیرد.
price	Price قیمت کالا.
installment	Installment تعداد و میزان اقساط برای پرداخت یک کالا.
subscription_cost	SubscriptionCost تعداد دوره‌ها (ماه‌ها یا سال‌ها) و میزان پرداخت در هر دوره برای یک مورد با قرارداد اشتراک مرتبط.
loyalty_points	LoyaltyPoints امتیازات وفاداری که کاربران پس از خرید کالا دریافت می کنند. فقط ژاپن
loyalty_programs[]	LoyaltyProgram فهرستی از اطلاعات برنامه وفاداری که برای نشان دادن مزایای وفاداری (مثلاً قیمت بهتر، امتیازات و غیره) برای کاربر این مورد استفاده می‌شود.
product_types[]	string دسته بندی های مورد (قالب بندی شده مانند مشخصات داده های محصول ).
sale_price	Price قیمت فروش کالا اعلام شده است.
sale_price_effective_date	Interval محدوده تاریخی که در طی آن کالا به فروش می رسد (به مشخصات داده های محصول مراجعه کنید).
product_height	ProductDimension ارتفاع محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.
product_length	ProductDimension طول محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.
product_width	ProductDimension عرض محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.
product_weight	ProductWeight وزن محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 2000 (شامل) باشد.
shipping[]	Shipping قوانین حمل و نقل
free_shipping_threshold[]	FreeShippingThreshold شرایطی که باید برای ارسال رایگان یک محصول رعایت شود.
shipping_weight	ShippingWeight وزن کالا برای حمل و نقل
shipping_length	ShippingDimension طول کالا برای حمل و نقل
shipping_width	ShippingDimension عرض کالا برای حمل و نقل
shipping_height	ShippingDimension ارتفاع کالا برای حمل و نقل
size_types[]	string برش مورد. می توان از آن برای نشان دادن انواع اندازه های ترکیبی برای اقلام پوشاک استفاده کرد. حداکثر دو نوع اندازه قابل ارائه است (به [https://support.google.com/merchants/answer/6324497](نوع اندازه) مراجعه کنید).
taxes[]	Tax اطلاعات مالیاتی.
unit_pricing_measure	UnitPricingMeasure اندازه و ابعاد یک آیتم.
unit_pricing_base_measure	UnitPricingBaseMeasure ترجیح مخرج قیمت واحد.
ads_labels[]	string مشابه ads_grouping است، اما فقط روی CPC کار می کند.
cost_of_goods_sold	Price هزینه کالاهای فروخته شده. برای گزارش سود ناخالص استفاده می شود.
product_details[]	ProductDetail مشخصات فنی یا جزئیات اضافی محصول.
product_highlights[]	string نقاط گلوله ای که مرتبط ترین نکات برجسته یک محصول را توصیف می کند.
display_ads_similar_ids[]	string توصیه های مشخص شده توسط تبلیغ کننده
promotion_ids[]	string شناسه منحصر به فرد یک تبلیغ.
included_destinations[]	string فهرست مقصدهایی که باید برای این هدف درج شود (مطابق با کادرهای انتخاب شده در Merchant Center) است. مقاصد پیش‌فرض همیشه گنجانده می‌شوند مگر اینکه در excludedDestinations ارائه شده باشند.
excluded_destinations[]	string فهرست مقاصدی که باید برای این هدف حذف شوند (مطابق با کادرهای انتخاب نشده در Merchant Center است).
shopping_ads_excluded_countries[]	string فهرست کدهای کشور (ISO 3166-1 alpha-2) برای حذف پیشنهاد از مقصد تبلیغات خرید. کشورهای این لیست از کشورهایی که در تنظیمات منبع داده پیکربندی شده اند حذف می شوند.
lifestyle_image_links[]	string نشانی‌های وب اضافی از تصاویر سبک زندگی مورد، برای شناسایی صریح تصاویری که مورد شما را در یک زمینه دنیای واقعی به نمایش می‌گذارند استفاده می‌شود. برای اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.
cloud_export_additional_properties[]	CloudExportAdditionalProperties فیلدهای اضافی برای صادرات به برنامه Cloud Retail.
certifications[]	Certification گواهینامه های محصول، به عنوان مثال برای برچسب زدن بهینه انرژی محصولات ثبت شده در پایگاه داده EPREL اتحادیه اروپا . برای اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.
auto_pricing_min_price	Price حفاظتی در پروژه‌های «تخفیف‌های خودکار» ( https://support.google.com/merchants/answer/10295759 ) و «تبلیغات پویا» ( https://support.google.com/merchants/answer/13949249 ) که تخفیف در پیشنهادات بازرگانان کمتر از این مقدار نباشد و در نتیجه ارزش و سودآوری پیشنهاد حفظ شود.
identifier_exists	bool زمانی که مورد دارای شناسه های منحصر به فرد محصول متناسب با دسته خود، مانند GTIN، MPN و نام تجاری نباشد، این مقدار را روی false تنظیم کنید. پیش‌فرض‌ها به درست است، اگر ارائه نشده باشد.
is_bundle	bool اینکه آیا مورد بسته‌ای تعریف‌شده توسط تاجر است. باندل یک گروه بندی سفارشی از محصولات مختلف است که توسط یک تاجر به قیمت واحد فروخته می شود.
title	string عنوان مورد.
description	string توضیحات مورد.
link	string URL که مستقیماً به صفحه کالای شما در فروشگاه آنلاین شما پیوند داده می شود.
mobile_link	string URL برای نسخه بهینه شده برای موبایل صفحه فرود مورد شما.
canonical_link	string URL برای نسخه معمولی صفحه فرود مورد شما.
image_link	string URL یک تصویر از آیتم.
adult	bool اگر مورد برای بزرگسالان هدف قرار گرفته باشد، روی true تنظیم کنید.
age_group	string گروه سنی مورد نظر
availability	string وضعیت در دسترس بودن مورد
brand	string نام تجاری کالا.
color	string رنگ مورد.
condition	string وضعیت یا وضعیت مورد.
gender	string جنسیت مورد نظر
google_product_category	string دسته بندی مورد توسط Google (به طبقه بندی محصولات Google مراجعه کنید). هنگام پرس و جو از محصولات، این فیلد حاوی مقدار ارائه شده توسط کاربر خواهد بود. در حال حاضر هیچ راهی برای بازگرداندن دسته‌های محصولات Google اختصاص داده شده خودکار از طریق API وجود ندارد.
gtin	string شماره کالای تجاری جهانی ( GTIN ) مورد.
item_group_id	string شناسه مشترک برای همه انواع یک محصول.
material	string ماده ای که مورد از آن ساخته شده است.
mpn	string شماره قطعه سازنده ( MPN ) مورد.
pattern	string الگوی مورد (به عنوان مثال، نقطه پولکا).
sell_on_google_quantity	int64 مقدار محصولی که برای فروش در گوگل موجود است. فقط برای محصولات آنلاین پشتیبانی می شود.
max_handling_time	int64 حداکثر زمان رسیدگی به محصول (در روزهای کاری).
min_handling_time	int64 حداقل زمان رسیدگی به محصول (در روزهای کاری).
shipping_label	string برچسب حمل و نقل محصول که برای گروه بندی محصول در قوانین حمل و نقل در سطح حساب استفاده می شود.
transit_time_label	string برچسب زمان حمل و نقل محصول که برای گروه بندی محصول در جداول زمان حمل و نقل در سطح حساب استفاده می شود.
size	string اندازه مورد. فقط یک مقدار مجاز است. برای انواع با اندازه‌های مختلف، یک محصول جداگانه برای هر اندازه با مقدار itemGroupId یکسان درج کنید (به [https://support.google.com/merchants/answer/6324492](تعریف اندازه) مراجعه کنید).
size_system	string سیستمی که در آن اندازه مشخص شده است. برای اقلام پوشاک توصیه می شود.
tax_category	string دسته مالیات محصول، که برای پیکربندی جزئیات مالیاتی در تنظیمات مالیاتی در سطح حساب استفاده می‌شود.
energy_efficiency_class	string کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.
min_energy_efficiency_class	string کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.
max_energy_efficiency_class	string کلاس بهره وری انرژی همانطور که در دستورالعمل اتحادیه اروپا 2010/30/EU تعریف شده است.
multipack	int64 تعداد محصولات یکسان در یک بسته چندگانه تعریف شده توسط فروشنده.
ads_grouping	string برای گروه بندی موارد به روش دلخواه استفاده می شود. فقط برای CPA٪، در غیر این صورت دلسرد می شود.
ads_redirect	string به تبلیغ‌کنندگان اجازه می‌دهد تا زمانی که محصول در چارچوب تبلیغات محصول نشان داده می‌شود، نشانی وب مورد را لغو کنند.
display_ads_id	string یک شناسه برای یک مورد برای کمپین های بازاریابی مجدد پویا.
display_ads_title	string عنوان یک مورد برای کمپین های بازاریابی مجدد پویا.
display_ads_link	string URL مستقیماً به صفحه فرود مورد شما برای کمپین های بازاریابی مجدد پویا.
display_ads_value	double حاشیه پیشنهادی برای کمپین های بازاریابی مجدد پویا.
pickup_method	string گزینه pick up برای مورد.
pickup_sla	string جدول زمانی تحویل کالا از فروشگاه.
link_template	string الگوی پیوند برای ویترین فروشگاه محلی با میزبانی تاجر.
mobile_link_template	string الگوی پیوند برای ویترین فروشگاه محلی با میزبانی تاجر که برای دستگاه های تلفن همراه بهینه شده است.
custom_label_0	string برچسب سفارشی 0 برای گروه بندی سفارشی اقلام در کمپین خرید.
custom_label_1	string برچسب سفارشی 1 برای گروه بندی سفارشی اقلام در کمپین خرید.
custom_label_2	string برچسب سفارشی 2 برای گروه بندی سفارشی اقلام در کمپین خرید.
custom_label_3	string برچسب سفارشی 3 برای گروه بندی سفارشی اقلام در کمپین خرید.
custom_label_4	string برچسب سفارشی 4 برای گروه بندی سفارشی اقلام در کمپین خرید.
external_seller_id	string برای حساب های چند فروشنده مورد نیاز است. اگر در بازاری هستید که محصولاتی را برای فروشندگان مختلف در حساب چند فروشنده خود آپلود می کنید، از این ویژگی استفاده کنید.
pause	string انتشار این مورد موقتاً متوقف خواهد شد.
virtual_model_link	string URL تصویر سه بعدی مورد. برای اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.
structured_title	ProductStructuredTitle عنوان ساختاریافته، برای عناوین تولید شده به صورت الگوریتمی (AI).
structured_description	ProductStructuredDescription توصیف ساختاریافته، برای توصیفات تولید شده به صورت الگوریتمی (AI).

گواهینامه

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

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

CloudExportAdditionalProperties

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

زمینه های
text_value[]	string مقدار متنی ویژگی داده شده به عنوان مثال، "8K(UHD)" می تواند یک مقدار متنی برای یک محصول تلویزیونی باشد. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند. حداکثر اندازه رشته 256 کاراکتر است.
int_value[]	int64 مقادیر صحیح ویژگی داده شده به عنوان مثال، 1080 برای وضوح صفحه یک محصول تلویزیونی. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند.
float_value[]	float مقادیر شناور ویژگی داده شده. به عنوان مثال برای یک محصول تلویزیونی 1.2345. حداکثر تکرار این مقدار 400 است. مقادیر به ترتیب دلخواه اما ثابت ذخیره می شوند.
property_name	string نام ملک داده شده به عنوان مثال، "Resolution-Screen" برای یک محصول تلویزیونی. حداکثر اندازه رشته 256 کاراکتر است.
bool_value	bool مقدار بولی ویژگی داده شده به عنوان مثال برای یک محصول تلویزیون، اگر صفحه نمایش UHD است، «درست» یا «نادرست» است.
min_value	float حداقل مقدار شناور ویژگی داده شده. به عنوان مثال برای یک محصول تلویزیونی 1.00.
max_value	float حداکثر مقدار شناور ویژگی داده شده. به عنوان مثال برای یک محصول تلویزیونی 100.00.
unit_code	string واحد دارایی داده شده به عنوان مثال، "Pixels" برای یک محصول تلویزیونی. حداکثر اندازه رشته 256 بایت است.

DeleteProductInputRequest

درخواست پیام برای روش DeleteProductInput.

زمینه های
name	string ضروری. نام منبع ورودی محصول برای حذف. قالب: حساب‌ها/{account}/productInputs/{product}
data_source	string ضروری. منبع داده اولیه یا تکمیلی که ورودی محصول باید از آن حذف شود. قالب: accounts/{account}/dataSources/{datasource} .

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

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

زمینه های
country	string کد قلمرو CLDR کشوری که یک کالا به آن ارسال می شود.
price_threshold	Price حداقل قیمت محصول برای هزینه ارسال رایگان است. به عنوان یک عدد نشان داده شده است.

GetProductRequest

درخواست پیام برای متد GetProduct.

زمینه های
name	string ضروری. نام محصول برای بازیابی قالب: accounts/{account}/products/{product}

InsertProductInputRequest

درخواست پیام برای روش InsertProductInput.

زمینه های
parent	string ضروری. حسابی که این محصول در آن درج خواهد شد. قالب: حساب‌ها/{حساب}
product_input	ProductInput ضروری. ورودی محصول برای درج.
data_source	string ضروری. نام منبع داده محصول اولیه یا تکمیلی. اگر محصول از قبل وجود داشته باشد و منبع داده ارائه شده متفاوت باشد، محصول به منبع داده جدیدی منتقل می شود. قالب: accounts/{account}/dataSources/{datasource} .

قسط

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

زمینه های
months	int64 تعداد اقساطی که خریدار باید بپردازد.
amount	Price مبلغی که خریدار باید در ماه بپردازد.
downpayment	Price مبلغ پیش پرداختی که خریدار باید بپردازد.
credit_type	string نوع پرداخت اقساطی. مقادیر پشتیبانی شده عبارتند از: * " finance " * " lease "

ListProductsRequest

درخواست پیام برای متد ListProducts.

زمینه های
parent	string ضروری. حسابی برای فهرست محصولات پردازش شده قالب: حساب‌ها/{حساب}
page_size	int32 حداکثر تعداد محصولات برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 تبدیل می شود. اگر مشخص نشده باشد، حداکثر تعداد محصولات برگردانده می شود.
page_token	string یک نشانه صفحه، دریافت شده از تماس قبلی ListProducts . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListProducts باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListProductsResponse

پیام پاسخ برای متد ListProducts.

زمینه های
products[]	Product محصولات پردازش شده از حساب مشخص شده اینها محصولات پردازش شده شما پس از اعمال قوانین و منابع داده تکمیلی هستند.
next_page_token	string یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

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

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

زمینه های
name	string نام برنامه امتیاز وفاداری. توصیه می شود نام را به 12 کاراکتر تمام عرض یا 24 کاراکتر رومی محدود کنید.
points_value	int64 امتیاز وفاداری خرده فروش به ارزش مطلق.
ratio	double نسبت یک نقطه هنگام تبدیل به ارز. Google ارز را بر اساس تنظیمات Merchant Center فرض می‌کند. اگر نسبت حذف شود، به طور پیش فرض روی 1.0 قرار می گیرد.

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

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

زمینه های
program_label	string برچسب برنامه وفاداری. این یک برچسب داخلی است که به طور منحصر به فرد رابطه بین یک نهاد تجاری و یک نهاد برنامه وفاداری را مشخص می کند. برچسب باید ارائه شود تا سیستم بتواند دارایی های زیر (مثلاً قیمت و امتیاز) را با یک تاجر مرتبط کند. برنامه مربوطه باید به حساب تاجر مرتبط باشد.
tier_label	string برچسب ردیف در برنامه وفاداری. باید با یکی از برچسب های داخل برنامه مطابقت داشته باشد.
price	Price قیمت برای اعضای ردیف داده شده، یعنی قیمت تخفیف فوری. باید کوچکتر یا برابر با قیمت معمولی باشد.
cashback_for_future_use	Price بازگشت نقدی که می تواند برای خریدهای بعدی استفاده شود.
loyalty_points	int64 میزان امتیازات وفاداری کسب شده در خرید.

تولید - محصول

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

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

زمینه های
name	string نام محصول. قالب: "{product.name=accounts/{account}/products/{product}}"
channel	ChannelEnum فقط خروجی کانال محصول
offer_id	string فقط خروجی شناسه منحصر به فرد شما برای محصول. این برای ورودی محصول و محصول فرآوری شده یکسان است. فضاهای سفید پیشرو و انتهایی حذف می شوند و پس از ارسال، چندین فاصله سفید با یک فضای خالی واحد جایگزین می شوند. برای جزئیات بیشتر به مشخصات داده های محصول مراجعه کنید.
content_language	string فقط خروجی کد زبان دو حرفی ISO 639-1 برای محصول.
feed_label	string فقط خروجی برچسب خوراک برای محصول
data_source	string فقط خروجی منبع داده اولیه محصول
attributes	Attributes فقط خروجی لیستی از ویژگی های محصول
custom_attributes[]	CustomAttribute فقط خروجی فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین می‌توان از آن برای ارسال هر ویژگی مشخصات داده به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به‌صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است.
product_status	ProductStatus فقط خروجی وضعیت یک محصول، مسائل مربوط به اعتبارسنجی داده ها، یعنی اطلاعات مربوط به یک محصول که به صورت ناهمزمان محاسبه شده است.
version_number	int64 فقط خروجی نشان دهنده نسخه موجود (تازه بودن) محصول است که می توان از آن برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده کرد. در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی محصول موجود باشد، از درج جلوگیری می شود. قرار دادن مجدد (به عنوان مثال، بازخوانی محصول پس از 30 روز) را می توان با version_number فعلی انجام داد. فقط برای درج در منابع داده اولیه پشتیبانی می شود. اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

جزئیات محصول

جزئیات محصول

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

ابعاد محصول

ابعاد محصول.

زمینه های
value	double ضروری. مقدار بعد به عنوان یک عدد نشان داده شده است. مقدار می تواند حداکثر دقت چهار رقم اعشار داشته باشد.
unit	string ضروری. واحدهای بعد مقادیر قابل قبول عبارتند از: * " in " * " cm "

ورودی محصول

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

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

ویژگی‌های زیر مورد نیاز است: [feedLabel][google.shopping.content.bundles.Products.feed_label]، [contentLanguage][google.shopping.content.bundles.Products.content_language] و [offerId][google.shopping.content. bundles.Products.offer_id].

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

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

زمینه های
name	string مشخص کننده. نام ورودی محصول قالب: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product	string فقط خروجی نام محصول فرآوری شده قالب: "{product.name=accounts/{account}/products/{product}}"
channel	ChannelEnum ضروری. تغییرناپذیر. کانال محصول
offer_id	string ضروری. تغییرناپذیر. شناسه منحصر به فرد شما برای محصول. این برای ورودی محصول و محصول فرآوری شده یکسان است. فضاهای سفید پیشرو و انتهایی حذف می شوند و پس از ارسال، چندین فاصله سفید با یک فضای خالی واحد جایگزین می شوند. برای جزئیات به مشخصات داده های محصولات مراجعه کنید.
content_language	string ضروری. تغییرناپذیر. کد زبان دو حرفی ISO 639-1 برای محصول.
feed_label	string ضروری. تغییرناپذیر. برچسب خوراک برای محصول
attributes	Attributes اختیاری. لیستی از ویژگی های محصول
custom_attributes[]	CustomAttribute اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین می‌توان از آن برای ارسال هر ویژگی از مشخصات داده‌ها به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به‌صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است. حداکثر تعداد مجاز کاراکتر برای هر ویژگی سفارشی 10240 است (نماینده مجموع کاراکترها برای نام و مقدار). حداکثر 2500 ویژگی سفارشی را می توان برای هر محصول با حجم کل 102.4 کیلوبایت تنظیم کرد. زیرخط در نام ویژگی های سفارشی پس از درج با فاصله جایگزین می شود.
version_number	int64 اختیاری. نشان دهنده نسخه موجود (تازه بودن) محصول است که می توان از آن برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده کرد. در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی محصول موجود باشد، از درج جلوگیری می شود. قرار دادن مجدد (به عنوان مثال، بازخوانی محصول پس از 30 روز) را می توان با version_number فعلی انجام داد. فقط برای درج در منابع داده اولیه پشتیبانی می شود. اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

وضعیت محصول

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

زمینه های
destination_statuses[]	DestinationStatus مقاصد مورد نظر برای محصول
item_level_issues[]	ItemLevelIssue لیستی از تمام مشکلات مرتبط با محصول.
creation_date	Timestamp تاریخ ایجاد آیتم در قالب ISO 8601 .
last_update_date	Timestamp تاریخ آخرین به روز رسانی مورد در قالب ISO 8601 .
google_expiration_date	Timestamp تاریخ انقضای کالا در قالب ISO 8601 .

وضعیت مقصد

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

زمینه های
reporting_context	ReportingContextEnum نام زمینه گزارش.
approved_countries[]	string فهرست کدهای کشور (ISO 3166-1 alpha-2) که پیشنهاد مورد تایید قرار گرفته است.
pending_countries[]	string فهرست کدهای کشور (ISO 3166-1 alpha-2) که پیشنهاد در انتظار تأیید است.
disapproved_countries[]	string فهرست کدهای کشوری (ISO 3166-1 alpha-2) که در آن پیشنهاد رد شده است.

ItemLevelIssue

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

زمینه های
code	string کد خطای مشکل
severity	Severity چگونه این موضوع بر ارائه پیشنهاد تأثیر می گذارد.
resolution	string اینکه آیا این موضوع توسط تاجر قابل حل است یا خیر.
attribute	string نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.
reporting_context	ReportingContextEnum زمینه گزارش دهی که این مسئله در مورد آن اعمال می شود.
description	string شرح مختصر موضوع به زبان انگلیسی.
detail	string شرح مفصل موضوع به زبان انگلیسی.
documentation	string URL یک صفحه وب برای کمک به حل این مشکل.
applicable_countries[]	string فهرست کدهای کشور (ISO 3166-1 alpha-2) که در آن مشکل برای پیشنهاد اعمال می شود.

شدت

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

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

ProductStructuredDescription

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

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

ProductStructuredTitle

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

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

وزن محصول

وزن محصول.

زمینه های
value	double ضروری. وزن به عنوان یک عدد نشان داده شده است. وزن می تواند حداکثر دقت چهار رقم اعشار داشته باشد.
unit	string ضروری. واحد وزن. مقادیر قابل قبول عبارتند از: * " g " * " kg " * " oz " * " lb "

حمل دریایی

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

زمینه های
price	Price قیمت ثابت حمل و نقل، به عنوان یک عدد نشان داده شده است.
country	string کد قلمرو CLDR کشوری که یک کالا به آن ارسال می شود.
region	string منطقه جغرافیایی که نرخ حمل و نقل برای آن اعمال می شود. برای اطلاعات بیشتر به منطقه مراجعه کنید
service	string شرح رایگان کلاس خدمات یا سرعت تحویل.
location_id	int64 شناسه عددی مکانی که نرخ حمل و نقل برای آن اعمال می‌شود، همانطور که در API AdWords تعریف شده است.
location_group_name	string مکانی که حمل و نقل در آن قابل اجرا است، که با نام گروه مکان نشان داده شده است.
postal_code	string محدوده کد پستی که نرخ حمل و نقل برای آن اعمال می شود، که با یک کد پستی، یک پیشوند کد پستی به دنبال علامت *، محدوده بین دو کد پستی یا دو پیشوند کد پستی با طول مساوی نشان داده می شود.
min_handling_time	int64 حداقل زمان رسیدگی (شامل) بین زمان دریافت سفارش و ارسال در روزهای کاری. 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] وجود داشته باشد، لازم نیست.
max_handling_time	int64 حداکثر زمان رسیدگی (شامل) بین زمان دریافت سفارش و ارسال در روزهای کاری. 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] وجود داشته باشد.
min_transit_time	int64 حداقل زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 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] وجود داشته باشد، لازم نیست.
max_transit_time	int64 حداکثر زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 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] وجود داشته باشد.

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

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

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

وزن حمل و نقل

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

زمینه های
value	double وزن محصول مورد استفاده برای محاسبه هزینه حمل و نقل کالا.
unit	string واحد ارزش.

هزینه اشتراک

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

زمینه های
period	SubscriptionPeriod نوع دوره اشتراک. مقادیر پشتیبانی شده عبارتند از: * " month " * " year "
period_length	int64 تعداد دوره های اشتراکی که خریدار باید بپردازد.
amount	Price مبلغی که خریدار باید در هر دوره اشتراک بپردازد.

دوره اشتراک

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

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

مالیات

مالیات محصول

زمینه های
rate	double درصد نرخ مالیاتی که بر قیمت کالا اعمال می شود.
country	string کشوری که در آن کالا مشمول مالیات است، به عنوان کد قلمرو CLDR مشخص شده است.
region	string منطقه جغرافیایی که نرخ مالیات بر آن اعمال می شود.
tax_ship	bool اگر برای حمل و نقل مالیات دریافت می شود، روی true تنظیم کنید.
location_id	int64 شناسه عددی مکانی که نرخ مالیات بر آن اعمال می‌شود، همانطور که در API AdWords تعریف شده است.
postal_code	string محدوده کد پستی که نرخ مالیات بر آن اعمال می‌شود، که با کد پستی، پیشوند کد پستی با استفاده از علامت *، محدوده بین دو کد پستی یا دو پیشوند کد پستی با طول مساوی نشان داده می‌شود. مثال: 94114، 94*، 94002-95460، 94*-95*.

UnitPricingBaseMeasure

UnitPricingBaseMeasure محصول.

زمینه های
value	int64 مخرج قیمت واحد.
unit	string واحد مخرج.

UnitPricingMeasure

UnitPricingMeasure محصول.

زمینه های
value	double اندازه گیری یک مورد.
unit	string واحد اندازه گیری.