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

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 اضافه شد.

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

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

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

برای جزئیات بیشتر به پست وبلاگ مراجعه کنید. برچسب فید جایگزین کشور هدف در 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 اکنون به ترتیب فیلدهای سطح بالایی در 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 به 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 جایگزین شده اند.