آخرین اطلاعیهها در مورد ویژگیهای جدید، رفع اشکالات و بهروزرسانیهای منتشر شده را دریافت کنید.
اوت ۲۰۲۶
اوت ۲۰۲۶
چه خبر؟:
- API محتوا برای خرید در ۱۸ آگوست ۲۰۲۶ به پایان عمر خود رسید. همه توسعهدهندگان باید در اسرع وقت ادغامهای موجود خود را به API فروشگاه منتقل کنند. برای اطلاعات بیشتر، به بخش منسوخ شدن و پایان عمر مراجعه کنید.
- ادغام حساب پروتکل تجارت جهانی (UCP) :
UcpCheckoutManagementبه عنوان یک نوع سرویس در منبع سرویس حساب، همراه با پشتیبانی از برنامهucp-integrationو شرایط خدماتucp_integrationبا دسترسی محدود اضافه شد. - لغو سیاستهای بازگشت کالا در سطح پیشنهاد : ویژگی
returnsدرProductAttributesاضافه شده است تا سیاستهای بازگشت کالا (مثلاً کشور، روزهای باز شدن پنجره، هزینههای بازگشت کالا، شرایط) را مستقیماً در سطح کالا پیکربندی و لغو کند. - ویژگیهای اجاره املاک و مستغلات : ویژگیهای اصلی فهرست، از جمله
leaseTermبهProductAttributes، برای ارسال دادههای تبلیغات اجاره اضافه شد. - پیشرفتهای زیر-API موجودیها :
- برای پیکربندی قوانین حمل و نقل مخصوص فروشگاه،
localShippingLabelبهLocalInventoryAttributesاضافه شد. - برای پشتیبانی از فرادادههای سفارشی در موجودیهای محلی،
customAttributesبهLocalInventoryAttributesاضافه شد.
- برای پیکربندی قوانین حمل و نقل مخصوص فروشگاه،
- اعلانهای سرویس حساب :
ACCOUNT_SERVICEبه عنوان یکNotificationEventTypeپشتیبانیشده در زیر-API اعلانها برای ردیابی تغییرات وضعیت در سرویسهای حساب اضافه شد. برای اطلاعات بیشتر در مورد اعلانهای مربوط به تغییرات سرویس حساب، به دریافت اعلانهای فوری برای تغییرات سرویس حساب مراجعه کنید. - تعداد بازدیدهای گزارش همکاری در فروش یوتیوب (
v1alpha) :-
youtube_product_sold_stats_viewبرای نمایش عملکرد فروش محصولات وابسته در یوتیوب. -
youtube_product_tagged_stats_viewبرای ردیابی نمایشها، کلیکها و سفارشهای محصولات برچسبگذاری شده در ویدیوها.
-
- نقطه پایانی تطبیق مشتری وفاداری : دادههای وفاداری مشتری را بارگذاری و مدیریت کنید تا مزایای سطحبندی (به عنوان مثال؛ قیمتگذاری اعضا) در نتایج جستجوی ارگانیک نمایش داده شود. برای اطلاعات بیشتر در مورد دادههای وفاداری مشتری، به نمای کلی سرویس تطبیق مشتری وفاداری مراجعه کنید.
- مخزن عمومی کتابخانههای کلاینت آلفا : کتابخانههای آلفا برای بررسیهای زیر-API در سراسر پایتون، جاوا، PHP، C#، روبی، Node.js و Go اکنون در مخزن عمومی GitHub در دسترس هستند.
چه چیزی تغییر کرده است:
- فیلتر سطح دسترسی
ListAccounts: پارامترaccessبا پشتیبانیDIRECT،INDIRECTوALLبرای فیلتر کردن حسابها بر اساس مجوزهای تماسگیرنده معرفی شد. این میتواند برای تمایز بین حسابهای پیشرفته و حسابهای فرعی استفاده شود. - اعتبارسنجی سهمیهها و قوانین
DataSources:- مدیریت سهمیه خودکار برای منابع داده در حسابهای پیشرفته معرفی شد. برای جزئیات بیشتر، به بخش «درک سهمیهها و محدودیتها» مراجعه کنید.
- اعتبارسنجی قانون اضافه شد که الزام میکند قوانین پیشفرض در منابع داده اصلی محصول دقیقاً شامل یک ارجاع به
selfیا یک منبع داده اصلی باشند. -
primaryDataSourceNameدرDataSourceReferenceبه نفعselfمنسوخ شد.
- بهبود تأخیر : کاهش سربار API برای فراخوانیهای درج، بهروزرسانی و حذف محصول.
چه اتفاقی در راه است:
- منسوخ شدن و خاموش شدن Content API برای Shopping : یادآوری برای انتقال به Merchant API جدید. برای تشویق مهاجرت قبل از حذف کامل و اطمینان از اینکه توسعهدهندگان اطلاعیههای منسوخ شدن را در گزارشهای برنامه خود مشاهده میکنند، گوگل از اول سپتامبر ۲۰۲۶ یک فرآیند تدریجی تخریب سرویس را معرفی میکند. برای اطلاعات بیشتر، به بخش جدول زمانی غروب API برای Shopping مراجعه کنید.
مه ۲۰۲۶
مه ۲۰۲۶
چه خبر؟:
- یک سرویس جدید MCP API فروشگاه (نسخه آلفا) با دسترسی مجاز به دادهها و بینشهای مرکز فروشگاه شما با تمرکز بر فقط خواندنی، اکنون به عنوان یک ابزار عامل جدید برای API فروشگاه در دسترس است.
ویژگیهای مکالمهای جدید اکنون در زیرشاخهی Products و در بخش
ProductAttributesدر دسترس هستند.این ویژگیها عبارتند از:
مجموعهای کامل از ویژگیها مخصوص تبلیغات خودرو در زیر-API محصولات اضافه شده است.
اعلانهای مربوط به تغییرات وضعیت محصول برای پرداخت پروتکل تجارت جهانی (UCP) اکنون در زیر-API اعلانها از طریق مقدار زمینه گزارش
FREE_LISTINGS_UCP_CHECKOUTدر دسترس هستند.مهارتهای عامل API فروشنده، ابزار عامل جدیدی در مجموعه ابزار Code Assist است. این مهارت جدید
mapi-developer-assistantکه بر اساس استاندارد Open Agent Skills ساخته شده است، کمک هوشمند و زمینهای ارائه میدهد. این مهارت، تخصص خاص دامنه، گردشهای کاری خودکار و کارایی افزایشیافته را در ابزارهای هوش مصنوعی مانند Antigravity CLI و IDEها برای تسریع ادغام شما به ارمغان میآورد.نسخه جدید sub-API یوتیوب نسخه ۱ آلفا برای مدیریت قراردادهای برنامه همکاری در فروش یوتیوب در دسترس است.
پشتیبانی برای مدیریت برنامههای همکاری در فروش یوتیوب و نقد و بررسی محصولات در زیر API حسابها اضافه شد.
یک منبع داده جدید برای تبلیغات محصول در سطح حساب پیشرفته در دسترس است.
چه چیزی تغییر کرده است:
- نسخه v1beta رابط برنامهنویسی کاربردی فروشگاه (Merchant API) متوقف شد. اکنون همه فراخوانیهای API باید به نسخههای
v1یاv1alphaهدایت شوند. برای مراحل مهاجرت، به Migrate from v1beta to v1 مراجعه کنید. - بهروزرسانیهای مکررتر در سطح ویژگیها برای
priceوavailabilityاکنون از طریق روشpatchدر زیر-API محصولات در دسترس هستند. این ویژگی با فراهم کردن امکان بهروزرسانی این ویژگیهای خاص با تأخیر کمتر، تازگی دادهها را افزایش میدهد. در حال حاضر، این قابلیت فقط برای فروشگاههای مجاز در فهرست موجود است. برای کسب اطلاعات بیشتر یا درخواست دسترسی، با نماینده گوگل خود تماس بگیرید.
چه اتفاقی در راه است:
- تجزیه و تحلیل عملکرد عاملمحور با UCP در API گزارشها.
ژانویه ۲۰۲۶
ژانویه ۲۰۲۶
چه خبر؟:
یک مقدار زمینه گزارشدهی جدید ،
FREE_LISTINGS_UCP_CHECKOUT، برای درک وضعیت واجد شرایط بودن محصول برای پرداخت UCP (پروتکل تجارت جهانی) در زیر-API گزارشها.گزارش عملکرد همکاران فروش یوتیوب در نسخه ۱ آلفا و در زیر-API گزارشها معرفی شد.
پشتیبانی از پیامهای
ErrorInfoاضافه شده است تا فرادادههای قابل خواندن توسط ماشین را برای فراخوانیهای API اشتباه ارائه دهد. این با یک راهنمای جدید در مورد مدیریت خطا و یک لیست کامل از پیامهای خطا همراه است.
چه چیزی تغییر کرده است:
-
InventoryLoyaltyProgramبه سرویس موجودی محلی اضافه شد تا کاربران بتوانند کنترل یکپارچهای بر ویژگیهای وفاداری، مانند تخفیفها، بازگشت وجه نقد برای خریدهای آینده و امتیازهای وفاداری داشته باشند.
چه اتفاقی در راه است:
- قطع پشتیبانی از رابط برنامهنویسی کاربردی فروشگاه نسخه ۱ بتا در ۲۸ فوریه ۲۰۲۶. قبل از پایان مهلت پشتیبانی از نسخه ۱ بتا، تمام فراخوانیهای رابط برنامهنویسی کاربردی به ترتیب به نسخههای ۱ و ۱ آلفا هدایت میشوند.
- امکان فعال و غیرفعال کردن برنامه نقد و بررسی محصولات از طریق Reviews API v1alpha ، که فرآیند ارسال و مدیریت نقد و بررسی محصولات را ساده میکند.
نوامبر ۲۰۲۵
نوامبر ۲۰۲۵
چه خبر؟:
- بینشهای جدید برای تجزیه و تحلیلهای وابسته به خرید یوتیوب (نسخه ۱alpha)، در زیر-API گزارشها برای بازیابی تجزیه و تحلیل در مورد سازندگان، محتوا و محصولات نمایش داده شده در یوتیوب. این گزارشها با گزارشهای موجود موجود در مرکز بازرگانان گوگل (GMC) برابری میکند.
- یک ابزار تشخیصی API ارتقا یافته برای پشتیبانی از مهاجرت به API فروشگاه (نسخه ۱).
- فیلد جدید
product_filtersبه زیر-API حسابها اضافه شد تا به فروشندگان اجازه دهد فقط زیرمجموعهای از فید خود را با حسابهای گوگل ادز به اشتراک بگذارند، که این کار بر اساس برخی فیلترهای شرطی روی ویژگیهای محصولات فروشنده انجام میشود. این ویژگی فقط برای تعداد محدودی از فروشندگان قابل دسترسی است. - پشتیبانی از ایجاد حسابهای کاربری مستقل برای فروشندگان در پلتفرمهای تجارت الکترونیک اضافه شد.
- دو متد جدید
accounts.limits.getوaccounts.limits.listبرای جستجوی محدودیتهای حساب در Quota API اضافه شد.
چه چیزی تغییر کرده است:
- پشتیبانی از تشخیص خودکار و رمزگشایی داخلی شناسههای محصول کدگذاریشده با base64url اکنون در تمام روشهایی که از شناسههای محصول استفاده میکنند، در دسترس است.
چه اتفاقی در راه است:
بینشهای جدید برای تجزیه و تحلیلهای وابسته به خرید یوتیوب (نسخه ۱alpha)، در زیر-API گزارشها برای بازیابی تجزیه و تحلیل در مورد سازندگان، محتوا و محصولات نمایش داده شده در یوتیوب. این گزارشها با گزارشهای موجود موجود در مرکز بازرگانان گوگل (GMC) برابری میکند.
قطع پشتیبانی از نسخه v1beta در رابط برنامهنویسی کاربردی فروشگاه در تاریخ ۲۸ فوریه ۲۰۲۶. تمام فراخوانیهای رابط برنامهنویسی کاربردی (API) باید به ترتیب به نسخههای v1 و v1alpha، قبل از مهلت پایان پشتیبانی v1beta، هدایت شوند. برای اطلاعات بیشتر، به سیاست نسخهبندی و پایان پشتیبانی رابط برنامهنویسی کاربردی فروشگاه مراجعه کنید.
سپتامبر ۲۰۲۵
سپتامبر ۲۰۲۵
چه خبر؟:
- اولین سرویس پروتکل زمینه مدل (MCP) برای رابط برنامهنویسی کاربردی فروشنده (Merchant API) در دسترس قرار گرفت.
- سرویس جدید MCP، مستندات معتبر Google API را در دستیار کدنویسی محیط توسعه یکپارچه (IDE) شما ادغام میکند تا ادغام API فروشگاه شما را تسریع کرده و دقت گردشهای کاری مهاجرت شما را بهبود بخشد.
- یک متد جدید،
getAccountForGcpRegistrationدر زیر-API حسابها برای بازیابی حساب تجاری که در Google Cloud ثبت شده است.
چه چیزی تغییر کرده است:
- روشهای جدید برای مدیریت مناطق در زیر-API حسابها.
- معرفی سه متد جدید
batchCreate،batchDeleteوbatchUpdateبرای فعال کردن دستهبندی فراخوانی برای عملیاتcreate،updateوdeleteبرای مناطق در زیر-API حسابها، به منظور تسهیل مدیریت منطقه و کاهش محدودیتهای فراخوانیهایone-region-per-request.
- معرفی سه متد جدید
- یک پیکربندی جدید ارسال مبتنی بر حامل در زیر-API محصولات موجود است تا ویژگیهای ارسال را در سطح محصول مشخص کند.
چه اتفاقی در راه است:
- گزارشهای جدید برای تجزیه و تحلیل برنامه همکاری در فروش یوتیوب، مانند v1alpha در زیر-API گزارشها برای بازیابی تجزیه و تحلیل در مورد سازندگان، محتوا و محصولات نمایش داده شده در یوتیوب که با گزارشهای موجود در مرکز بازرگانان گوگل برابری میکند.
- فعال کردن بهروزرسانیهای مکرر محصول برای ویژگیهای موجودی و قیمت.
- تحلیل آسانتر خطاهای API با اطلاعات خطا و فرادادههای غنیشده.
ژوئیه ۲۰۲۵
ژوئیه ۲۰۲۵
چه خبر؟:
رابط برنامهنویسی کاربردی فروشگاه (نسخه ۱) - جانشین رسمی رابط برنامهنویسی کاربردی محتوا برای خرید، اکنون بهطور عمومی در دسترس است.
این یعنی از این به بعد، فقط زیر-API های نسخه ۱alpha و v1 در Merchant API وجود خواهند داشت و اکثر نسخههای v1beta به نسخه ۱ ارتقا خواهند یافت. برای اطلاعات بیشتر با ما همراه باشید.
منابع جدید در دسترس هستند.
- منبع تصویر در رابط برنامهنویسی کاربردی (API) استودیو محصول (آلفا) از genAI برای تولید پسزمینههای جدید محصول، حذف پسزمینه تصویر و افزایش وضوح تصویر استفاده میکند.
- زیر-API پرداخت در بخش فروشگاه در حسابها، امکان ایجاد، بهروزرسانی، حذف و دریافت تنظیمات پرداخت شما را فراهم میکند.
- سیاست بازگشت آنلاین در زیر API حسابها منتقل شده است، و عملکرد کاربر بدون تغییر باقی مانده است. پیشرفتهای فنی کوچک، مانند فیلدهای قدیمی و تغییر نام فیلدهای موجود، برای هماهنگی حذف شدهاند.
-
AccountIdAliasدر منبع AccountRelationship در زیر-API حسابها، به جای شناسه داخلی (شناسه حساب) شما، از یک نام مستعار تعریفشده توسط کاربر استفاده میکند. این امر مدیریت ساختارهای پیچیده حساب، مانند استفاده از نام مستعار تعریفشده توسط کاربر برای بازار شما به جای شناسه داخلی شما را آسانتر میکند.
دسترسی به Merchant API اکنون برای کاربران Apps Script در دسترس است.
اکنون یک متد جدید
AggregateProductStatusesدر API حل مسئله برای پرسوجوی آمار تجمیعشده در مورد وضعیت محصولات در دسترس است.
چه چیزی تغییر کرده است:
- امکان ایجاد حسابهای مستقل برای فروشگاهسازها و CSSها. پیش از این، حسابهای تجاری تحت یک حساب پیشرفته واحد ایجاد میشدند.
رتبهبندی پتانسیل کلیک در جدول
productViewدر زیر API گزارشها . اکنون، رتبهبندی محصولات بر اساسclickPotentialبه مقادیر بین ۱ تا ۱۰۰۰ نرمالسازی میشود. محصولاتی باclickPotentialRankپایین هنوز بالاترینclick potentialدر بین محصولات فروشندهای که شرایط عبارت جستجو را برآورده میکنند، دارند.
چه اتفاقی در راه است:
- دسترسی از طریق سرور پروتکل زمینه مدل (MCP) (نسخه ۱alpha).
مه ۲۰۲۵
مه ۲۰۲۵
چه خبر؟:
- ما دو زیر-API جدید راهاندازی کردیم.
- ردیابی سفارش از سابقه ردیابی سفارش تجاری پشتیبانی میکند تا تخمینهای دقیق و صحیحی از هزینه ارسال را به مشتریان ارائه دهد. سیگنالهای آن همچنین امکان ارسال رایگان و سریع را برای لیستهای بهبود یافته فراهم میکند.
- حل مسئله، دسترسی به محتوای تشخیصی و اقدامات پشتیبانی را به همان روشی که در رابط کاربری مرکز فروشندگان موجود است، فراهم میکند.
- منابع جدید در زیر-API حسابها (Accounts sub-API) موجود است.
-
OmnichannelSettingsپیکربندی حساب را برای ارائه خدمات همه کانالی، مانند فهرستهای محلی رایگان (FLL) و تبلیغات موجودی محلی (LIA)، مدیریت میکند. -
LfpProvidersبرای دادههای موجودی به شرکای Local Feeds Partnership (LFP) متصل میشود. -
GbpAccountsبرای دادههای فروشگاه محلی به حساب نمایه کسبوکار گوگل متصل میشود. -
OnlineReturnPolicyامکان ایجاد، حذف و بهروزرسانی سیاستهای آنلاین شما را فراهم میکند.
-
- یک روش جدید در زیر-API محصولات موجود است.
-
ProductsUpdateبه شما امکان میدهد محصولات را بهصورت جداگانه و بدون نیاز به ارائه تمام فیلدهای مورد نیاز برایProductInputبهروزرسانی کنید.
-
چه چیزی تغییر کرده است:
- حداکثر
pageSizeاز ۲۵۰ به ۱۰۰۰ ردیف در هر فراخوانی API افزایش یافت. - تأخیری که برای درج محصول، تبلیغات، بررسی محصول و بررسی فروشنده پس از ایجاد
DataSourcesوجود داشت، برطرف شده است.
چه اتفاقی در راه است:
- منسوخ شدن و حذف فیلد کانال برای
DataSourcesو محصولات در آینده. - راهاندازی یک تعریف بهروزرسانیشده برای
clickPotentialRankدر جدولproductViewدر زیر-API گزارشها :- رتبهبندی محصولات بر اساس
clickPotentialبه مقادیر بین ۱ تا ۱۰۰۰ نرمالسازی میشود. - محصولاتی که
clickPotentialRankپایینی دارند، همچنان بالاترین پتانسیل کلیک را در بین محصولات فروشندهای که شرایط جستجوی مورد نظر را برآورده میکنند، دارند. این یک تغییر دائمی است که ممکن است در ۱ جولای ۲۰۲۵ راهاندازی شود.
- رتبهبندی محصولات بر اساس
-
AccountIdAliasدر منبعAccountRelationship، مدیریت بهتر ساختارهای پیچیده حساب را ممکن میسازد. برای مثال، فروشگاههای آنلاین به جای شناسه داخلی فروشنده، مانند شناسه حساب، از یک نام مستعار تعریفشده توسط کاربر استفاده میکنند.
آوریل ۲۰۲۵
چه خبر؟:
- ما یک زیر-API جدید راهاندازی کردیم.
- استودیو محصول (ALPHA) از genAI برای تولید و بهینهسازی عناوین و توضیحات محصول استفاده میکند.
- منابع جدید در زیر-API حسابها موجود است.
-
AutomaticImprovementsامکان ثبتنام در سه ویژگی بهروزرسانی خودکار ارائه شده توسط پلتفرم Google Merchant Center را مدیریت میکند: - منابع
AccountServiceوAccountRelationshipروابط را مدیریت کرده و خدماتی را برای ارائه دهندگان خدمات برقرار میکنند.
-
- ما سه فیلد برای
AutomatedDiscountsدر زیر-API محصولات راهاندازی کردیم تا قیمتهای لحظهای محصولات انتخابشده در Google Automated Discounts (GAD) را بازیابی کنیم.
چه چیزی تغییر کرده است:
- اکنون ما از مقاصد، که به عنوان روشهای بازاریابی در مرکز فروشندگان برای زیر-API منابع داده شناخته میشوند، پشتیبانی میکنیم.
- ما چندین تنظیم در منبع انجام دادیم و توصیه میکنیم برای جزئیات بیشتر ، یادداشتهای انتشار حسابها را بررسی کنید.
- فیلدهای
taxesوtax_categoryدر زیر-API محصولات، مطابق با منسوخ شدنaccounttaxدر Content API، منسوخ شدهاند.
چه اتفاقی در راه است:
- ما بازخورد شما را در نظر گرفتهایم و در حال کار بر روی چندین زمینه برای بهبود مستندات توسعهدهندگان API هستیم.
- با ما همراه باشید و مرتباً به ما سر بزنید و در صورت تمایل بازخورد بیشتری به ما بدهید .