Package google.shopping.merchant.products.v1beta

شاخص

ProductInputsService

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

DeleteProductInput

rpc DeleteProductInput( DeleteProductInputRequest ) returns ( Empty )

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

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

InsertProductInput

rpc InsertProductInput( InsertProductInputRequest ) returns ( ProductInput )

ورودی محصول را در حساب Merchant Center شما آپلود می کند. اگر ورودی با همان contentLanguage، offerId و dataSource از قبل وجود داشته باشد، این روش جایگزین آن ورودی می شود.

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

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

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

GetProduct

rpc GetProduct( GetProductRequest ) returns ( Product )

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

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

لیست محصولات

rpc ListProducts( ListProductsRequest ) returns ( ListProductsResponse )

محصولات پردازش شده را در حساب Merchant Center شما فهرست می کند. پاسخ ممکن است حاوی موارد کمتری نسبت به اندازه صفحه باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید.

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

صفات

صفات.

فیلدها
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 در دسترس قرار می‌گیرد.

gtin[]

string

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

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) برای حذف پیشنهاد از مقصد تبلیغات خرید. کشورهای این لیست از کشورهایی که در تنظیمات منبع داده پیکربندی شده اند حذف می شوند.

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 ) که تضمین می‌کند تخفیف‌ها در پیشنهادهای تاجران از ارزش و ارزش پیشنهادی بازرگانان پایین‌تر از این نمی‌شود.

sustainability_ incentives[]

ProductSustainabilityIncentive

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

identifier_ exists

bool

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

is_ bundle

bool

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

title

string

عنوان مورد.

description

string

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

adult

bool

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

age_ group

string

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

availability

string

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

brand

string

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

color

string

رنگ مورد.

condition

string

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

gender

string

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

google_ product_ category

string

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

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_ value

double

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

pickup_ method

string

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

pickup_ sla

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

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

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} که در آن product آخرین بخش از 4 بخش تشکیل شده است: channel~content_language~feed_label~offer_id مثال برای نام محصول "accounts/123/productInputs/online~en~US~sku123" است.

data_ source

string

مورد نیاز. منبع داده اولیه یا تکمیلی که ورودی محصول باید از آن حذف شود. قالب: accounts/{account}/dataSources/{datasource} .

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

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

فیلدها
country

string

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

price_ threshold

Price

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

GetProductRequest

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

فیلدها
name

string

مورد نیاز. نام محصول برای بازیابی قالب: accounts/{account}/products/{product} که در آن product آخرین بخش از 4 بخش تشکیل شده است: channel~content_language~feed_label~offer_id مثال برای نام محصول "accounts/123/products/online~en~US~sku123" است.

InsertProductInputRequest

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

فیلدها
parent

string

مورد نیاز. حسابی که این محصول در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

product_ input

ProductInput

مورد نیاز. ورودی محصول برای درج.

data_ source

string

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

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

قالب: accounts/{account}/dataSources/{datasource} .

قسط

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

فیلدها
months

int64

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

amount

Price

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

downpayment

Price

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

credit_ type

string

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

ListProductsRequest

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

فیلدها
parent

string

مورد نیاز. حسابی برای فهرست محصولات پردازش شده قالب: حساب‌ها/{حساب}

page_ size

int32

حداکثر تعداد محصولات برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. حداکثر مقدار 250 است. مقادیر بالای 250 اجباری به 250 می شود. اگر مشخص نباشد، حداکثر تعداد محصولات برگردانده می شود.

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

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

member_ price_ effective_ date

Interval

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

shipping_ label

string

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

محصول

محصول پردازش شده، از چندین product inputs پس از اعمال قوانین و منابع داده تکمیلی ساخته شده است. این محصول پردازش شده با آنچه در حساب Merchant Center شما و در تبلیغات خرید و سایر سطوح در سراسر Google نشان داده شده است مطابقت دارد. هر محصول دقیقاً از یک ورودی محصول منبع داده اولیه و چندین ورودی منبع داده تکمیلی ساخته شده است. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده به‌روز شده بازیابی شود.

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

فیلدها
name

string

نام محصول. قالب: "{product.name=accounts/{account}/products/{product}}" که در آن product آخرین بخش از 4 بخش تشکیل شده است: channel~content_language~feed_label~offer_id مثال برای نام محصول "accounts/123/products/online~en~US~sku123" است.

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 پردازش شده ترکیب می شوند.

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

ویژگی‌های زیر مورد نیاز است: feedLabel ، contentLanguage و offerId .

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

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

فیلدها
name

string

شناسه. نام ورودی محصول قالب: "{productinput.name=accounts/{account}/productInputs/{productinput}}" که در آن آخرین بخش productinput از 4 قسمت تشکیل شده است: channel~content_language~feed_label~offer_id برای نام ورودی محصول به عنوان مثال "accounts/123/productInputs/online~en~US"~sku1 است.

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 فیلد اتحادیه ارزش تشویقی پایداری value فقط می تواند یکی از موارد زیر باشد:
amount

Price

مقدار ثابت مشوق

percentage

double

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

type

Type

برنامه تشویقی پایداری

تایپ کنید

انواع برنامه های تشویقی پایداری حمایت شده

Enums
TYPE_UNSPECIFIED نوع مشوق پایداری نامشخص یا ناشناخته.
EV_TAX_CREDIT برنامه کاهش بدهی مالیاتی برای وسایل نقلیه الکتریکی و در برخی کشورها، پلاگین هیبریدی. این کاهش ها می تواند بر اساس مقدار مشخص یا درصدی از قیمت فروش باشد.
EV_PRICE_DISCOUNT یک برنامه یارانه ای که اغلب جایزه زیست محیطی نامیده می شود، کمک هزینه ای را برای خرید خودروهای الکتریکی و در برخی کشورها برای خودروهای هیبریدی پلاگین فراهم می کند. مبلغ کمک هزینه ممکن است مبلغ ثابت یا درصدی از قیمت فروش باشد.

وزن محصول

وزن محصول.

فیلدها
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 فقط می تواند همراه با maxHandlingTime وجود داشته باشد. اما در صورت وجود maxHandlingTime لازم نیست.

max_ handling_ time

int64

حداکثر زمان رسیدگی (شامل) بین زمان دریافت سفارش و ارسال در روزهای کاری. 0 به این معنی است که اگر سفارش قبل از زمان قطعی اتفاق بیفتد، در همان روز دریافت ارسال می شود. در صورت ارائه سرعت حمل و نقل، هر دو maxHandlingTime و maxTransitTime مورد نیاز هستند. اگر maxHandlingTime وجود داشته باشد minHandlingTime اختیاری است.

min_ transit_ time

int64

حداقل زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 0 به این معنی است که سفارش در همان روز تحویل تحویل می شود. minTransitTime فقط می تواند همراه با maxTransitTime وجود داشته باشد. اما اگر maxTransitTime وجود داشته باشد، لازم نیست.

max_ transit_ time

int64

حداکثر زمان حمل و نقل (شامل) از زمان ارسال سفارش تا زمانی که در روزهای کاری تحویل می شود. 0 به این معنی است که سفارش در همان روز تحویل تحویل می شود. در صورت ارائه سرعت حمل و نقل، هر دو maxHandlingTime و maxTransitTime مورد نیاز هستند. اگر maxTransitTime وجود داشته باشد minTransitTime اختیاری است.

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

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

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

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

postal_ code

string

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

UnitPricingBaseMeasure

UnitPricingBaseMeasure محصول.

فیلدها
value

int64

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

unit

string

واحد مخرج.

UnitPricingMeasure

UnitPricingMeasure محصول.

فیلدها
value

double

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

unit

string

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