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

۱۸ آگوست ۲۰۲۵

رابط برنامه‌نویسی محتوا منسوخ شده و در آگوست ۲۰۲۶ غیرفعال خواهد شد. به رابط برنامه‌نویسی تجاری (Merchant API) مهاجرت کنید.

۱۹ ژوئن ۲۰۲۵

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

منبع محصول

فیلد maximum_retail_price برای فعال کردن تعیین حداکثر قیمت خرده فروشی (MRP) در هند اضافه شد.

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

۲۶ مه ۲۰۲۵

خدمات حساب‌ها

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

۱۴ آوریل ۲۰۲۵

خدمات حساب‌ها

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

۱۷ مارس ۲۰۲۵

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

  • accounts.verifyphonenumber
  • returnpolicy

سایر خدمات

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

  • pubsubnotificationsettings

۱۰ فوریه ۲۰۲۵

فیلدهای prerendered_out_of_court_dispute_settlement » و «تصمیم‌گیری» به ProductIssue و AccountIssue اضافه شدند.

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

۱۲ دسامبر ۲۰۲۴

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

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

۱۵ نوامبر ۲۰۲۴

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

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

۳۰ اکتبر ۲۰۲۴

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

  • settlementreports
  • settlementtranscations

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

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

۱۶ اکتبر ۲۰۲۴

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

۲۶ آگوست ۲۰۲۴ (زودتر از زمان اعلام‌شده)

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

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

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

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

۱۰ آگوست ۲۰۲۴

خرید از سرویس‌های گوگل

به عنوان بخشی از فرآیند خرید از APIهای گوگل، تمام متدهای درون BuyOnGoogleProgramService با خطای service was not found on the server خاموش می‌شوند.

۱۹ ژوئیه ۲۰۲۴

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

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

۲۰ مه ۲۰۲۴

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

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

سرویس گزارش‌ها

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

برای اطلاعات بیشتر، به بخش منسوخ‌شده‌ی «خرید از گوگل» مراجعه کنید.

۱۳ مه ۲۰۲۴

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

منبع محصول

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

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

۶ مه ۲۰۲۴

سرویس گزارش‌ها

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

۲۴ آوریل ۲۰۲۴

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

منبع محصول

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

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

۱۱ آوریل ۲۰۲۴

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

منبع محصول

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

۱۰ آوریل ۲۰۲۴

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

منبع محصول

LoyaltyProgram اضافه شد

۹ آوریل ۲۰۲۴

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

منبع محصول

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

۳ آوریل ۲۰۲۴

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

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

یک متد جدید TriggerAction برای BuiltInUserInputAction اضافه شد. برای دسترسی به این متد، یک درخواست لیست دسترسی در فرم پشتیبانی API خرید، در قسمت «مشکل/سوال چیست؟» ارسال کنید.

۲۷ مارس ۲۰۲۴

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

منبع محصول

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

۱۵ مارس ۲۰۲۴

خرید غروب آفتاب در گوگل برای جستجو و خرید. شما می‌توانید سفارش‌های موجود را تا ۳۱ اکتبر ۲۰۲۴ با استفاده از orders.list و orders.get مشاهده کنید.

۸ مارس ۲۰۲۴

سرویس گزارش‌ها

Added TopicTrendsView report to the Reports service.

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

۶ مارس ۲۰۲۴

سرویس گزارش‌ها

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

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

۱۹ فوریه ۲۰۲۴

سرویس ConversionSources

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

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

گزینه‌های ۶۰ و ۹۰ به عنوان روزهای پنجره‌ی بازگشت به عقب حذف و ۴۰ به عنوان یک گزینه‌ی معتبر اضافه شد.

۱۷ ژانویه ۲۰۲۴

خدمات پایانه فروش (POS)

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

۱۱ ژانویه ۲۰۲۴

خدمات حساب‌ها

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

۲۹ نوامبر ۲۰۲۳

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

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

خدمات پایانه فروش (POS)

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

۱۵ نوامبر ۲۰۲۳

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

۱ نوامبر ۲۰۲۳

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

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

۱۸ اکتبر ۲۰۲۳

خدمات حساب‌ها

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

۱۰ اکتبر ۲۰۲۳

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

۱۸ سپتامبر ۲۰۲۳

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

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.

۷ سپتامبر ۲۰۲۳

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

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

۴ سپتامبر ۲۰۲۳

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

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

۲۸ آگوست ۲۰۲۳

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

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

۲۲ آگوست ۲۰۲۳

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

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

۴ آگوست ۲۰۲۳

سرویس گزارش‌ها

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

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

۲۵ ژوئیه ۲۰۲۳

خدمات پایانه فروش (POS)

منبع موجودی

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

۱۴ ژوئیه ۲۰۲۳

سرویس گزارش‌ها

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

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

۷ ژوئیه ۲۰۲۳

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

منبع محصول

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

۴ ژوئیه ۲۰۲۳

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

منبع محصول

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

۲۶ ژوئن ۲۰۲۳

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

تکمیل سفارشات محلی

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

۲۹ مه ۲۰۲۳

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

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

خدمات توصیه

فعال کردن قابلیت رد تعامل (interaction dismiss) در متد ReportInteraction از سرویس Recommendations.

۹ مه ۲۰۲۳

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

ویژگی‌های اضافی فروشگاه ابری

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

۲۲ مه ۲۰۲۳

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

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

۱۱ آوریل ۲۰۲۳

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

تکمیل سفارشات محلی

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

۳ آوریل

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

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

۲۰ فوریه ۲۰۲۳

خدمات حساب‌ها

منبع حساب

بخش جدید Account.ConversionSettings در منبع Accounts اضافه شد.

سرویس ConversionSources

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

۱۶ فوریه ۲۰۲۳

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

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

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

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

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

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

۹ فوریه ۲۰۲۳

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

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

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

۱۲ ژانویه ۲۰۲۳

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

منبع محصول

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

۲۴ نوامبر ۲۰۲۲

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

یک فیلد جدید به نام `promotionStatus` در بخش Promotions.PromotionStatus اضافه شد. این یک فیلد فقط خواندنی است.

۱۵ نوامبر ۲۰۲۲

سرویس گزارش‌ها

گزارش‌های «بینش بازار» به سرویس گزارش‌ها اضافه شد.

اکنون می‌توانید از سرویس Reports موارد زیر را جستجو کنید:

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

۷ نوامبر ۲۰۲۲

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

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

۱۴ سپتامبر ۲۰۲۲

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

۹ آگوست ۲۰۲۲

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

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

برای سازگاری با نسخه‌های قبلی، مقدار targetCountry شما برای feedهای موجود به طور خودکار feedLabel قرار داده شده است.

targetCountry منسوخ شده.

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

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

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

۸ دسامبر ۲۰۲۱

خدمات حساب‌ها

منبع حساب

بخش جدیدی به نام Account.AutomaticImprovements در منبع Accounts اضافه شد.

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

۲۵ اکتبر ۲۰۲۱

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

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

۱۱ اکتبر ۲۰۲۱

API تنظیمات ارسال

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

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

۴ اکتبر ۲۰۲۱

خدمات حساب‌ها

منبع حساب

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

۱۳ سپتامبر ۲۰۲۱

سرویس BuyOnGooglePrograms

منبع وضعیت برنامه خرید در گوگل

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

متد UpdateBuyOnGoogleProgramStatus جدید

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

۶ سپتامبر ۲۰۲۱

خدمات حساب‌ها

منبع حساب

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

۳۰ آگوست ۲۰۲۱

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

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

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

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

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

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

منبع محصول

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

۹ آگوست ۲۰۲۱

سرویس RepricingRule

نوع قانون قیمت‌گذاری مجدد

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

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

۱۷ مه ۲۰۲۱

سرویس برچسب بازگشت سفارش

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

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

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

۳ مه ۲۰۲۱

سرویس برچسب بازگشت سفارش

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

۲۶ آوریل ۲۰۲۱

API تنظیمات ارسال

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

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

۱۲ آوریل ۲۰۲۱

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

منبع محصول

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

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

۲۸ ژانویه ۲۰۲۱

خدمات حساب‌ها

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

۵ اکتبر ۲۰۲۰

سرویس CSSES

منبع CSS

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

۲۴ آگوست ۲۰۲۰

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

منابع محصولات

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

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

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

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

۱۰ آگوست ۲۰۲۰

خدمات حساب‌ها

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

۱۹ ژوئن ۲۰۲۰

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

منبع محصول

فیلدهای جدید

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

۲ ژوئن ۲۰۲۰

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

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

۲۷ آوریل ۲۰۲۰

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

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

لینک‌دهی GMB

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

۱۴ آوریل ۲۰۲۰

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

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

۹ مارس ۲۰۲۰

API موجودی محلی

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

۲ مارس ۲۰۲۰

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

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

۳ دسامبر ۲۰۱۹

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

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

۱۱ سپتامبر ۲۰۱۹

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

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

۱۴ آگوست ۲۰۱۹

خدمات جدید

سرویس‌های جدید «خط‌مشی بازگشت کالا» و «آدرس بازگشت کالا» برای خرید از گوگل اضافه شد.

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

منبع سفارش

میدان جدید

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

۷ آگوست ۲۰۱۹

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

منبع سفارش

فیلدهای جدید

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

۱ ژوئیه ۲۰۱۹

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

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

۱۱ ژوئن ۲۰۱۹

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

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

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

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

۱۴ فوریه ۲۰۱۹

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

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

پارامتر dryRun از نسخه ۲.۱ حذف شده است. این موضوع در مورد تمام فراخوانی‌های API صدق می‌کند.

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

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

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

حذف متدهای HTTP BATCH

تمام متدهای HTTP BATCH از نسخه ۲.۱ حذف شده‌اند. به جای آن از customBatch استفاده کنید. سرویس‌های تحت تأثیر موارد زیر هستند:

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

خدمات حساب‌ها

به‌روزرسانی

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.

در نسخه ۲، فروشندگان باید صراحتاً برای حذف این فیلدها، یک بدنه خالی ( {} ) ارائه دهند. در نسخه ۲.۱، فیلدها در صورت ارائه بدنه خالی یا عدم ارائه، حذف می‌شوند.

منبع حساب

ادوردز -> تغییر برند تبلیغات گوگل

با تبدیل شدن ادوردز به گوگل ادز ، فیلدهای مرتبط با ادوردز زیر تغییر نام داده‌اند:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
حذف فیلدها و مقادیر منسوخ شده

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

سرویس وضعیت حساب‌ها

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

حذف مشکلات کیفیت داده‌ها

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

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

منبع داده

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

فیلدهای contentLanguage ، targetCountry و intendedDestinations در targets حذف شده و با country ، language ، includedDestinations و excludedDestinations جایگزین شده‌اند.

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

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

خدمات موجودی

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

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

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

لغو آیتم خط

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

دسته سفارشی

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

خط بازپرداخت کالا در فروشگاه

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

بازپرداخت

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

آیتم خط بازگشتی

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

خط بازگشت کالا

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

شیپ‌لاین‌ایتم

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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.

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

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

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

منبع محصول

گروه‌های سفارشی با ویژگی‌های سفارشی بازگشتی جایگزین شده‌اند

پیش از این، در نسخه ۲، ویژگی‌های سفارشی را می‌توانستیم با اضافه کردن ویژگی‌های سفارشی در زیر یک گروه سفارشی، گروه‌بندی کنیم. اکنون در نسخه ۲.۱، ویژگی‌های سفارشی بازگشتی هستند، بنابراین این امر نیاز به گروه‌های سفارشی را از بین می‌برد.

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

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

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

در نسخه ۲.۱، ویژگی‌های سفارشی دیگر شامل type و unit نخواهند بود. در عوض، واحدها باید به value (در صورت وجود) اضافه شوند و انواع باید به طور خودکار شناسایی شوند. برای مثال، در نسخه ۲.۱ از "۱.۲۳ یورو" یا "۵.۶ سانتی‌متر" به عنوان value استفاده کنید.

عبارت ProductTypes جایگزین productType و additionalProductTypes می‌شود.

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

ویژگی Destinations با includedDestinations و excludeDestinations جایگزین شده است

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

با تبدیل شدن ادوردز به گوگل ادز ، فیلدهای مرتبط با ادوردز زیر تغییر نام داده‌اند:

  • 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 باشد.

حذف مشکلات کیفیت داده‌ها

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