یادداشت‌های انتشار (نسخه 2.1)

خدمات پشتیبانی بازرگان

26 مه 2025

خدمات حساب ها

اکنون امکان افزودن کاربران فقط خواندنی به حساب ها وجود دارد.

14 آوریل 2025

خدمات حساب ها

از آنجایی که این دیگر در آینده الزامی نخواهد بود، خدمات accounttax منسوخ شده است.

17 مارس 2025

خدمات مرتبط با سفارشات

به عنوان بخشی از تعطیلی API های مربوط به سفارشات ، سرویس های زیر منسوخ شده اند:

• accounts.verifyphonenumber
• returnpolicy

سایر خدمات

این نقطه پایانی دیگر مورد نیاز نیست و می توان آن را منسوخ کرد:

• pubsubnotificationsettings

10 فوریه 2025

فیلدهای prerendered_out_of_court_dispute_settlement به ProductIssue و AccountIssue اضافه شد.

فیلدهای alternate_dispute_resolution از RenderProductIssuesResponse و RenderAccountIssuesResponse منسوخ شده است.

12 دسامبر 2024

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

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

15 نوامبر 2024

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

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

30 اکتبر 2024

خدمات مربوط به تسویه حساب

به عنوان بخشی از تعطیلی APIهای مربوط به تسویه حساب، سرویس‌های زیر منسوخ شده‌اند:

• settlementreports
• settlementtranscations

خاموش شدن APIهای مربوط به تسویه حساب مربوط به برنامه BuyOnGoogle که قبلاً بسته شده بود و APIهای مربوط به سفارشات.

انتظار می‌رود تماس‌ها با سرویس‌های فوق‌الذکر با شکست Service was not found on the server شکست بخورد.

16 اکتبر 2024

update_mask در UpdateConversionSourceRequest اکنون OPTIONAL است. اگر ماسک به‌روزرسانی مشخص نشده باشد، تمام فیلدهایی که دارای مقدار غیر خالی هستند به‌روزرسانی می‌شوند.

26 اوت 2024 (زودتر از آنچه در ابتدا اعلام شده بود)

خدمات مرتبط با سفارشات

به عنوان بخشی از تعطیلی API های مربوط به سفارشات ، سرویس های زیر منسوخ شده اند:

• orderinvoices
• orderreports
• orderreturns
• orderreturns.labels
• orders

انتظار می‌رود تماس‌ها با سرویس‌های فوق‌الذکر با شکست Service was not found on the server شکست بخورد.

سرویس OrderTrackingSignals منسوخ نشده است و همچنان در دسترس است.

10 آگوست 2024

از خدمات Google خرید کنید

به‌عنوان بخشی از خاموش کردن APIهای Buy on Google، همه روش‌های موجود در BuyOnGoogleProgramService با شکست مواجه می‌شوند، زیرا service was not found on the server .

19 جولای 2024

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

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

20 مه 2024

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

LoyaltyPrograms اضافه شد. این به‌روزرسانی به شما امکان می‌دهد چندین سطح با امتیازات وفاداری، قیمت‌ها و غیره متفاوت برای یک محصول ارائه کنید. شما باید از این فیلد به جای فیلد LoyaltyProgram مفرد استفاده کنید.

سرویس گزارشات

معیارهای خرید در Google منسوخ در جدول MerchantPerformanceView . پس از این به‌روزرسانی، بازیابی هر متریک Buy on Google 0 را برمی‌گرداند. این در مورد مقادیر تاریخی تاریخ‌های گذشته نیز صدق می‌کند.

برای اطلاعات بیشتر، خرید در Google منسوخ را ببینید.

13 مه 2024

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

منبع محصول

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

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

6 مه 2024

سرویس گزارشات

سطل اثربخشی به جدول PriceInsightsProductView اضافه شد. اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی افزایش عملکرد پیش بینی شده با تعدیل قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی را در نظر می گیرد.

24 آوریل 2024

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

منبع محصول

فیلدهای downpayment اختیاری و creditType برای پرداخت های اقساطی اضافه شد:

• downpayment مبلغی را فراهم می کند که خریدار باید به عنوان یک بار پرداخت پیش پرداخت کند.
• creditType نوع پرداخت اقساط ( finance یا lease ) را ارائه می دهد. این فیلد فقط برای تبلیغات خودرو کاربرد دارد.

11 آوریل 2024

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

منبع محصول

• ویژگی آستانه حمل و نقل رایگان ( FreeShippingThreshold ) برای حمل و نقل در سطح پیشنهاد اضافه شد. این ویژگی به بازرگانان اجازه می‌دهد حداقل قیمت محصول را برای رایگان شدن هزینه ارسال وارد کنند.
• نمایان بودن LoyaltyPoints را تغییر داد

10 آوریل 2024

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

منبع محصول

LoyaltyProgram اضافه شد

9 آوریل 2024

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

منبع محصول

برای ارائه عناوین و توضیحات محصول تولید شده توسط هوش مصنوعی structuredTitle و structuredDescription اضافه شد.

3 آوریل 2024

خدمات پشتیبانی بازرگان

فیلد user_input_action_option اضافه شد که به شرکا اجازه می‌دهد نوع جدیدی از اقدام را درخواست کنند: BuiltInUserInputAction . این اقدام به شرکا اجازه می‌دهد تا به‌جای هدایت مجدد به Merchant Center، مستقیماً در برنامه‌های کاربردی خود، برای بازرگانان، قابلیت‌های خود-خدمت پیچیده ایجاد کنند.

یک روش TriggerAction جدید برای BuiltInUserInputAction اضافه کرد. برای دسترسی به این روش، درخواستی را به این فرم ارسال کنید.

27 مارس 2024

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

منبع محصول

AutoPricingMinPrice به عنوان محافظی در پروژه‌های «تخفیف‌های خودکار» و «تبلیغات پویا» اضافه شده است، و تضمین می‌کند که تخفیف‌های پیشنهادی تاجران قیمت محصول را به کمتر از این مقدار کاهش نمی‌دهد. بدین ترتیب ارزش و سودآوری پیشنهاد حفظ می شود.

15 مارس 2024

Sunset Buy در Google برای جستجو و خرید. با استفاده از orders.list و orders.get می‌توانید تا 31 اکتبر 2024 به مشاهده سفارش‌های موجود ادامه دهید.

8 مارس 2024

سرویس گزارشات

گزارش TopicTrendsView به سرویس Reports اضافه شد.

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

6 مارس 2024

سرویس گزارشات

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

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

19 فوریه 2024

خدمات ConversionSources

مقادیر زیر را به عنوان منابع تبدیل معتبر حذف کرد:

• CROSS_CHANNEL_FIRST_CLICK
• CROSS_CHANNEL_LINEAR
• CROSS_CHANNEL_POSITION_BASED
• CROSS_CHANNEL_TIME_DECAY

گزینه های 60 و 90 را به عنوان روزهای پنجره نگاه حذف کرد و 40 را به عنوان گزینه معتبر اضافه کرد.

17 ژانویه 2024

سرویس POS

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

11 ژانویه 2024

خدمات حساب ها

برای روش link به ترتیب localProductManager و localProductManagement به عنوان نوع پیوند و سرویس اضافه شد. اینها به حساب ها اجازه می دهد تا با هدف مدیریت داده های محصول محلی پیوند بخورند.

29 نوامبر 2023

خدمات پشتیبانی بازرگان

نوع اقدام خارجی VERIFY_IDENTITY_IN_MERCHANT_CENTER برای تأیید هویت که باید در Merchant Center انجام شود اضافه شد.

سرویس POS

فیلدهای matching_status و matching_status_hint به PosStore اضافه شد که به کاربران امکان می‌دهد وضعیت تطبیق Pos Store با فروشگاه نمایه کسب‌وکار Google را بدانند و در صورت بروز مشکل، راهنمایی‌هایی را برای رفع آن ارائه دهند.

15 نوامبر 2023

نقاط پایانی repricingrules و repricingrules.repricingreports دیگر پشتیبانی نمی شوند.

1 نوامبر 2023

خدمات تنظیمات حمل و نقل

shipment_type=pickup دیگر پشتیبانی نمی شود.

18 اکتبر 2023

خدمات حساب ها

فیلد Business Identity اضافه شد که به بازرگانان اجازه می‌دهد تا ارزش‌های مصرف‌کننده خاصی را شناسایی کنند.

10 اکتبر 2023

Collection Point به عنوان یک نوع حمل و نقل جدید از خدمات تنظیمات حمل و نقل اضافه شد. تحویل نقطه جمع آوری خدماتی است که توسط شخص ثالث (مثلاً غیر متعلق به تاجر) برای تحویل کالا به مکان وابسته به شخص ثالث (مانند نقاط دسترسی UPS)، به جای تحویل مستقیم به خانه ارائه می شود.

18 سپتامبر 2023

سرویس تنظیمات LIA

روش setOmnichannelExperience اضافه شد تا به کاربران اجازه دهد تجربه همه‌کانالی خود را تنظیم کنند (یعنی تنظیمات محلی و ویترین فروشگاه). تا این زمان، این فقط برای کاربرانی در دسترس است که ارائه دهنده POS آنها برای فعال کردن چنین تنظیماتی مورد اعتماد است.

7 سپتامبر 2023

خرید در گوگل منسوخ شده

افزودن وضعیت DEPRECATED جدید به روش GetBuyOnGoogleProgramStastus . فعال سازی مجدد یا توقف مجدد برنامه از چنین حالتی امکان پذیر نیست.

4 سپتامبر 2023

خدمات پشتیبانی بازرگان

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

28 اوت 2023

خدمات تبلیغاتی

باز کردن روش list در سرویس Promotions از دسترسی محدود به همه.

22 اوت 2023

خدمات پشتیبانی بازرگان

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

4 آگوست 2023

سرویس گزارشات

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

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

25 جولای 2023

سرویس POS

منبع موجودی

فیلدهای pickup_method و pickup_sla را اضافه کنید تا امکانی را برای بازرگانان فراهم کنید تا اطلاعات پیکاپ را همراه با موجودی خود ارسال کنند.

14 جولای 2023

سرویس گزارشات

گزارش‌های دید رقابتی به سرویس گزارش‌ها اضافه شد.

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

7 جولای 2023

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

منبع محصول

افزودن virtualModelLink برای ارائه URL به تصویر مدل سه بعدی.

4 جولای 2023

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

منبع محصول

فیلد certifications برای ارائه گواهی‌های محصول اضافه کنید، به عنوان مثال برای برچسب‌گذاری کارایی انرژی محصولات بر اساس پایگاه داده EU EPREL .

26 ژوئن 2023

خدمات تنظیمات حمل و نقل

تحقق محلی

فیلد no_delivery_post_cutoff اضافه شد تا به بازرگانان اجازه دهد از نمایش n+1 روز تحویل محلی انصراف دهند، هنگامی که سرویس حمل و نقل را برای n روز تحویل محلی پیکربندی کرده‌اند.

29 مه 2023

خدمات تبلیغاتی

روش list برای سرویس Promotions اضافه شد.

خدمات توصیه

رد کردن تعامل را در روش ReportInteraction سرویس توصیه‌ها فعال کنید.

9 مه 2023

مقصد خرده فروشی ابری

ویژگی های اضافی خرده فروشی ابر

فیلد ویژگی های اضافی خرده فروشی ابر را اضافه کنید. این یک فیلد تکراری است که برای استفاده توسط مشتریانی که از مقصد خرده فروشی ابری استفاده می کنند، در نظر گرفته شده است. هنگامی که از این فیلد استفاده می شود، هنگام استفاده از برنامه خرده فروشی ابری در دسترس خواهد بود. این به قسمت ویژگی‌ها در مدل محصول Google Cloud Retail نگاشت می‌شود.

22 مه 2023

خدمات تبلیغاتی

روش list برای سرویس Promotions اضافه شد.

11 آوریل 2023

خدمات تنظیمات حمل و نقل

تحقق محلی

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

3 آوریل

سرویس توصیه ها

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

20 فوریه 2023

خدمات حساب ها

منبع حساب

یک بخش جدید Account.ConversionSettings در منبع حساب‌ها اضافه شد.

خدمات ConversionSources

سرویس منابع تبدیل را اضافه کرد که از مدیریت منابع تبدیل (بخشی از بخش تنظیمات تبدیل در Merchant Center) پشتیبانی می کند.

16 فوریه 2023

خدمات تنظیمات حمل و نقل

اعتبار سنجی کد فروشگاه

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

اعتبار سنجی تجاری LIA

برنامه‌هایی که شناسه بازرگان در آنها ثبت شده است، اکنون قبل از به‌روزرسانی تنظیمات حمل و نقل، اعتبارسنجی می‌شوند. بازرگانان باید در یکی از برنامه های زیر باشند:

• LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
• LOCAL_INVENTORY_ADS

9 فوریه 2023

خدمات تبلیغاتی

خدمات تبلیغاتی را به 6 گزینه دیگر targetCountry با پشتیبانی contentLanguage محلی زبان گسترش دهید.:

• BR
• ES
• NL
• JP
• IT
• KR

12 ژانویه 2023

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

منبع محصول

lifestyleImageLinks برای ارائه URL به تصاویر سبک زندگی اضافه شده است.

24 نوامبر 2022

خدمات ارتقاء

یک فیلد جدید «وضعیت ارتقاء» در بخش Promotions.PromotionStatus اضافه شد. این یک فیلد فقط خواندنی است.

15 نوامبر 2022

سرویس گزارشات

گزارش‌های Market Insights به سرویس Reports اضافه شد.

اکنون می توانید از سرویس گزارش ها برای موارد زیر پرس و جو کنید:

• بهترین فروشندگان با استفاده از جداول BestSellersProductClusterView و BestSellersBrandView گزارش می دهند.
• گزارش رقابت قیمت با استفاده از جدول PriceCompetitivenessProductView .
• اطلاعات آماری قیمت را با استفاده از جدول PriceInsightsProductView گزارش کنید.

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

7 نوامبر 2022

سرویس Datafeeds

پشتیبانی feedLabel برای سرویس Datafeeds اضافه شد.

14 سپتامبر 2022

feedLabel برای پذیرش هر رشته ای به روز کرد.

9 اوت 2022

feedLabel برای محصولات اضافه شد.

اکنون می توانید از feedLabel به جای targetCountry برای تعیین کشور برای شناسه های پیشنهاد استفاده کنید. شناسه‌های پیشنهاد اکنون به صورت online:language:feedLabel:offerId ساخته شده‌اند.

feedLabel به طور خودکار با مقدار targetCountry شما برای فیدهای موجود برای سازگاری با عقب پر شده است.

targetCountry منسوخ شده

برای پشتیبانی از پیشنهادات جهانی، Content API برای خرید، قسمت targetCountry را منسوخ کرده است. در عوض، توصیه می کنیم از قسمت shipping برای مشخص کردن کشورهای هدف خود استفاده کنید.

targetCountry اکنون به طور خودکار با مقداری که در feedLabel ارائه می‌کنید پر می‌شود.

هشدار: مقادیر backfilled targetCountry بر اساس ارسال feedLabel شما، پیشنهادات شما را قادر نمی‌سازد در کشور مشخص‌شده در feedLabel ارائه شوند. از shipping استفاده کنید تا مطمئن شوید که پیشنهادات شما قادر به ارائه در کشورهای مورد نظر شما هستند.

برای جزئیات بیشتر به پست وبلاگ مراجعه کنید. برچسب فید جایگزین کشور هدف در Content API for Shopping می شود .

8 دسامبر 2021

خدمات حساب ها

منبع حساب

یک بخش جدید Account.Automatic Improvements در منبع حساب ها اضافه شد.

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

25 اکتبر 2021

خدمات ارتقاء

افزودن Get Promotion به API Promotion.

11 اکتبر 2021

API تنظیمات حمل و نقل

فیلد warehouse جدید در منبع ShippingSettings اضافه شد تا به بازرگانان اجازه دهد تا انبارهایی را مدیریت کنند که می‌توانند در WarehouseBasedDeliveryTime استفاده شوند.

فیلد warehouseName جدید را در WarehouseBasedDeliveryTime اضافه کنید تا به انبار بر اساس نام انبار مراجعه کنید.

4 اکتبر 2021

خدمات حساب ها

منبع حساب

یک فیلد جدید "phone_verification_status" در بخش Accounts.BusinessInformation اضافه شد. این یک فیلد فقط خواندنی است که توسط Accounts.VerifyPhoneNumber تنظیم شده است.

13 سپتامبر 2021

سرویس BuyOnGooglePrograms

منبع BuyOnGoogleProgramStatus

فیلدهای جدیدی در منبع BuyOnGooglePrograms.BuyOnProgramStatus اضافه شد: کانال‌های فروش آنلاین، مدل‌های تجاری و تلفن خدمات مشتری.

روش جدید UpdateBuyOnGoogleProgramStatus

یک روش UpdateBuyOnGoogleProgramStatus جدید اضافه شده است که به شما امکان به روز رسانی منبع توسعه یافته BuyOnGooglePrograms.BuyOnProgramStatus را می دهد.

6 سپتامبر 2021

خدمات حساب ها

منبع حساب

یک فیلد جدید 'korean_business_registration_number' در بخش Accounts.BusinessInformation اضافه شد. این فیلد فقط در صورتی پاک می شود که به طور صریح روی یک رشته خالی تنظیم شود.

30 اوت 2021

خدمات ارتقاء

یک سرویس تبلیغاتی جدید با Insert Promotion در دسترس اضافه شد.

خدمات سفارشات

روش جدیدی اضافه شد orders/captureOrder برای گرفتن وجوه قبل از ارسال.

دلیل لغو سفارش جدید FAILED_TO_CAPTURE_FUNDS

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

منبع محصول

اضافه شدن productLength ، productHeight ، productWidth و productWeight برای ارائه ابعاد و وزن محصول.

9 اوت 2021

RepricingRule Service

نوع قانون Repricing

مقدار enum جدید برای فیلد RepricingRuleType .

TYPE_SALES_VOLUME_BASED و TYPE_COMPETITIVE_PRICE اضافه شد.

17 مه 2021

خدمات برچسب بازگشت سفارش

یک فیلد «product_id» جدید در CreateReturnRequest اضافه کرد. بازرگانان می توانند شناسه product_id یا line_item_id را برای شناسایی کالای مورد نظر برای بازگرداندن مشخص کنند.

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

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

3 مه 2021

خدمات برچسب بازگشت سفارش

روش‌های جدیدی برای بارگذاری برچسب‌های بازده مدیریت‌شده بازرگان (MMR) اضافه شد. با orderreturns.labels.create جدید، می توانید برچسب های برگشتی را آپلود کنید تا آنها را با مشتری به اشتراک بگذارید.

26 آوریل 2021

API تنظیمات حمل و نقل

فیلد جدید warehouseBasedDeliveryTimes در DeliveryTime برای پشتیبانی از خدمات حمل و نقل که تاریخ تحویل تخمینی را بر اساس مکان انبار و خدمات حامل انتخابی محاسبه می کند.

فیلد جدید eddServices در CarriersCarrier به نام سرویس‌های قابل استفاده برای محاسبه تاریخ تحویل تخمینی اشاره می‌کند.

12 آوریل 2021

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

منبع محصول

فیلد جدید additionalSizeType برای پشتیبانی از حداکثر 2 نوع اندازه در هر محصول.

تغییرات در زمینه حمل و نقل: اضافه شدن minHandlingTime ، maxHandlingTime ، minTransitTime و maxTransitTime به ProductShipping برای ارائه سرعت حمل و نقل در سطح پیشنهاد.

28 ژانویه 2021

خدمات حساب ها

اضافه شدن پشتیبانی از برچسب های خودکار به AccountLabel و منابع Account . برای اطلاعات بیشتر، به بخش انواع برچسب CSS در راهنمای مدیریت برچسب CSS مراجعه کنید.

5 اکتبر 2020

سرویس CSSES

منبع CSS

یک سرویس جدید csses برای بازیابی اطلاعات در مورد دامنه های CSS و اختصاص برچسب به آنها اضافه شده است. منبع AccountLabel اکنون می‌تواند برای ایجاد و فهرست‌بندی برچسب‌های سطح گروه CSS نیز استفاده شود. برای اطلاعات بیشتر، CSS Label Management را ببینید.

24 آگوست 2020

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

منبع محصولات

فیلد جدید shoppingAdsExcludedCountries برای حذف پیشنهادات از تبلیغات در برخی کشورها.

منبع وضعیت محصول

فیلدهای approvedCountries جدید، pendingCountries و disapprovedCountries در شیء destinationStatuses که اطلاعات وضعیت پیشنهاد را فراتر از targetCountry ارائه می دهد.

فیلد جدید itemLevelIssues.applicableCountries .

10 آگوست 2020

خدمات حساب ها

یک منبع AccountLabel جدید برای مدیریت برچسب‌های حساب Merchant Center برای CSS Center اضافه شد. کاربران مرکز CSS اکنون می‌توانند حساب‌های Merchant Center خود را فهرست کرده و با روش‌های accounts.list ، accounts.get و accounts.updatelabels به آن‌ها برچسب اختصاص دهند. برای اطلاعات بیشتر، CSS Label Management را ببینید.

19 ژوئن 2020

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

منبع محصول

زمینه های جدید

productDetails جدید، productHighlights ، subscriptionCost و فیلدهای canonicalLink .

2 ژوئن 2020

خدمات سفارشات

روش های جدیدی برای شروع بازپرداخت بدون بازگشت اضافه شده است. با orders.refunditem و orders.refundorder جدید، می‌توانید بازپرداخت سفارش‌ها را حتی اگر توسط مشتری بازگردانده نشده‌اند، آغاز کنید.

27 آوریل 2020

خدمات برگشت سفارش

افزودن روش‌های جدید acknowledge و process ، و فیلترها و فیلدهای جدید برای روش‌های خواندن ( list ، get ).

پیوند GMB

قابلیت پیوند دادن حساب‌های Merchant Center به یک حساب GMB با استفاده از شناسه حساب GMB اضافه شده است.

14 آوریل 2020

APIهای گزارش تسویه حساب

یک سرویس جدید برای دریافت گزارش های تسویه حساب اضافه شد.

9 مارس 2020

API موجودی محلی

یک سرویس جدید برای ارسال داده های موجودی محلی اضافه شده است.

2 مارس 2020

API تنظیمات اعلان Pubsub

یک سرویس جدید برای مدیریت تنظیمات اعلان‌های pubsub اضافه شد.

3 دسامبر 2019

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

پشتیبانی از فیدهای Content API تکمیلی حساب چند مشتری اضافه شد.

11 سپتامبر 2019

خدمات سفارشات

پشتیبانی از محموله های پیکاپ در سفارشات و ویژگی های جعبه شنی مربوطه اضافه شده است.

14 آگوست 2019

خدمات جدید

خدمات جدید Returnpolicy و Returnaddress برای Buy on Google اضافه شد.

خدمات سفارشات

منبع سفارش

زمینه جدید

quantityUndeliverable جدید فیلد غیرقابل تحویل.

7 آگوست 2019

خدمات سفارشات

منبع سفارش

زمینه های جدید

فیلدهای loyaltyInfo و invoiceReceivingEmail جدید به منبع سفارش اضافه شد.

1 جولای 2019

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

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

11 ژوئن 2019

خدمات سفارشات

منابع سفارش و تست سفارش

اضافه شدن تعدیل قیمت

فیلد lineItem[].adjustments جدید اضافه شد که شامل تعدیل قیمت اقلام خط اصلی و مالیات ناشی از اعمال تبلیغات است.

14 فوریه 2019

تغییرات ارائه شده در این نسخه

اجرای خشک دیگر پشتیبانی نمی شود

پارامتر dryRun از نسخه 2.1 حذف شده است. این برای همه تماس‌های API اعمال می‌شود.

روش‌های وصله دیگر پشتیبانی نمی‌شوند

سرویس‌های زیر دیگر از روش patch پشتیبانی نمی‌کنند:

• حساب ها
• مالیات حساب
• فیدهای داده
• Liasettings
• تنظیمات حمل و نقل

حذف روش های HTTP BATCH

تمام متدهای HTTP BATCH از نسخه 2.1 حذف شده است. به جای آن از customBatch استفاده کنید. خدمات آسیب دیده به شرح زیر است:

• حساب ها
• وضعیت حساب ها
• فیدهای داده
• وضعیت های فید داده
• Liasettings
• گزارش های سفارش
• پوز
• محصولات
• وضعیت محصول
• تنظیمات حمل و نقل

خدمات حساب ها

به روز رسانی

فیلدهای businessInformation و googleMyBusinessLink در درخواست پس از راه اندازی اولیه Content API v2 معرفی شدند. به همین دلیل، حفاظتی وجود دارد که در صورت عدم ارائه، بازرگانان را از حذف ناخواسته اطلاعات در این دو زمینه با update جلوگیری می کند.

در نسخه 2، بازرگانان باید به صراحت این فیلدها را با یک متن خالی ( {} ) برای حذف آنها ارائه کنند. در نسخه 2.1، اگر یک متن خالی ارائه دهید یا اگر آنها را ارائه نکنید، فیلدها حذف می شوند.

منبع حساب

AdWords -> تغییر نام تجاری Google Ads

با تبدیل شدن AdWords به Google Ads ، نام فیلدهای مرتبط با AdWords زیر تغییر یافته است:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

حذف فیلدها و مقادیر منسوخ شده

فیلد منسوخ reviewsUrl حذف شده است. علاوه بر این، وضعیت پیوند inactive برای adsLinks ، googleMyBusinessLink ، و youtubeChannelLinks حذف شده است.

خدمات وضعیت حساب

منبع وضعیت حساب

حذف dataQualityIssues

اینها توسط itemLevelIssues جایگزین شده اند.

سرویس دیتا فید

منبع دیتا فید

حذف فیلدهای منسوخ شده

فیلدهای contentLanguage , targetCountry , و intendedDestinations حذف شده اند و به جای آن country , language , includedDestinations , و targets excludedDestinations .

حذف به روز رسانی موجودی محصول

فیدهای نوع product inventory update حذف شده‌اند.

خدمات موجودی

سرویس inventory v2 حذف شده و با دو ویژگی جدید در نسخه 2.1 جایگزین شده است:

• از فیدهای تکمیلی جدید برای به روز رسانی جزئی محصول استفاده کنید.
• از سرویس جدید localinventory برای به روز رسانی محصول محلی استفاده کنید.

خدمات سفارشات

CancelLineItem

فیلدهای amount ، amountPretax ، و amountTax موجود در درخواست حذف شده‌اند. مبلغ بازپرداخت شده اکنون به صورت خودکار محاسبه می شود.

CustomBatch

CustomBatch از نسخه 2.1 حذف شده است.

InStoreRefundLineItem

فیلدهای amountPretax و amountTax به ترتیب با priceAmount و taxAmount جایگزین شده‌اند. بسته به محل سفارش، priceAmount فیلد مبلغ ممکن است قبل از مالیات یا پس از مالیات باشد.

بازپرداخت

این روش حذف شده است. به جای آن از returnRefundLineItem استفاده کنید.

ReturnLineItem

این روش حذف شده است. در عوض از returnRefundLineItem بدون ارائه مبلغ بازپرداخت استفاده کنید.

ReturnRefundLineItem

فیلدهای amountPretax و amountTax به ترتیب با priceAmount و taxAmount جایگزین شده‌اند. بسته به محل سفارش، priceAmount فیلد مبلغ ممکن است قبل از مالیات یا پس از مالیات باشد.

ShipLineItem

فیلدهای carrier , shipmentId , و trackingId در درخواست به shipmentInfos منتقل شده اند .

منابع سفارش و تست سفارش

فرمت تبلیغاتی جدید

یک فرمت تبلیغاتی جدید در نسخه 2.1 وجود دارد. با تبلیغات نمی‌توانید سفارش‌های آزمایشی ایجاد کنید.

حذف فیلدهای منسوخ شده

فیلد paymentMethod حذف شده است، و billingAddress و predefinedBillingAddress BillingAddress اکنون به ترتیب فیلدهای سطح بالایی در Order و TestOrder هستند.

علاوه بر این، customer.explicitMarketingPreference حذف شده و با customer.marketingRightsInfo در Order و TestOrder جایگزین شده است.

فیلد منسوخ شده customer.email حذف شده است.

قالب قسمت promotions در منبع Order تغییر کرده است.

خدمات پرداخت سفارش

این سرویس از نسخه 2.1 حذف شده است.

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

پاسخ از یک insert فقط شامل ویژگی های زیر خواهد بود:

• channel
• contentLanguage
• id
• offerId
• targetCountry

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

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

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

قیمت‌ها اکنون قبل از درج محصول تأیید می‌شوند. فقط کاراکترهای زیر در رشته مقدار مجاز هستند: + , - , . و ارقام ( 0 - 9 ). ویرگول دیگر پذیرفته نمی شود.

منبع محصول

CustomGroups با CustomAttributes بازگشتی جایگزین شدند

قبلاً، ویژگی‌های سفارشی را می‌توان با افزودن ویژگی‌های سفارشی در زیر همان گروه سفارشی در نسخه ۲ گروه‌بندی کرد. ویژگی های سفارشی اکنون در نسخه 2.1 بازگشتی هستند، بنابراین نیاز به گروه های سفارشی را از بین می برد.

ویژگی های سفارشی اکنون علاوه بر فیلد value اصلی، یک فیلد groupValues ​​اضافی نیز دارند. دقیقاً یکی از آنها باید تنظیم شود، به این معنی که نمی توان آنها را به طور همزمان تنظیم کرد یا کنار گذاشت.

از آنجایی که بازرگانان ممکن است بین نسخه ۲ و نسخه ۲.۱ جابجا شوند، ممکن است محصولات دارای ویژگی‌های سفارشی بازگشتی باشند که نمی‌توانند در نسخه ۲ نمایش داده شوند زیرا گروه‌های سفارشی حداکثر دو سطح دارند. در این حالت، گروه ویژگی سفارشی کوتاه می شود.

حذف نوع و واحد در CustomAttributes

در نسخه 2.1، ویژگی های سفارشی دیگر حاوی یک type و unit نخواهند بود. در عوض، واحدها باید به value اضافه شوند (در صورت وجود)، و انواع باید به طور خودکار شناسایی شوند. به عنوان مثال، از "1.23 EUR" یا "5.6 cm" به عنوان value در v2.1 استفاده کنید.

ProductTypes جایگزین productType و otherProductTypes می شود

قبلاً، انواع محصول در دو فیلد ذخیره می‌شد که نوع اول در فیلد مفرد productType و بقیه در فیلد مکرر additionalProductTypes . در نسخه 2.1، دو فیلد با یک فیلد تکراری productTypes جایگزین شده‌اند.

ویژگی Destinations با includeDstinations و excludedDestinations جایگزین شد

مقاصد به عنوان فهرستی از نام مقصد و جفت‌های مقصود در v2 در destinations مکرر فیلد وارد شدند. این فیلد با دو فیلد تکراری زیر جایگزین شده است: includedDestinations و excludedDestinations . مقاصدی که به طور پیش‌فرض فعال شده‌اند، نیازی به گنجاندن در includedDestinations. این با پیکربندی لغوهای مقصد در فیدها مطابقت دارد.

تغییر نام فیلدهای مرتبط با AdWords

با تبدیل شدن AdWords به Google Ads ، نام فیلدهای مرتبط با AdWords زیر تغییر یافته است:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

حذف فیلدهای منسوخ شده

فیلدهای منسوخ شده زیر حذف شده اند:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

خدمات وضعیت محصولات

دریافت و فهرست کنید

ویژگی product به همراه پارامتر includeAttributes حذف شد. برای بازیابی ویژگی های محصول مربوط به یک وضعیت، از سرویس Products و مقدار قسمت productId جدید استفاده کنید.

فهرست کنید

پارامتر includeInvalidInsertedItems حذف شده است. اکنون همه محصولات بدون در نظر گرفتن معتبر بودن بازگردانده می شوند، به این معنی که list اکنون طوری رفتار می کند که گویی includeInvalidInsertedItems همیشه روی true تنظیم شده است.

منبع وضعیت محصول

وضعیت های مقصد

فیلدهای intention , approvalStatus , و approvalPending در destinationStatuses با status جایگزین شده اند که رشته ای است که می تواند یکی از approved , disapproved یا pending باشد .

حذف dataQualityIssues

اینها توسط itemLevelIssues جایگزین شده اند.

،

خدمات پشتیبانی بازرگان

26 مه 2025

خدمات حساب ها

اکنون امکان افزودن کاربران فقط خواندنی به حساب ها وجود دارد.

14 آوریل 2025

خدمات حساب ها

از آنجایی که این دیگر در آینده الزامی نخواهد بود، خدمات accounttax منسوخ شده است.

17 مارس 2025

خدمات مرتبط با سفارشات

به عنوان بخشی از تعطیلی API های مربوط به سفارشات ، سرویس های زیر منسوخ شده اند:

• accounts.verifyphonenumber
• returnpolicy

سایر خدمات

این نقطه پایانی دیگر مورد نیاز نیست و می توان آن را منسوخ کرد:

• pubsubnotificationsettings

10 فوریه 2025

فیلدهای prerendered_out_of_court_dispute_settlement به ProductIssue و AccountIssue اضافه شد.

فیلدهای alternate_dispute_resolution از RenderProductIssuesResponse و RenderAccountIssuesResponse منسوخ شده است.

12 دسامبر 2024

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

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

15 نوامبر 2024

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

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

30 اکتبر 2024

خدمات مربوط به تسویه حساب

به عنوان بخشی از تعطیلی APIهای مربوط به تسویه حساب، سرویس‌های زیر منسوخ شده‌اند:

• settlementreports
• settlementtranscations

خاموش شدن APIهای مربوط به تسویه حساب مربوط به برنامه BuyOnGoogle که قبلاً بسته شده بود و APIهای مربوط به سفارشات.

انتظار می‌رود تماس‌ها با سرویس‌های فوق‌الذکر با شکست Service was not found on the server شکست بخورد.

16 اکتبر 2024

update_mask در UpdateConversionSourceRequest اکنون OPTIONAL است. اگر ماسک به‌روزرسانی مشخص نشده باشد، تمام فیلدهایی که دارای مقدار غیر خالی هستند به‌روزرسانی می‌شوند.

26 اوت 2024 (زودتر از آنچه در ابتدا اعلام شده بود)

خدمات مرتبط با سفارشات

به عنوان بخشی از تعطیلی API های مربوط به سفارشات ، سرویس های زیر منسوخ شده اند:

• orderinvoices
• orderreports
• orderreturns
• orderreturns.labels
• orders

انتظار می‌رود تماس‌ها با سرویس‌های فوق‌الذکر با شکست Service was not found on the server شکست بخورد.

سرویس OrderTrackingSignals منسوخ نشده است و همچنان در دسترس است.

10 آگوست 2024

از خدمات Google خرید کنید

به‌عنوان بخشی از خاموش کردن APIهای Buy on Google، همه روش‌های موجود در BuyOnGoogleProgramService با شکست مواجه می‌شوند، زیرا service was not found on the server .

19 جولای 2024

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

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

20 مه 2024

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

LoyaltyPrograms اضافه شد. این به‌روزرسانی به شما امکان می‌دهد چندین سطح با امتیازات وفاداری، قیمت‌ها و غیره متفاوت برای یک محصول ارائه کنید. شما باید از این فیلد به جای فیلد LoyaltyProgram مفرد استفاده کنید.

سرویس گزارشات

معیارهای خرید در Google منسوخ در جدول MerchantPerformanceView . پس از این به‌روزرسانی، بازیابی هر متریک Buy on Google 0 را برمی‌گرداند. این در مورد مقادیر تاریخی تاریخ‌های گذشته نیز صدق می‌کند.

برای اطلاعات بیشتر، خرید در Google منسوخ را ببینید.

13 مه 2024

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

منبع محصول

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

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

6 مه 2024

سرویس گزارشات

سطل اثربخشی به جدول PriceInsightsProductView اضافه شد. اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی افزایش عملکرد پیش بینی شده با تعدیل قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی را در نظر می گیرد.

24 آوریل 2024

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

منبع محصول

فیلدهای downpayment اختیاری و creditType برای پرداخت های اقساطی اضافه شد:

• downpayment مبلغی را فراهم می کند که خریدار باید به عنوان یک بار پرداخت پیش پرداخت کند.
• creditType نوع پرداخت اقساط ( finance یا lease ) را ارائه می دهد. این فیلد فقط برای تبلیغات خودرو کاربرد دارد.

11 آوریل 2024

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

منبع محصول

• ویژگی آستانه حمل و نقل رایگان ( FreeShippingThreshold ) برای حمل و نقل در سطح پیشنهاد اضافه شد. این ویژگی به بازرگانان اجازه می‌دهد حداقل قیمت محصول را برای رایگان شدن هزینه ارسال وارد کنند.
• نمایان بودن LoyaltyPoints را تغییر داد

10 آوریل 2024

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

منبع محصول

LoyaltyProgram اضافه شد

9 آوریل 2024

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

منبع محصول

برای ارائه عناوین و توضیحات محصول تولید شده توسط هوش مصنوعی structuredTitle و structuredDescription اضافه شد.

3 آوریل 2024

خدمات پشتیبانی بازرگان

فیلد user_input_action_option اضافه شد که به شرکا اجازه می‌دهد نوع جدیدی از اقدام را درخواست کنند: BuiltInUserInputAction . این اقدام به شرکا اجازه می‌دهد تا به‌جای هدایت مجدد به Merchant Center، مستقیماً در برنامه‌های کاربردی خود، برای بازرگانان، قابلیت‌های خود-خدمت پیچیده ایجاد کنند.

یک روش TriggerAction جدید برای BuiltInUserInputAction اضافه کرد. برای دسترسی به این روش، درخواستی را به این فرم ارسال کنید.

27 مارس 2024

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

منبع محصول

AutoPricingMinPrice به عنوان محافظی در پروژه‌های «تخفیف‌های خودکار» و «تبلیغات پویا» اضافه شده است، و تضمین می‌کند که تخفیف‌های پیشنهادی تاجران قیمت محصول را به کمتر از این مقدار کاهش نمی‌دهد. بدین ترتیب ارزش و سودآوری پیشنهاد حفظ می شود.

15 مارس 2024

Sunset Buy در Google برای جستجو و خرید. با استفاده از orders.list و orders.get می‌توانید تا 31 اکتبر 2024 به مشاهده سفارش‌های موجود ادامه دهید.

8 مارس 2024

سرویس گزارشات

گزارش TopicTrendsView به سرویس Reports اضافه شد.

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

6 مارس 2024

سرویس گزارشات

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

برای اطلاعات بیشتر، به راهنمای گزارش ما مراجعه کنید.

19 فوریه 2024

خدمات ConversionSources

مقادیر زیر را به عنوان منابع تبدیل معتبر حذف کرد:

• CROSS_CHANNEL_FIRST_CLICK
• CROSS_CHANNEL_LINEAR
• CROSS_CHANNEL_POSITION_BASED
• CROSS_CHANNEL_TIME_DECAY

گزینه های 60 و 90 را به عنوان روزهای پنجره نگاه حذف کرد و 40 را به عنوان گزینه معتبر اضافه کرد.

17 ژانویه 2024

سرویس POS

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

11 ژانویه 2024

خدمات حساب ها

برای روش link به ترتیب localProductManager و localProductManagement به عنوان نوع پیوند و سرویس اضافه شد. اینها به حساب ها اجازه می دهد تا با هدف مدیریت داده های محصول محلی پیوند بخورند.

29 نوامبر 2023

خدمات پشتیبانی بازرگان

اضافه شده VERIFY_IDENTITY_IN_MERCHANT_CENTER نوع عمل خارجی برای تأیید هویت که باید در مرکز بازرگان انجام شود.

سرویس PO

قسمتهای matching_status و مطابق با زمینه های matching_status_hint به posstore اضافه شده است که به کاربران این امکان را می دهد تا وضعیت مطابقت با فروشگاه POS را با فروشگاه پروفایل Google Business بدانند و در صورت بروز مشکل برطرف شوند.

15 نوامبر 2023

repricingrules و repricingrules.repricingreports نقاط پایانی دیگر پشتیبانی نمی شوند.

1 نوامبر 2023

سرویس تنظیمات حمل و نقل

shipment_type=pickup دیگر پشتیبانی نمی شود.

18 اکتبر 2023

سرویس حساب

زمینه Business Identity اضافه شده که به بازرگانان اجازه می دهد تا خود را با ارزش های خاص مصرف کننده شناسایی کنند.

10 اکتبر 2023

Collection Point اضافه شده به عنوان نوع جدید حمل و نقل سرویس تنظیمات حمل و نقل. تحویل نقطه جمع آوری ، خدماتی است که توسط شخص ثالث (به عنوان مثال بازرگان متعلق به آن نیست) برای ارائه این کالا به یک مکان وابسته به شخص ثالث (مانند نقاط دسترسی UPS) ، به جای تحویل مستقیم به خانه.

18 سپتامبر 2023

خدمات تنظیمات لیا

روش setOmnichannelExperience اضافه شده است تا به کاربران اجازه دهد تجربه omnichannel خود را تنظیم کنند (یعنی تنظیمات فروشگاه محلی و وانت). در این زمان ، این فقط برای کاربرانی که به ارائه دهنده POS اعتماد دارد برای فعال کردن چنین تنظیماتی در دسترس است.

7 سپتامبر 2023

خرید در Google استهلاک

افزودن وضعیت جدید DEPRECATED به روش GetBuyOnGoogleProgramStastus . فعال کردن یا مکث برنامه از چنین وضعیتی امکان پذیر نیست.

4 سپتامبر 2023

سرویس پشتیبانی بازرگان

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

28 اوت 2023

سرویس تبلیغاتی

روش list در سرویس Promotions از دسترسی محدود به همه باز کنید.

22 اوت 2023

سرویس پشتیبانی بازرگان

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

4 آگوست 2023

گزارش خدمات

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

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

25 جولای 2023

سرویس PO

منبع موجودی

قسمتهای pickup_method و pickup_sla را اضافه کنید تا بتوانید بازرگانان را برای ارسال اطلاعات وانت به همراه موجودی خود فراهم کنید.

14 جولای 2023

گزارش خدمات

گزارش های دید رقابتی را به خدمات گزارش اضافه کرد.

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

7 جولای 2023

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

منبع محصول

virtualModelLink اضافه شده برای ارائه URL به تصویر مدل سه بعدی.

4 جولای 2023

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

منبع محصول

قسمت certifications برای ارائه گواهینامه های محصول اضافه کنید ، به عنوان مثال برای برچسب زدن بهره وری انرژی محصولات بر اساس بانک اطلاعاتی EU EPREL .

26 ژوئن 2023

سرویس تنظیمات حمل و نقل

تحقق محلی

قسمت no_delivery_post_cutoff اضافه شده است تا به بازرگانان اجازه دهد از نمایش محلی N+1 روز در هنگام ارائه خدمات حمل و نقل پیکربندی شده به N Day Day Delivery محلی خودداری کنند.

29 مه 2023

سرویس تبلیغاتی

روش list برای سرویس Promotions اضافه شده است.

سرویس توصیه

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

9 مه 2023

مقصد خرده فروشی ابر

ویژگی های اضافی خرده فروشی ابر

قسمت Cloud Retail Properties اضافی را اضافه کنید. این یک زمینه مکرر است که توسط مشتریان با استفاده از مقصد خرده فروشی ابر مورد استفاده قرار می گیرد. هنگام استفاده از این قسمت ، هنگام استفاده از برنامه خرده فروشی Cloud در دسترس خواهد بود. این در زمینه ویژگی ها در مدل محصول خرده فروشی Google Cloud ترسیم می شود.

22 مه 2023

سرویس تبلیغاتی

روش list برای سرویس Promotions اضافه شده است.

11 آوریل 2023

سرویس تنظیمات حمل و نقل

تحقق محلی

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

3 آوریل

خدمات توصیه ها

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

20 فوریه 2023

سرویس حساب

منبع حساب

یک حساب بخش جدید اضافه شده است .

خدمات تبدیل منابع

سرویس منابع تبدیل را که از مدیریت منابع تبدیل (بخشی از بخش تنظیمات تبدیل در مرکز بازرگانان) پشتیبانی می کند ، اضافه کرد.

16 فوریه 2023

سرویس تنظیمات حمل و نقل

اعتبار سنجی کد را ذخیره کنید

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

اعتبار سنجی بازرگان

برنامه هایی که شناسه بازرگان در آن ثبت نام می کند ، قبل از به روزرسانی تنظیمات حمل و نقل ، اکنون تأیید شده است. بازرگانان باید در یکی از برنامه های زیر باشند:

• LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
• LOCAL_INVENTORY_ADS

9 فوریه 2023

سرویس تبلیغاتی

سرویس تبلیغات را به 6 گزینه اضافی targetCountry با پشتیبانی محلی contentLanguage گسترش دهید .:

• BR
• ES
• NL
• JP
• IT
• KR

12 ژانویه 2023

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

منبع محصول

اضافه کردن lifestyleImageLinks برای ارائه URL در تصاویر سبک زندگی.

24 نوامبر 2022

سرویس ارتقاء

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

15 نوامبر 2022

گزارش خدمات

گزارش های بینش بازار را به خدمات گزارش اضافه کرد.

اکنون می توانید خدمات گزارش را برای موارد زیر پرس و جو کنید:

• گزارش های بهترین فروشندگان با استفاده از جداول BestSellersProductClusterView و BestSellersBrandView .
• گزارش رقابت قیمت با استفاده از جدول PriceCompetitivenessProductView .
• گزارش بینش قیمت با استفاده از جدول PriceInsightsProductView .

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

7 نوامبر 2022

سرویس داده های داده

پشتیبانی feedLabel برای سرویس DataFeeds اضافه شده است.

14 سپتامبر 2022

feedLabel به روز شده برای پذیرش هر رشته.

9 اوت 2022

feedLabel اضافه شده برای محصولات.

اکنون می توانید به جای targetCountry از feedLabel استفاده کنید تا کشور را برای شناسه های پیشنهادی مشخص کنید. شناسه های ارائه شده اکنون به صورت online:language:feedLabel:offerId .

feedLabel به طور خودکار با مقدار targetCountry شما برای فیدهای موجود برای سازگاری به عقب جمع شده است.

targetCountry مستهلک.

برای پشتیبانی از پیشنهادات جهانی ، API محتوا برای خرید ، زمینه targetCountry را کاهش داده است. درعوض ، ما توصیه می کنیم از قسمت shipping برای مشخص کردن کشورهای هدف خود استفاده کنید.

targetCountry اکنون به طور خودکار با مقداری که در feedLabel ارائه می دهید ، جمع شده است.

هشدار: مقادیر targetCountry Targetfled بر اساس ارسال feedLabel شما پیشنهادات خود را قادر به ارائه خدمات در کشور مشخص شده در feedLabel نمی کند. از shipping استفاده کنید تا اطمینان حاصل کنید که پیشنهادات شما قادر به خدمت در کشورهای منتخب شما هستند.

برای خرید جزئیات بیشتر ، به برچسب Feed Post Post جایگزین کشور Target Country در API محتوا جایگزین می شود .

8 دسامبر 2021

سرویس حساب

منبع حساب

یک حساب بخش جدید اضافه شده است .

این بخش جدید به بازرگانان این امکان را می دهد تا به طور خودکار موارد را به روز کنند ، تصاویر و تنظیمات حمل و نقل را بهبود بخشند.

25 اکتبر 2021

سرویس ارتقاء

اضافه کردن ارتقاء به API تبلیغاتی.

11 اکتبر 2021

تنظیمات حمل و نقل API

زمینه جدید warehouse در منابع Shippingsettings اضافه شده است تا بازرگانان بتوانند انبارها را مدیریت کنند که می توانند در WarehouseBasedDeliveryTime استفاده شوند.

برای مراجعه به Warehouse By Warehouse ، زمینه جدید warehouseName در WarehouseBasedDeliveryTime اضافه کنید.

4 اکتبر 2021

سرویس حساب

منبع حساب

یک قسمت جدید "phone_erification_status" را در بخش حساب اضافه کرد. این یک قسمت فقط خواندنی است که توسط حساب ها تنظیم شده است. VerifyPhonEnumber.

13 سپتامبر 2021

سرویس buyongoogleprograms

منبع buyongoogleprogramstatus

زمینه های جدید در buyongoogleprograms.buyonprogramstatus respresnting: کانال های فروش آنلاین ، مدل های تجاری و تلفن خدمات مشتری.

روش جدید به روزرسانی buyongoogleprogramstatus

یک روش جدید UpdateBuyOngOogleProgramStatus اضافه شده است که امکان به روزرسانی گسترده BuyongooglePrograms.BuyOnprogramStatus را به روز می کند.

6 سپتامبر 2021

سرویس حساب

منبع حساب

یک قسمت جدید "کره ای_بوشی_ registration_number" را در بخش حساب اضافه کرد. این قسمت فقط در صورتی پاک می شود که صریحاً روی یک رشته خالی تنظیم شود.

30 اوت 2021

سرویس ارتقاء

یک سرویس ارتقاء جدید با ارتقاء درج موجود اضافه شده است.

سرویس سفارشات

برای گرفتن بودجه قبل از حمل و نقل ، یک orders/captureOrder روش جدید اضافه کرد.

سفارش جدید لغو دلیل FAILED_TO_CAPTURE_FUNDS

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

منبع محصول

اضافه شده productLength ، productHeight ، productWidth و productWeight برای تأمین ابعاد و وزن محصول.

9 اوت 2021

سرویس مجدد

نوع تکرار

مقدار جدید enum برای زمینه RepricingRuleType .

اضافه شده TYPE_SALES_VOLUME_BASED و TYPE_COMPETITIVE_PRICE .

17 مه 2021

سفارش خدمات برچسب را برمی گرداند

یک زمینه جدید "product_id" را در CreaterEturnRequest اضافه کرد. بازرگانان می توانند Product_ID یا Line_Item_ID را مشخص کنند تا مورد را برای بازگشت مشخص کنند.

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

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

3 مه 2021

سفارش خدمات برچسب را برمی گرداند

روشهای جدیدی برای بارگذاری برچسب ها برای بازده مدیریت بازرگان (MMR) اضافه شد. با استفاده از orderreturns.labels.create ، می توانید برچسب های برگشتی را بارگذاری کنید تا آنها را با مشتری به اشتراک بگذارید.

26 آوریل 2021

تنظیمات حمل و نقل API

زمینه جدید warehouseBasedDeliveryTimes در زمان تحویل برای پشتیبانی از خدمات حمل و نقل محاسبه تاریخ تحویل تخمین زده شده بر اساس محل انبار و سرویس حامل انتخاب شده.

قسمت جدید eddServices در شیء Carrierscarrier برای بازگرداندن نام خدمات قابل استفاده برای محاسبه تاریخ تحویل تخمین زده شده.

12 آوریل 2021

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

منبع محصول

زمینه جدید additionalSizeType جدید برای پشتیبانی از 2 نوع اندازه در هر محصول.

تغییرات در زمینه حمل و نقل: اضافه شده minHandlingTime ، maxHandlingTime ، minTransitTime و maxTransitTime به ProductShipping برای ارائه سرعت حمل و نقل سطح ارائه می شود.

28 ژانویه 2021

سرویس حساب

پشتیبانی از برچسب های اتوماتیک به منابع AccountLabel و منابع Account پشتیبانی می کند. برای اطلاعات بیشتر ، به بخش انواع برچسب CSS در راهنمای مدیریت برچسب CSS مراجعه کنید.

5 اکتبر 2020

سرویس CSSES

منبع CSS

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

24 آگوست 2020

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

منبع محصولات

زمینه جدید shoppingAdsExcludedCountries برای حذف پیشنهادات از تبلیغات در برخی از کشورها.

منبع ProductStatuses

موارد جدید approvedCountries ، pendingCountries و زمینه های disapprovedCountries را در شیء destinationStatuses که اطلاعات وضعیتی را برای ارائه اطلاعات فراتر از targetCountry ارائه می دهد ، ارائه می دهد.

قسمت جدید itemLevelIssues.applicableCountries .

10 آگوست 2020

سرویس حساب

یک منبع جدید AccountLabel برای مدیریت برچسب های حساب مرکز بازرگان برای مرکز CSS اضافه شده است. کاربران CSS Center هم اکنون می توانند حساب های مرکز بازرگان خود را نیز لیست کرده و با accounts.list ، لیست accounts.get و accounts.updatelabels را به آنها اختصاص دهند. برای اطلاعات بیشتر ، به مدیریت برچسب CSS مراجعه کنید.

19 ژوئن 2020

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

منبع محصول

زمینه های جدید

productDetails ، productHighlights ، subscriptionCost و زمینه های canonicalLink .

2 ژوئن 2020

سرویس سفارشات

روشهای جدیدی برای شروع بازپرداخت بدون بازده اضافه شده است. با orders.refunditem جدید. RefundItem و orders.refundorder ، می توانید بازپرداخت سفارشات را حتی اگر توسط مشتری بازگردانده نشوند ، شروع کنید.

27 آوریل 2020

سرویس سفارش

روشهای جدید acknowledge و process کرد و فیلترها و فیلدهای جدید برای روشهای خواندن ( list ، get ).

پیوند GMB

با استفاده از شناسه حساب GMB ، امکان پیوند حساب های مرکز بازرگان به یک حساب GMB را اضافه کرد.

14 آوریل 2020

گزارش تسویه حساب API

برای دریافت گزارش های تسویه حساب یک سرویس جدید اضافه کرد.

9 مارس 2020

API موجودی محلی

یک سرویس جدید برای ارسال داده های موجودی محلی اضافه شده است.

2 مارس 2020

تنظیمات اطلاع رسانی PubSub API

یک سرویس جدید برای مدیریت تنظیمات برای اعلان های PubSub اضافه شده است.

3 دسامبر 2019

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

پشتیبانی اضافه شده برای فیدهای API محتوای تکمیلی حساب چند مشتری.

11 سپتامبر 2019

سرویس سفارشات

پشتیبانی از محموله های وانت در سفارشات و ویژگی های مربوط به ماسهبازی.

14 آگوست 2019

خدمات جدید

سرویس های جدید ReturnPolicy و ReturnAddress را برای خرید در Google اضافه کرد.

سرویس سفارشات

منبع سفارش

حوزه جدید

میدان جدید quantityUndeliverable .

7 آگوست 2019

سرویس سفارشات

منبع سفارش

زمینه های جدید

برای سفارش منابع ، زمینه های جدید loyaltyInfo و invoiceReceivingEmail برای سفارش منابع اضافه کرد.

1 جولای 2019

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

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

11 ژوئن 2019

سرویس سفارشات

منابع سفارش و آزمایشگر

افزودن تعدیل قیمت

New lineItem[].adjustments حاوی تعدیل قیمت کالای اصلی و مالیات ناشی از اعمال تبلیغات.

14 فوریه 2019

تغییرات معرفی شده در این نسخه

اجراهای خشک دیگر پشتیبانی نمی شوند

پارامتر dryRun از v2.1 حذف شده است. این در مورد همه تماس های API صدق می کند.

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

خدمات زیر دیگر از روش patch پشتیبانی نمی کنند:

• حساب ها
• حساب
• داده های
• لیزت
• حمل و نقل

حذف روش های دسته ای HTTP

تمام روشهای BATCH HTTP از v2.1 حذف شده اند. به جای آن از customBatch استفاده کنید. خدمات آسیب دیده به شرح زیر است:

• حساب ها
• حساب های حساب
• داده های
• datafeedstatuses
• لیزت
• گزارش های
• پوز
• محصولات
• محصول
• حمل و نقل

سرویس حساب

به روز رسانی

Fields businessInformation و googleMyBusinessLink در این درخواست پس از راه اندازی اولیه API V2 محتوا معرفی شد. به همین دلیل ، یک حراست وجود دارد که مانع از حذف ناخواسته بازرگانان در این دو قسمت با update در صورت عدم ارائه آنها می شود.

در V2 ، بازرگانان باید صریحاً این زمینه ها را در اختیار بدن خالی ( {} ) قرار دهند تا آنها را حذف کنند. در v2.1 ، اگر بدن خالی تهیه می کنید ، زمینه ها حذف می شوند ، یا اگر آنها را تهیه نکنید.

منبع حساب

AdWords -> Google Ads Rebranding

با تبدیل شدن به تبلیغات Google Adwords ، زمینه های مرتبط با AdWords زیر تغییر نام داده اند:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

حذف زمینه ها و مقادیر کاهش یافته

reviewsUrl میدانی کاهش یافته حذف شده است. علاوه بر این ، وضعیت پیوند inactive برای adsLinks ، googleMyBusinessLink و youtubeChannelLinks حذف شده است.

سرویس حساب کاربری

منبع

حذف DataQualitySissues

این موارد توسط itemLevelIssues کنار گذاشته شده است.

سرویس داده

منبع داده

حذف زمینه های مستهلک

زمینه های contentLanguage ، targetCountry ، و intendedDestinations حذف شده و توسط country ، language ، includedDestinations ، و excludedDestinations در targets جایگزین شده و جایگزین شده اند.

حذف بروزرسانی موجودی محصول

فیدهای product inventory update از نوع حذف شده اند.

سرویس موجودی

سرویس inventory V2 حذف شده و با دو ویژگی جدید در V2.1 جایگزین شده است:

• برای به روزرسانی های جزئی محصول از فیدهای تکمیلی جدید استفاده کنید.
• برای به روزرسانی محصولات محلی از سرویس جدید localinventory استفاده کنید.

سرویس سفارشات

cancellineitem

amount فیلدها ، amountPretax و amountTax در درخواست حذف شده است. مقدار بازپرداخت اکنون به صورت خودکار محاسبه می شود.

سفارشی

CustomBatch از v2.1 حذف شده است.

instoreerefundlineitem

Fields amountPretax و amountTax به ترتیب توسط priceAmount و taxAmount جایگزین شده اند. بسته به محل سفارش ، ممکن است Priceamount Field priceAmount قبل از مالیات یا پس از مالیات باشد.

بازپرداخت

این روش برداشته شده است. به جای آن از returnRefundLineItem استفاده کنید.

خط برگشتی

این روش برداشته شده است. به جای آن ، از returnRefundLineItem استفاده کنید.

ReturnRefundlineItem

Fields amountPretax و amountTax به ترتیب توسط priceAmount و taxAmount جایگزین شده اند. بسته به محل سفارش ، ممکن است Priceamount Field priceAmount قبل از مالیات یا پس از مالیات باشد.

کشتی خطی

carrier Fields ، shipmentId و trackingId در این درخواست به shipmentInfos منتقل شده است.

منابع سفارش و آزمایشگر

قالب تبلیغات جدید

یک قالب تبلیغاتی جدید در v2.1 وجود دارد. شما نمی توانید سفارشات تست را با تبلیغات ایجاد کنید.

حذف زمینه های مستهلک

Field paymentMethod برداشته شده است ، و billingAddress و predefinedBillingAddress BillingAddress به ترتیب در سطح بالا به Order و TestOrder هستند.

علاوه بر این ، customer.explicitMarketingPreference حذف شده و توسط customer.marketingRightsInfo جایگزین شده است. marketingrightsinfo در هر دو Order و TestOrder .

Field Field customer.email حذف شده است.

قالب قسمت promotions در منبع Order تغییر کرده است.

سرویس سفارشات

این سرویس از v2.1 حذف شده است.

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

پاسخ از insert فقط شامل ویژگی های زیر خواهد بود:

• channel
• contentLanguage
• id
• offerId
• targetCountry

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

اکنون چند دقیقه قبل از بازیابی محصول درج شده توسط get یا list تأخیر وجود دارد.

شناسه پیشنهادی برگشتی دیگر تضمین نمی شود که همانند ID ID ورودی باشد.

اکنون قیمت ها قبل از درج محصول تأیید شده است. فقط شخصیت های زیر در رشته مقدار مجاز هستند: + ، - ، . ، و رقم ( 0 - 9 ). کاما دیگر پذیرفته نشده است.

منبع محصول

گروههای سفارشی جایگزین شده توسط Customattributes بازگشتی

پیش از این ، ویژگی های سفارشی می توانند با افزودن ویژگی های سفارشی تحت همان گروه سفارشی در V2 ، گروه بندی شوند. ویژگی های سفارشی اکنون در V2.1 بازگشتی هستند ، بنابراین این نیاز به گروه های سفارشی را برطرف می کند.

ویژگی های سفارشی اکنون علاوه بر قسمت value ، دارای یک قسمت groupValues ​​اضافی نیز هستند. دقیقاً یکی از آنها باید تنظیم شود ، به این معنی که آنها نمی توانند به طور همزمان تنظیم یا کنار گذاشته شوند.

از آنجا که بازرگانان ممکن است بین V2 و V2.1 جابجا شوند ، این امکان وجود دارد که محصولات دارای ویژگی های سفارشی بازگشتی باشند که در V2 نمی توانند به عنوان گروه های سفارشی حداکثر دو سطح را نشان دهند. در این حالت ، گروه ویژگی های سفارشی کوتاه می شود.

حذف نوع و واحد در CustomAttributes

در v2.1 ، ویژگی های سفارشی دیگر حاوی یک type و unit نیستند. در عوض ، واحدها باید به value (در صورت وجود) ضمیمه شوند ، و انواع باید بطور خودکار شناسایی شوند. برای Exammple ، از "1.23 یورو" یا "5.6 سانتی متر" به عنوان value V2.1 استفاده کنید.

Productypes برتری Productype و محصولات اضافی را پشت سر می گذارد

پیش از این ، انواع محصول در دو قسمت با نوع اول در productType Singular Field و باقیمانده در زمینه مکرر additionalProductTypes ذخیره می شد. در v2.1 ، دو قسمت با یک productTypes مکرر میدانی جایگزین شده اند.

ویژگی های مقصد جایگزین شده توسط distinations و حذف موارد

مقصد به عنوان لیستی از نام مقصد و جفت های قصد در V2 در destinations مکرر میدانی وارد شد. این زمینه با دو قسمت مکرر زیر جایگزین شده است: includedDestinations و excludedDestinations . مقصد فعال شده به طور پیش فرض نیازی به گنجاندن در includedDestinations. این با پیکربندی غلبه مقصد در فیدها مطابقت دارد.

تغییر نام در زمینه های مرتبط با Adwords

با تبدیل شدن به تبلیغات Google Adwords ، زمینه های مرتبط با AdWords زیر تغییر نام داده اند:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

حذف زمینه های مستهلک

زمینه های مستهلک شده زیر حذف شده اند:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

خدمات ProductStatuses

دریافت و لیست

ویژگی product به همراه پارامتر includeAttributes حذف شد. برای بازیابی ویژگی های محصول مربوط به یک وضعیت ، از سرویس Products و ارزش قسمت جدید productId استفاده کنید.

فهرست کنید

این پارامتر includeInvalidInsertedItems حذف شده است. اکنون همه محصولات بدون در نظر گرفتن اینکه آیا معتبر هستند ، بازگردانده می شوند ، به این معنی که list اکنون به گونه ای رفتار می کند که گویا includeInvalidInsertedItems همیشه true است.

منبع

مقصد ها

intention زمینه ، approvalStatus و approvalPending در destinationStatuses جایگزین status شده است ، که رشته ای است که می تواند یکی از approved ، disapproved یا pending باشد.

حذف DataQualitySissues

این موارد توسط itemLevelIssues کنار گذاشته شده است.

،

سرویس پشتیبانی بازرگان

26 مه 2025

سرویس حساب

اکنون می توان کاربران فقط خواندنی را به حساب ها اضافه کرد.

14 آوریل 2025

سرویس حساب

از آنجا که این دیگر در آینده الزامی نخواهد بود ، سرویس accounttax کاهش یافته است.

17 مارس 2025

خدمات مربوط به سفارشات

به عنوان بخشی از خاموش کردن API های مربوط به سفارشات ، خدمات زیر کاهش یافته است:

• accounts.verifyphonenumber
• returnpolicy

سایر خدمات

این نقطه پایانی دیگر مورد نیاز نیست و می توان از آن جدا شد:

• pubsubnotificationsettings

10 فوریه 2025

قسمتهای prerendered_out_of_court_dispute_settlement به ProductIssue و AccountIssue اضافه کنید.

زمینه های متناوب alternate_dispute_resolution حل از RenderProductIssuesResponse و RenderAccountIssuesResponse .

12 دسامبر 2024

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

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

15 نوامبر 2024

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

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

30 اکتبر 2024

خدمات مرتبط با تسویه حساب

به عنوان بخشی از خاموش کردن API های مربوط به تسویه حساب ، خدمات زیر کاهش می یابد:

• settlementreports
• settlementtranscations

خاموش کردن API های مربوط به تسویه حساب مربوط به برنامه Buyongoogle که قبلاً تعطیل شده بود و API های مربوط به سفارشات مربوط می شود.

انتظار می رود تماس با خدمات فوق الذکر با یک Service was not found on the server .

16 اکتبر 2024

update_mask در UpdateConversionSourceRequest اکنون OPTIONAL است. اگر ماسک به روزرسانی مشخص نشده باشد ، تمام زمینه هایی که دارای مقدار غیر خالی هستند به روز می شوند.

26 اوت 2024 (زودتر از آنچه در ابتدا ابلاغ شده است)

خدمات مربوط به سفارشات

به عنوان بخشی از خاموش کردن API های مربوط به سفارشات ، خدمات زیر کاهش یافته است:

• orderinvoices
• orderreports
• orderreturns
• orderreturns.labels
• orders

انتظار می رود تماس با خدمات فوق الذکر با یک Service was not found on the server .

سرویس OrderTrackingSignals مستهلک نمی شود و همچنان در دسترس است.

10 آگوست 2024

خرید در Google Services

به عنوان بخشی از خرید در Google APIS خاموش ، تمام روش های موجود در BuyOnGoogleProgramService با service was not found on the server شکست می خورند.

19 جولای 2024

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

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

20 مه 2024

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

LoyaltyPrograms اضافه شده است. این به روزرسانی به شما امکان می دهد تا چندین امتیاز وفاداری ، قیمت و غیره را برای یک محصول واحد ارائه دهید. شما باید از این زمینه به جای زمینه LoyaltyProgram مفرد استفاده کنید.

گزارش خدمات

خرید مستهجن در معیارهای Google در جدول MerchantPerformanceView . پس از این بروزرسانی ، بازیابی هرگونه خرید در Google Metric Return 0. این همچنین در مورد مقادیر تاریخی برای تاریخ های گذشته نیز صدق می کند.

برای اطلاعات بیشتر ، به Buy on Google استهلاک مراجعه کنید.

13 مه 2024

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

منبع محصول

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

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

6 مه 2024

گزارش خدمات

سطل اثربخشی اضافه شده به جدول PriceInsightsProductView . اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی باعث افزایش عملکرد پیش بینی شده با تنظیم قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی می شود.

24 آوریل 2024

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

منبع محصول

قسمتهای downpayment اختیاری و creditType برای پرداخت اقساط اضافه شده است:

• downpayment مبلغی را که خریدار برای پرداخت پیش پرداخت به عنوان پرداخت یک بار پرداخت می کند ، فراهم می کند.
• creditType نوع پرداخت اقساطی ( finance یا lease ) را ارائه می دهد. این قسمت فقط در مورد تبلیغات وسیله نقلیه قابل اجرا است.

11 آوریل 2024

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

منبع محصول

• ویژگی آستانه حمل و نقل رایگان ( FreeShippingThreshold ) برای حمل و نقل در سطح پیشنهاد اضافه شده است. این ویژگی به بازرگانان اجازه می دهد تا حداقل قیمت محصول را برای هزینه حمل و نقل وارد کنند.
• دیدگاه LoyaltyPoints را تغییر داد

10 آوریل 2024

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

منبع محصول

LoyaltyProgram اضافه شده

9 آوریل 2024

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

منبع محصول

برای ارائه عناوین و توضیحات محصول تولید شده توسط AI اضافه شده ، ساخته شده structuredTitle و structuredDescription .

3 آوریل 2024

سرویس پشتیبانی بازرگان

قسمت user_input_action_option اضافه شده است که به شرکا اجازه می دهد نوع جدیدی از اقدامات را درخواست کنند: BuiltInUserInputAction . این اقدام به شرکا اجازه می دهد تا به جای هدایت آنها به مرکز بازرگان ، عملکردهای پیچیده خود را برای بازرگانان ایجاد کنند.

یک روش TriggerAction جدید برای BuiltInUserInputAction اضافه شده است. برای دسترسی به این روش ، درخواستی را به این فرم ارسال کنید.

27 مارس 2024

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

منبع محصول

AutoPricingMinPrice به عنوان یک محافظت در پروژه های "تخفیف خودکار" و "تبلیغات پویا" اضافه شد و اطمینان حاصل کرد که تخفیف در پیشنهادات بازرگانان باعث کاهش قیمت محصول به پایین تر از این ارزش نمی شود. در نتیجه ، حفظ ارزش و سودآوری پیشنهاد.

15 مارس 2024

غروب آفتاب برای جستجو و خرید در Google خریداری کنید. شما می توانید تا 31 اکتبر 2024 با استفاده از orders.list و orders.get . get.

8 مارس 2024

گزارش خدمات

گزارش TopicTrendsView به سرویس Reports اضافه شده است.

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

6 مارس 2024

گزارش خدمات

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

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

19 فوریه 2024

خدمات تبدیل منابع

مقادیر زیر را به عنوان منابع تبدیل معتبر حذف کرد:

• CROSS_CHANNEL_FIRST_CLICK
• CROSS_CHANNEL_LINEAR
• CROSS_CHANNEL_POSITION_BASED
• CROSS_CHANNEL_TIME_DECAY

گزینه های 60 و 90 را به عنوان روزهای پنجره Lookback حذف کرده و 40 را به عنوان یک گزینه معتبر اضافه کنید.

17 ژانویه 2024

سرویس PO

مقادیر جدیدی را برای قسمت matching_status_hint در Posstore اضافه کرد ، که به کاربران این امکان را می دهد تا جزئیات بیشتری در مورد عدم تطابق فروشگاه آنها داشته باشند.

11 ژانویه 2024

سرویس حساب

به ترتیب برای روش link به ترتیب localProductManager و localProductManagement اضافه شده است. اینها به حساب ها اجازه می دهد تا با هدف مدیریت داده های محصول محلی پیوند برقرار کنند.

29 نوامبر 2023

سرویس پشتیبانی بازرگان

اضافه شده VERIFY_IDENTITY_IN_MERCHANT_CENTER نوع عمل خارجی برای تأیید هویت که باید در مرکز بازرگان انجام شود.

سرویس PO

قسمتهای matching_status و مطابق با زمینه های matching_status_hint به posstore اضافه شده است که به کاربران این امکان را می دهد تا وضعیت مطابقت با فروشگاه POS را با فروشگاه پروفایل Google Business بدانند و در صورت بروز مشکل برطرف شوند.

15 نوامبر 2023

repricingrules و repricingrules.repricingreports نقاط پایانی دیگر پشتیبانی نمی شوند.

1 نوامبر 2023

سرویس تنظیمات حمل و نقل

shipment_type=pickup دیگر پشتیبانی نمی شود.

18 اکتبر 2023

سرویس حساب

زمینه Business Identity اضافه شده که به بازرگانان اجازه می دهد تا خود را با ارزش های خاص مصرف کننده شناسایی کنند.

10 اکتبر 2023

Collection Point اضافه شده به عنوان نوع جدید حمل و نقل سرویس تنظیمات حمل و نقل. تحویل نقطه جمع آوری ، خدماتی است که توسط شخص ثالث (به عنوان مثال بازرگان متعلق به آن نیست) برای ارائه این کالا به یک مکان وابسته به شخص ثالث (مانند نقاط دسترسی UPS) ، به جای تحویل مستقیم به خانه.

18 سپتامبر 2023

خدمات تنظیمات لیا

روش setOmnichannelExperience اضافه شده است تا به کاربران اجازه دهد تجربه omnichannel خود را تنظیم کنند (یعنی تنظیمات فروشگاه محلی و وانت). در این زمان ، این فقط برای کاربرانی که به ارائه دهنده POS اعتماد دارد برای فعال کردن چنین تنظیماتی در دسترس است.

7 سپتامبر 2023

خرید در Google استهلاک

افزودن وضعیت جدید DEPRECATED به روش GetBuyOnGoogleProgramStastus . فعال کردن یا مکث برنامه از چنین وضعیتی امکان پذیر نیست.

4 سپتامبر 2023

سرویس پشتیبانی بازرگان

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

28 اوت 2023

سرویس تبلیغاتی

روش list در سرویس Promotions از دسترسی محدود به همه باز کنید.

22 اوت 2023

سرویس پشتیبانی بازرگان

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

4 آگوست 2023

گزارش خدمات

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

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

25 جولای 2023

سرویس PO

منبع موجودی

قسمتهای pickup_method و pickup_sla را اضافه کنید تا بتوانید بازرگانان را برای ارسال اطلاعات وانت به همراه موجودی خود فراهم کنید.

14 جولای 2023

گزارش خدمات

گزارش های دید رقابتی را به خدمات گزارش اضافه کرد.

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

7 جولای 2023

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

منبع محصول

virtualModelLink اضافه شده برای ارائه URL به تصویر مدل سه بعدی.

4 جولای 2023

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

منبع محصول

قسمت certifications برای ارائه گواهینامه های محصول اضافه کنید ، به عنوان مثال برای برچسب زدن بهره وری انرژی محصولات بر اساس بانک اطلاعاتی EU EPREL .

26 ژوئن 2023

سرویس تنظیمات حمل و نقل

تحقق محلی

قسمت no_delivery_post_cutoff اضافه شده است تا به بازرگانان اجازه دهد از نمایش محلی N+1 روز در هنگام ارائه خدمات حمل و نقل پیکربندی شده به N Day Day Delivery محلی خودداری کنند.

29 مه 2023

سرویس تبلیغاتی

روش list برای سرویس Promotions اضافه شده است.

سرویس توصیه

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

9 مه 2023

مقصد خرده فروشی ابر

ویژگی های اضافی خرده فروشی ابر

قسمت Cloud Retail Properties اضافی را اضافه کنید. این یک زمینه مکرر است که توسط مشتریان با استفاده از مقصد خرده فروشی ابر مورد استفاده قرار می گیرد. هنگام استفاده از این قسمت ، هنگام استفاده از برنامه خرده فروشی Cloud در دسترس خواهد بود. این در زمینه ویژگی ها در مدل محصول خرده فروشی Google Cloud ترسیم می شود.

22 مه 2023

سرویس تبلیغاتی

روش list برای سرویس Promotions اضافه شده است.

11 آوریل 2023

سرویس تنظیمات حمل و نقل

تحقق محلی

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

3 آوریل

خدمات توصیه ها

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

20 فوریه 2023

سرویس حساب

منبع حساب

یک حساب بخش جدید اضافه شده است .

خدمات تبدیل منابع

سرویس منابع تبدیل را که از مدیریت منابع تبدیل (بخشی از بخش تنظیمات تبدیل در مرکز بازرگانان) پشتیبانی می کند ، اضافه کرد.

16 فوریه 2023

سرویس تنظیمات حمل و نقل

اعتبار سنجی کد را ذخیره کنید

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

اعتبار سنجی بازرگان

برنامه هایی که شناسه بازرگان در آن ثبت نام می کند ، قبل از به روزرسانی تنظیمات حمل و نقل ، اکنون تأیید شده است. بازرگانان باید در یکی از برنامه های زیر باشند:

• LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
• LOCAL_INVENTORY_ADS

9 فوریه 2023

سرویس تبلیغاتی

سرویس تبلیغات را به 6 گزینه اضافی targetCountry با پشتیبانی محلی contentLanguage گسترش دهید .:

• BR
• ES
• NL
• JP
• IT
• KR

12 ژانویه 2023

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

منبع محصول

اضافه کردن lifestyleImageLinks برای ارائه URL در تصاویر سبک زندگی.

24 نوامبر 2022

سرویس ارتقاء

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

15 نوامبر 2022

گزارش خدمات

گزارش های بینش بازار را به خدمات گزارش اضافه کرد.

اکنون می توانید خدمات گزارش را برای موارد زیر پرس و جو کنید:

• گزارش های بهترین فروشندگان با استفاده از جداول BestSellersProductClusterView و BestSellersBrandView .
• گزارش رقابت قیمت با استفاده از جدول PriceCompetitivenessProductView .
• گزارش بینش قیمت با استفاده از جدول PriceInsightsProductView .

برای اطلاعات بیشتر ، به راهنماهای گزارشگری ما مراجعه کنید.

7 نوامبر 2022

سرویس داده های داده

پشتیبانی feedLabel برای سرویس DataFeeds اضافه شده است.

14 سپتامبر 2022

feedLabel به روز شده برای پذیرش هر رشته.

9 اوت 2022

feedLabel اضافه شده برای محصولات.

اکنون می توانید به جای targetCountry از feedLabel استفاده کنید تا کشور را برای شناسه های پیشنهادی مشخص کنید. شناسه های ارائه شده اکنون به صورت online:language:feedLabel:offerId .

feedLabel به طور خودکار با مقدار targetCountry شما برای فیدهای موجود برای سازگاری به عقب جمع شده است.

targetCountry مستهلک.

برای پشتیبانی از پیشنهادات جهانی ، API محتوا برای خرید ، زمینه targetCountry را کاهش داده است. درعوض ، ما توصیه می کنیم از قسمت shipping برای مشخص کردن کشورهای هدف خود استفاده کنید.

targetCountry اکنون به طور خودکار با مقداری که در feedLabel ارائه می دهید ، جمع شده است.

Warning: Backfilled targetCountry values based on your feedLabel submission don't enable your offers to serve in the country specified in feedLabel . Use shipping to ensure your offers are able to serve in your chosen target countries.

See the blog post Feed label replaces target country in Content API for Shopping for more details.

8 دسامبر 2021

Accounts Service

Account Resource

Added a new section Account.AutomaticImprovements in the Accounts resource.

This new section will allow merchants to automatically update items, improve images and shipping settings.

25 اکتبر 2021

Promotion Service

Adding Get Promotion to the Promotion API.

11 اکتبر 2021

Shipping Settings API

Added new warehouse field in ShippingSettings resource to allow merchants to manage the warehouses which can be used in WarehouseBasedDeliveryTime .

Add new warehouseName field in WarehouseBasedDeliveryTime to refer to warehouse by warehouse name.

4 اکتبر 2021

Accounts Service

Account Resource

Added a new field 'phone_verification_status' in the Accounts.BusinessInformation section. This is a read-only field, set by Accounts.VerifyPhoneNumber .

Sept 13, 2021

BuyOnGooglePrograms service

BuyOnGoogleProgramStatus resource

Added new fields in the BuyOnGooglePrograms.BuyOnProgramStatus resource respresnting: online sales channels, business models and customer service phone.

New UpdateBuyOnGoogleProgramStatus method

Added a new UpdateBuyOnGoogleProgramStatus method which will allow to update extended BuyOnGooglePrograms.BuyOnProgramStatus resource.

Sept 6, 2021

Accounts Service

Account Resource

Added a new field 'korean_business_registration_number' in the Accounts.BusinessInformation section. This field will only be cleared if explicitly set to an empty string.

30 اوت 2021

Promotion Service

Added a new Promotion Service with Insert Promotion available.

Orders Service

Added a new method orders/captureOrder to capture funds before shipment.

New order cancellation reason FAILED_TO_CAPTURE_FUNDS

Products Service

Product Resource

Added productLength , productHeight , productWidth and productWeight to provide product dimensions and weight.

9 اوت 2021

RepricingRule Service

RepricingRule Type

New enum value for RepricingRuleType field.

Added TYPE_SALES_VOLUME_BASED and TYPE_COMPETITIVE_PRICE .

17 مه 2021

Order Returns Label Service

Added a new 'product_id' field in the CreateReturnRequest. Merchants can specify either the product_id or line_item_id to identify the item to return.

Products Service

Added a new method to update existing products . You can update a product by only providing the fields that need to be updated instead of the whole product.

3 مه 2021

Order Returns Label Service

Added new methods to upload labels for Merchant Managed Returns (MMR). With the new orderreturns.labels.create , you can upload the return labels, to share them with the customer.

26 آوریل 2021

Shipping Settings API

New warehouseBasedDeliveryTimes field in DeliveryTime to support shipping services calculating the estimated delivery date based on the warehouse location and the chosen carrier service.

New eddServices field in CarriersCarrier object to return names of the services applicable for calculating the estimated delivery date.

12 آوریل 2021

Products Service

Product Resource

New additionalSizeType field to support up to 2 size types per product.

Changes to shipping field: Added minHandlingTime , maxHandlingTime , minTransitTime and maxTransitTime to ProductShipping to provide offer level shipping speed.

28 ژانویه 2021

Accounts Service

Added automatic labels support to AccountLabel and Account resources. For more information, see CSS Label types section in the CSS Label management guide.

5 اکتبر 2020

CSSES Service

CSS Resource

Added a new csses service for retrieving information about CSS domains and assigning labels to them. The AccountLabel resource can now also be used for creating and listing CSS group level labels. For more information, see CSS Label Management .

24 آگوست 2020

Products Service

Products Resource

New shoppingAdsExcludedCountries field to exclude offers from advertising in certain countries.

Productstatuses Resource

New approvedCountries , pendingCountries and disapprovedCountries fields in destinationStatuses object which provide for offer status information beyond targetCountry .

New itemLevelIssues.applicableCountries field.

10 آگوست 2020

Accounts Service

Added a new AccountLabel resource for managing Merchant Center account labels for CSS Center. CSS Center users can now also list their Merchant Center accounts and assign labels to them with accounts.list , accounts.get and accounts.updatelabels methods. For more information, see CSS Label Management .

19 ژوئن 2020

Products Service

Product Resource

New fields

New productDetails , productHighlights , subscriptionCost , and canonicalLink fields.

2 ژوئن 2020

Orders Service

Added new methods to initiate refunds without returns. With the new orders.refunditem and orders.refundorder , you can initiate refunds on orders even if they are not returned by the customer.

27 آوریل 2020

Orderreturns Service

Added new methods acknowledge and process , and new filters and fields for read methods ( list , get ).

GMB linking

Added the ability to link Merchant Center accounts to a GMB account using the GMB account ID .

14 آوریل 2020

Settlement Report APIs

Added a new service for getting settlement reports .

9 مارس 2020

Local inventory API

Added a new service for submitting local inventory data.

2 مارس 2020

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications .

3 دسامبر 2019

Products Service

Added support for multi-client account supplemental Content API feeds.

11 سپتامبر 2019

Orders Service

Added support for pickup shipments in orders and corresponding sandbox features.

14 آگوست 2019

خدمات جدید

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

New field

New quantityUndeliverable field.

7 آگوست 2019

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

1 جولای 2019

Products Service

Support for supplemental Content API feeds added in the Products service.

11 ژوئن 2019

Orders Service

Order and TestOrder Resources

Addition of price adjustment

Added new lineItem[].adjustments field that contains adjustment to original line item price and tax caused by applying promotions.

14 فوریه 2019

Changes introduced in this version

Dry runs no longer supported

The parameter dryRun has been removed from v2.1. This applies to all API calls.

Patch methods no longer supported

The following services no longer support the patch method:

• حساب ها
• Accounttax
• Datafeeds
• Liasettings
• Shippingsettings

Removal of HTTP BATCH methods

All HTTP BATCH methods have been removed from v2.1. Use customBatch instead. The affected services are the following:

• حساب ها
• Accountstatuses
• Datafeeds
• Datafeedstatuses
• Liasettings
• Orderreports
• پوز
• محصولات
• Productstatuses
• Shippingsettings

Accounts Service

به روز رسانی

The fields businessInformation and googleMyBusinessLink in the request were introduced after the initial launch of Content API v2. Due to this, there is a safeguard that prevents merchants from unintentionally deleting information in these two fields with update if they are not provided.

In v2, merchants must explicitly provide these fields with an empty body ( {} ) to delete them. In v2.1, fields are deleted if you provide an empty body, or if you don't provide them.

Account Resource

AdWords -> Google Ads rebranding

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

Removal of deprecated fields and values

The deprecated field reviewsUrl has been removed. In addition, the link status inactive has been removed for adsLinks , googleMyBusinessLink , and youtubeChannelLinks .

Accountstatuses Service

AccountStatus Resource

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

Datafeed Service

Datafeed Resource

Removal of deprecated fields

The fields contentLanguage , targetCountry , and intendedDestinations have been removed and replaced by country , language , includedDestinations , and excludedDestinations in targets .

Removal of product inventory update

Feeds of type product inventory update have been removed.

Inventory Service

The v2 inventory service has been removed and replaced by two new features in v2.1:

• Use new Supplemental Feeds for partial product updates.
• Use the new localinventory service for local product updates.

Orders Service

CancelLineItem

The fields amount , amountPretax , and amountTax in the request have been removed. The refunded amount is now calculated automatically.

CustomBatch

CustomBatch has been removed from v2.1.

InStoreRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

بازپرداخت

This method has been removed. Use returnRefundLineItem instead.

ReturnLineItem

This method has been removed. Use returnRefundLineItem without providing a refund amount instead.

ReturnRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

ShipLineItem

The fields carrier , shipmentId , and trackingId in the request have been moved to shipmentInfos .

Order and TestOrder Resources

New promotion format

There is a new promotion format in v2.1. You can't create test orders with promotions.

Removal of deprecated fields

The field paymentMethod has been removed, and billingAddress and predefinedBillingAddress are now top-level fields in Order and TestOrder , respectively.

Furthermore, customer.explicitMarketingPreference has been removed and replaced by customer.marketingRightsInfo in both Order and TestOrder .

The deprecated field customer.email has been removed.

The format of the promotions field has changed in the Order resource.

Orderpayments Service

This service has been removed from v2.1.

Products Service

Response from an insert will contain only the following attributes:

• channel
• contentLanguage
• id
• offerId
• targetCountry

Nonfatal warnings and errors are no longer returned in the response. This allows for better integration with feed rules and other advanced feed management features.

There is now a delay of a few minutes before an inserted product can be retrieved by get or list .

The returned offer ID is no longer guaranteed to be the same as the input offer ID.

Prices are now validated before product insertion. Only the following characters are allowed in the value string: + , - , . , and digits ( 0 - 9 ). Commas are no longer accepted.

Product Resource

CustomGroups replaced by recursive customAttributes

Previously, custom attributes could be grouped together by adding custom attributes under the same custom group in v2. Custom attributes are now recursive in v2.1, so this removes the need for custom groups.

Custom attributes now have an additional groupValues field in addition to the original value field; exactly one of them must be set, meaning they cannot be simultaneously set or left out.

As merchants may switch between v2 and v2.1, it is possible for products to have recursive custom attributes which cannot be represented in v2 as custom groups have a maximum of two levels. In this case, the custom attribute group will be truncated.

Removal of type and unit in customAttributes

In v2.1, custom attributes will no longer contain a type and unit . Instead, units are to be appended to the value (if present), and types should be automatically detected. For exammple, use "1.23 EUR" or "5.6 cm" as the value in v2.1.

ProductTypes supersedes productType and additionalProductTypes

Previously, product types were stored in two fields with the first type in the singular field productType and the remaining in the repeated field additionalProductTypes . In v2.1, the two fields have been replaced by a single repeated field productTypes .

Destinations attribute replaced by includedDestinations and excludedDestinations

Destinations were input as a list of destination name and intention pairs in v2 in the repeated field destinations . This field has been replaced by the following two repeated fields: includedDestinations and excludedDestinations . Destinations enabled by default need not be included in includedDestinations. This will match the configuration of destination overrides in feeds.

Renaming of AdWords-related fields

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

Removal of deprecated fields

The following deprecated fields have been removed:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

Productstatuses Service

Get and List

The product attribute was removed, along with the includeAttributes parameter. To retrieve attributes of the product corresponding to a status, use the Products service and the value of the new productId field.

فهرست کنید

The parameter includeInvalidInsertedItems has been removed. All products are now returned regardless of whether they are valid, meaning list now behaves as if includeInvalidInsertedItems is always set to true .

ProductStatus Resource

DestinationsStatuses

The fields intention , approvalStatus , and approvalPending in destinationStatuses have been replaced by status , which is a string that can be one of approved , disapproved , or pending .

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

،

Merchant Support Service

26 مه 2025

Accounts service

It is now possible to add read-only users to accounts.

14 آوریل 2025

Accounts service

As this will no longer being a requirement in the future, the accounttax service has been deprecated.

17 مارس 2025

Orders-related services

As part of the Orders-related APIs shutdown , the following services have been deprecated:

• accounts.verifyphonenumber
• returnpolicy

سایر خدمات

This endpoint is no longer required and can be deprecated:

• pubsubnotificationsettings

10 فوریه 2025

Added prerendered_out_of_court_dispute_settlement fields to ProductIssue and to AccountIssue .

Deprecated alternate_dispute_resolution fields from RenderProductIssuesResponse and RenderAccountIssuesResponse .

12 دسامبر 2024

Products Service

Added the sustainability_incentives field to specify sustainability incentives such as tax credit or price discount for your products. If the field value isn't provided, the item is not eligible for any sustainability incentives.

15 نوامبر 2024

Products Service

For LoyaltyProgram , added the shipping_label field to specify eligibility. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.

30 اکتبر 2024

Settlement-related services

As part of the Settlement-related APIs shutdown, the following services are deprecated:

• settlementreports
• settlementtranscations

The Settlement-related APIs shutdown is related to the previously shut down BuyOnGoogle program and Orders-related APIs.

Calls to the aforementioned services are expected to fail with a Service was not found on the server response.

16 اکتبر 2024

update_mask in UpdateConversionSourceRequest is now OPTIONAL . If no update mask is specified, all fields that have a non-empty value are updated.

August 26, 2024 (sooner than originally communicated)

Orders-related services

As part of the Orders-related APIs shutdown , the following services have been deprecated:

• orderinvoices
• orderreports
• orderreturns
• orderreturns.labels
• orders

Calls to the aforementioned services are expected to fail with a Service was not found on the server response.

The OrderTrackingSignals service is not deprecated and continues to be available.

10 آگوست 2024

Buy on Google services

As part of Buy on Google APIs shutdown all the methods within BuyOnGoogleProgramService will fail with service was not found on the server .

19 جولای 2024

Products Service

Added the member_price_effective_date field. This update lets you specify, if applicable, the date range during which the loyalty member price is effective. If the field value isn't provided, the member price is always effective.

20 مه 2024

Products Service

Added LoyaltyPrograms . This update lets you provide multiple tiers with different loyalty points, prices, etc. for a single product. You should use this field in place of the singular LoyaltyProgram field.

Reports Service

Deprecated Buy on Google metrics in the MerchantPerformanceView table. After this update, retrieving any Buy on Google metric returns 0. This also applies to historical values for past dates.

For more information, see Buy on Google deprecation .

13 مه 2024

Products Service

Product Resource

Changes to certifications field: Added certificationValue to the ProductCertification field to provide certification value (also known as class, level, or grade), which lets users upload certification information even if the certification authority doesn't issue certification code or number.

For more information, see our Products guides .

6 مه 2024

Reports Service

Added effectiveness bucket to the PriceInsightsProductView table. Effectiveness indicates which products would benefit most from price changes. This rating takes into consideration the performance boost predicted by adjusting the sale price and the difference between your current price and the suggested price.

24 آوریل 2024

Products Service

Product Resource

Added optional downpayment and creditType fields for Installment payments :

• downpayment provides the amount the buyer has to pay upfront as a one-time payment.
• creditType provides the type of installment payment ( finance or lease ). This field is only applicable to Vehicle Ads.

11 آوریل 2024

Products Service

Product Resource

• Added free shipping threshold attribute ( FreeShippingThreshold ) for offer-level shipping. This attribute lets merchants input a minimum product price for the shipping cost to become free.
• Changed the visibility of LoyaltyPoints

10 آوریل 2024

Products Service

Product Resource

Added LoyaltyProgram

9 آوریل 2024

Products Service

Product Resource

Added structuredTitle and structuredDescription to provide AI-generated product titles and descriptions.

3 آوریل 2024

Merchant Support Service

Added user_input_action_option field that lets partners request a new type of action: BuiltInUserInputAction . This action lets partners build complex self-serve functionality for merchants, directly in their application instead of redirecting them to the Merchant Center.

Added a new TriggerAction method for BuiltInUserInputAction . To access this method, submit a request to this form .

27 مارس 2024

Products Service

Product Resource

Added AutoPricingMinPrice as a safeguard in the "Automated Discounts" and "Dynamic Promotions" projects, ensuring that discounts on merchants' offers don't reduce the product price to lower than this value. Thereby, preserving the offer's value and profitability.

15 مارس 2024

Sunset Buy on Google for Search and Shopping. You can continue to view existing orders until October 31, 2024 using orders.list and orders.get .

8 مارس 2024

Reports Service

Added TopicTrendsView report to the Reports service.

For more information, see our Reporting guides .

6 مارس 2024

Reports service

Added click potential bucket and rank for products.

For more information, see our Reporting guides .

19 فوریه 2024

ConversionSources Service

Removed the following values as valid conversion sources:

• CROSS_CHANNEL_FIRST_CLICK
• CROSS_CHANNEL_LINEAR
• CROSS_CHANNEL_POSITION_BASED
• CROSS_CHANNEL_TIME_DECAY

Removed the options of 60 and 90 as lookback window days and added 40 as a valid option.

17 ژانویه 2024

POS service

Added new values for the matching_status_hint field in PosStore , which lets users to have more details about why their store matching has failed.

11 ژانویه 2024

Accounts service

Added localProductManager and localProductManagement as link type and service respectively for the link method. These allow for accounts to link with the purpose of managing local product data.

29 نوامبر 2023

Merchant Support Service

Added VERIFY_IDENTITY_IN_MERCHANT_CENTER external action type for identity verification that needs to be performed in the Merchant Center.

POS service

Added matching_status and matching_status_hint fields to PosStore which lets users to know matching status of Pos Store with Google Business Profile Store and hint to fix in case of an issue.

15 نوامبر 2023

repricingrules and repricingrules.repricingreports endpoints are no longer supported.

1 نوامبر 2023

Shipping Settings service

The shipment_type=pickup is no longer supported.

18 اکتبر 2023

Accounts service

Added Business Identity field that allows merchants to self-identify to certain consumer values .

10 اکتبر 2023

Added Collection Point as a new shipment type of shipping settings service. A collection point delivery is a service provided by a third party (eg not merchant owned) to deliver the item to a third party affiliated location (like UPS Access Points), instead of delivering directly to the home.

18 سپتامبر 2023

LIA settings service

Added setOmnichannelExperience method to allow users to set their omnichannel experience (that is, local storefront and pick-up settings). By this time, this is only available for users whose POS provider is trusted to enable such settings.

7 سپتامبر 2023

Buy on Google deprecation

Adding a new DEPRECATED status into the GetBuyOnGoogleProgramStastus method. Reactivating or pausing the program from such a state is not possible.

4 سپتامبر 2023

Merchant Support Service

Added FIX_ACCOUNT_ISSUE built-in action for product issues that needs to be resolved on the account level. Added SHOW_ADDITIONAL_CONTENT built-in action that will be used to deliver a justification from a national authority.

28 اوت 2023

Promotions service

Open list method in Promotions service from limited access to all.

22 اوت 2023

Merchant Support Service

Launched Merchant Support Service. This service provides a support content for account issues and product issues.

4 آگوست 2023

Reports Service

Added Close Competitors Competitive Visibility report to Reports service.

For more information, see our Reporting guides .

25 جولای 2023

POS Service

Inventory Resource

Add pickup_method and pickup_sla fields to provide an ability for merchants to submit pickup information along with their inventory.

14 جولای 2023

Reports Service

Added Competitive Visibility reports to Reports service.

For more information, see our Reporting guides .

7 جولای 2023

Products Service

Product Resource

Added virtualModelLink to provide URLs to 3D model image.

4 جولای 2023

Products Service

Product Resource

Add certifications field to provide product certifications, for example for energy efficiency labeling of products based on the EU EPREL database.

26 ژوئن 2023

Shipping Settings service

Local Fulfillment

Added no_delivery_post_cutoff field to allow merchants to opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery.

29 مه 2023

Promotions service

Added list method for the Promotions service.

Recommendation service

Enable interaction dismiss in the ReportInteraction method of the Recommendations service.

9 مه 2023

Cloud Retail Destination

Cloud Retail Additional Properties

Add the cloud retail additional properties field. This is a repeated field intended to be used by customers using the Cloud Retail destination. When this field is used it will be available when using the cloud retail program. This will be mapped to the attributes field in the Google Cloud Retail product model.

22 مه 2023

Promotions service

Added list method for the Promotions service.

11 آوریل 2023

Shipping Settings service

Local Fulfillment

Added the local delivery fulfillment option for merchants creating a new shipping setting. They can configure their settings for local stores in the new storeConfig field. This includes the service radius, cutoff time, and store codes for the stores offering local delivery.

3 آوریل

Recommendations Service

Launched Recommendations Service. This service provides suggested ways to improve the performance of your merchant account and lets you report merchant clicks on helpful recommendations.

20 فوریه 2023

Accounts Service

Account Resource

Added a new section Account.ConversionSettings in the Accounts resource.

ConversionSources Service

Added the Conversion Sources service, which supports managing conversion sources (part of the Conversion Settings section in Merchant Center).

16 فوریه 2023

Shipping Settings service

Store code validation

Store codes are now validated to ensure that they belong to the merchant before shipping settings are updated.

LIA merchant validation

Programs a Merchant ID is enrolled in are now validated before shipping settings are updated. Merchants must be in one of the following programs:

• LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
• LOCAL_INVENTORY_ADS

9 فوریه 2023

Promotions Service

Expand Promotions service to 6 additional targetCountry options with local contentLanguage support.:

• BR
• ES
• NL
• JP
• IT
• KR

12 ژانویه 2023

Products Service

Product Resource

Added lifestyleImageLinks to provide URLs to lifestyle images.

24 نوامبر 2022

Promotion Service

Added a new field `promotionStatus' in the Promotions.PromotionStatus section. This is a read only field.

15 نوامبر 2022

Reports Service

Added Market Insights reports to Reports service.

You can now query Reports service for the following:

• Best sellers reports using BestSellersProductClusterView and BestSellersBrandView tables.
• Price competitiveness report using PriceCompetitivenessProductView table.
• Price insights report using PriceInsightsProductView table.

For more information, see our Reporting guides .

7 نوامبر 2022

Datafeeds Service

Added feedLabel support for Datafeeds service.

Sept 14, 2022

Updated feedLabel to accept any string.

9 اوت 2022

Added feedLabel for products.

You can now use feedLabel instead of targetCountry to specify the country for offer IDs. Offer IDs are now constructed as online:language:feedLabel:offerId .

feedLabel has been automatically populated with your targetCountry value for existing feeds for backwards compatibility.

Deprecated targetCountry .

To support global offers, the Content API for Shopping has deprecated the targetCountry field. Instead, we recommend using the shipping field to specify your target countries.

targetCountry is now automatically populated with the value you provide in feedLabel .

Warning: Backfilled targetCountry values based on your feedLabel submission don't enable your offers to serve in the country specified in feedLabel . Use shipping to ensure your offers are able to serve in your chosen target countries.

See the blog post Feed label replaces target country in Content API for Shopping for more details.

8 دسامبر 2021

Accounts Service

Account Resource

Added a new section Account.AutomaticImprovements in the Accounts resource.

This new section will allow merchants to automatically update items, improve images and shipping settings.

25 اکتبر 2021

Promotion Service

Adding Get Promotion to the Promotion API.

11 اکتبر 2021

Shipping Settings API

Added new warehouse field in ShippingSettings resource to allow merchants to manage the warehouses which can be used in WarehouseBasedDeliveryTime .

Add new warehouseName field in WarehouseBasedDeliveryTime to refer to warehouse by warehouse name.

4 اکتبر 2021

Accounts Service

Account Resource

Added a new field 'phone_verification_status' in the Accounts.BusinessInformation section. This is a read-only field, set by Accounts.VerifyPhoneNumber .

Sept 13, 2021

BuyOnGooglePrograms service

BuyOnGoogleProgramStatus resource

Added new fields in the BuyOnGooglePrograms.BuyOnProgramStatus resource respresnting: online sales channels, business models and customer service phone.

New UpdateBuyOnGoogleProgramStatus method

Added a new UpdateBuyOnGoogleProgramStatus method which will allow to update extended BuyOnGooglePrograms.BuyOnProgramStatus resource.

Sept 6, 2021

Accounts Service

Account Resource

Added a new field 'korean_business_registration_number' in the Accounts.BusinessInformation section. This field will only be cleared if explicitly set to an empty string.

30 اوت 2021

Promotion Service

Added a new Promotion Service with Insert Promotion available.

Orders Service

Added a new method orders/captureOrder to capture funds before shipment.

New order cancellation reason FAILED_TO_CAPTURE_FUNDS

Products Service

Product Resource

Added productLength , productHeight , productWidth and productWeight to provide product dimensions and weight.

9 اوت 2021

RepricingRule Service

RepricingRule Type

New enum value for RepricingRuleType field.

Added TYPE_SALES_VOLUME_BASED and TYPE_COMPETITIVE_PRICE .

17 مه 2021

Order Returns Label Service

Added a new 'product_id' field in the CreateReturnRequest. Merchants can specify either the product_id or line_item_id to identify the item to return.

Products Service

Added a new method to update existing products . You can update a product by only providing the fields that need to be updated instead of the whole product.

3 مه 2021

Order Returns Label Service

Added new methods to upload labels for Merchant Managed Returns (MMR). With the new orderreturns.labels.create , you can upload the return labels, to share them with the customer.

26 آوریل 2021

Shipping Settings API

New warehouseBasedDeliveryTimes field in DeliveryTime to support shipping services calculating the estimated delivery date based on the warehouse location and the chosen carrier service.

New eddServices field in CarriersCarrier object to return names of the services applicable for calculating the estimated delivery date.

12 آوریل 2021

Products Service

Product Resource

New additionalSizeType field to support up to 2 size types per product.

Changes to shipping field: Added minHandlingTime , maxHandlingTime , minTransitTime and maxTransitTime to ProductShipping to provide offer level shipping speed.

28 ژانویه 2021

Accounts Service

Added automatic labels support to AccountLabel and Account resources. For more information, see CSS Label types section in the CSS Label management guide.

5 اکتبر 2020

CSSES Service

CSS Resource

Added a new csses service for retrieving information about CSS domains and assigning labels to them. The AccountLabel resource can now also be used for creating and listing CSS group level labels. For more information, see CSS Label Management .

24 آگوست 2020

Products Service

Products Resource

New shoppingAdsExcludedCountries field to exclude offers from advertising in certain countries.

Productstatuses Resource

New approvedCountries , pendingCountries and disapprovedCountries fields in destinationStatuses object which provide for offer status information beyond targetCountry .

New itemLevelIssues.applicableCountries field.

10 آگوست 2020

Accounts Service

Added a new AccountLabel resource for managing Merchant Center account labels for CSS Center. CSS Center users can now also list their Merchant Center accounts and assign labels to them with accounts.list , accounts.get and accounts.updatelabels methods. For more information, see CSS Label Management .

19 ژوئن 2020

Products Service

Product Resource

New fields

New productDetails , productHighlights , subscriptionCost , and canonicalLink fields.

2 ژوئن 2020

Orders Service

Added new methods to initiate refunds without returns. With the new orders.refunditem and orders.refundorder , you can initiate refunds on orders even if they are not returned by the customer.

27 آوریل 2020

Orderreturns Service

Added new methods acknowledge and process , and new filters and fields for read methods ( list , get ).

GMB linking

Added the ability to link Merchant Center accounts to a GMB account using the GMB account ID .

14 آوریل 2020

Settlement Report APIs

Added a new service for getting settlement reports .

9 مارس 2020

Local inventory API

Added a new service for submitting local inventory data.

2 مارس 2020

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications .

3 دسامبر 2019

Products Service

Added support for multi-client account supplemental Content API feeds.

11 سپتامبر 2019

Orders Service

Added support for pickup shipments in orders and corresponding sandbox features.

14 آگوست 2019

خدمات جدید

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

New field

New quantityUndeliverable field.

7 آگوست 2019

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

1 جولای 2019

Products Service

Support for supplemental Content API feeds added in the Products service.

11 ژوئن 2019

Orders Service

Order and TestOrder Resources

Addition of price adjustment

Added new lineItem[].adjustments field that contains adjustment to original line item price and tax caused by applying promotions.

14 فوریه 2019

Changes introduced in this version

Dry runs no longer supported

The parameter dryRun has been removed from v2.1. This applies to all API calls.

Patch methods no longer supported

The following services no longer support the patch method:

• حساب ها
• Accounttax
• Datafeeds
• Liasettings
• Shippingsettings

Removal of HTTP BATCH methods

All HTTP BATCH methods have been removed from v2.1. Use customBatch instead. The affected services are the following:

• حساب ها
• Accountstatuses
• Datafeeds
• Datafeedstatuses
• Liasettings
• Orderreports
• پوز
• محصولات
• Productstatuses
• Shippingsettings

Accounts Service

به روز رسانی

The fields businessInformation and googleMyBusinessLink in the request were introduced after the initial launch of Content API v2. Due to this, there is a safeguard that prevents merchants from unintentionally deleting information in these two fields with update if they are not provided.

In v2, merchants must explicitly provide these fields with an empty body ( {} ) to delete them. In v2.1, fields are deleted if you provide an empty body, or if you don't provide them.

Account Resource

AdWords -> Google Ads rebranding

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

Removal of deprecated fields and values

The deprecated field reviewsUrl has been removed. In addition, the link status inactive has been removed for adsLinks , googleMyBusinessLink , and youtubeChannelLinks .

Accountstatuses Service

AccountStatus Resource

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

Datafeed Service

Datafeed Resource

Removal of deprecated fields

The fields contentLanguage , targetCountry , and intendedDestinations have been removed and replaced by country , language , includedDestinations , and excludedDestinations in targets .

Removal of product inventory update

Feeds of type product inventory update have been removed.

Inventory Service

The v2 inventory service has been removed and replaced by two new features in v2.1:

• Use new Supplemental Feeds for partial product updates.
• Use the new localinventory service for local product updates.

Orders Service

CancelLineItem

The fields amount , amountPretax , and amountTax in the request have been removed. The refunded amount is now calculated automatically.

CustomBatch

CustomBatch has been removed from v2.1.

InStoreRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

بازپرداخت

This method has been removed. Use returnRefundLineItem instead.

ReturnLineItem

This method has been removed. Use returnRefundLineItem without providing a refund amount instead.

ReturnRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

ShipLineItem

The fields carrier , shipmentId , and trackingId in the request have been moved to shipmentInfos .

Order and TestOrder Resources

New promotion format

There is a new promotion format in v2.1. You can't create test orders with promotions.

Removal of deprecated fields

The field paymentMethod has been removed, and billingAddress and predefinedBillingAddress are now top-level fields in Order and TestOrder , respectively.

Furthermore, customer.explicitMarketingPreference has been removed and replaced by customer.marketingRightsInfo in both Order and TestOrder .

The deprecated field customer.email has been removed.

The format of the promotions field has changed in the Order resource.

Orderpayments Service

This service has been removed from v2.1.

Products Service

Response from an insert will contain only the following attributes:

• channel
• contentLanguage
• id
• offerId
• targetCountry

Nonfatal warnings and errors are no longer returned in the response. This allows for better integration with feed rules and other advanced feed management features.

There is now a delay of a few minutes before an inserted product can be retrieved by get or list .

The returned offer ID is no longer guaranteed to be the same as the input offer ID.

Prices are now validated before product insertion. Only the following characters are allowed in the value string: + , - , . , and digits ( 0 - 9 ). Commas are no longer accepted.

Product Resource

CustomGroups replaced by recursive customAttributes

Previously, custom attributes could be grouped together by adding custom attributes under the same custom group in v2. Custom attributes are now recursive in v2.1, so this removes the need for custom groups.

Custom attributes now have an additional groupValues field in addition to the original value field; exactly one of them must be set, meaning they cannot be simultaneously set or left out.

As merchants may switch between v2 and v2.1, it is possible for products to have recursive custom attributes which cannot be represented in v2 as custom groups have a maximum of two levels. In this case, the custom attribute group will be truncated.

Removal of type and unit in customAttributes

In v2.1, custom attributes will no longer contain a type and unit . Instead, units are to be appended to the value (if present), and types should be automatically detected. For exammple, use "1.23 EUR" or "5.6 cm" as the value in v2.1.

ProductTypes supersedes productType and additionalProductTypes

Previously, product types were stored in two fields with the first type in the singular field productType and the remaining in the repeated field additionalProductTypes . In v2.1, the two fields have been replaced by a single repeated field productTypes .

Destinations attribute replaced by includedDestinations and excludedDestinations

Destinations were input as a list of destination name and intention pairs in v2 in the repeated field destinations . This field has been replaced by the following two repeated fields: includedDestinations and excludedDestinations . Destinations enabled by default need not be included in includedDestinations. This will match the configuration of destination overrides in feeds.

Renaming of AdWords-related fields

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

Removal of deprecated fields

The following deprecated fields have been removed:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

Productstatuses Service

Get and List

The product attribute was removed, along with the includeAttributes parameter. To retrieve attributes of the product corresponding to a status, use the Products service and the value of the new productId field.

فهرست کنید

The parameter includeInvalidInsertedItems has been removed. All products are now returned regardless of whether they are valid, meaning list now behaves as if includeInvalidInsertedItems is always set to true .

ProductStatus Resource

DestinationsStatuses

The fields intention , approvalStatus , and approvalPending in destinationStatuses have been replaced by status , which is a string that can be one of approved , disapproved , or pending .

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .