جدیدترین به‌روزرسانی‌ها

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

اکتبر ۲۰۲۶

اکتبر ۲۰۲۶

تازه‌ها:

  • خط‌مشی‌های توسعه‌دهنده و گزارش‌دهی فروش‌یاران «مرکز خرید YouTube» (نسخه v1alpha):

  • شناسه منبع یکسان صفحه اصلی فروشگاه در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها»: فیلد فقط خواندنی homePageUri به منبع حساب‌ها اضافه شد تا شناسه منبع یکسان صفحه اصلی فروشگاه را برگرداند.

  • افزودن مشخصه زیرمیانای برنامه‌سازی کاربردی محصولات:

    • پیوندهای گواهینامه محصول و شمارش‌های بازده انرژی پادشاهی متحد (UK): فیلدهای certificationDocumentLink و certificationLabelLink، همراه با مرجع صدور گواهینامه «وزارت امنیت انرژی و صفر خالص» (DESNZ) و شمارش‌های نام گواهینامه GB_ENERGY_INFORMATION به ProductCertification در ProductAttributes اضافه شد. برای اطلاعات بیشتر، به گواهینامه مراجعه کنید.
    • مسافت مجاز برای اقساط خودرو: mileageAllowance به ProductInstallment در ProductAttributes اضافه شد تا مسافت مجاز برای قراردادهای کرایه خودرو مشخص شود.
    • پیوندهای ویدیو در سطح پیشنهاد: مشخصه videoLinks به ProductAttributes اضافه شد تا ویدیوهای سطح پیشنهاد در مقیاس بزرگ ارسال شود.

  • مستندات جدید ارائه‌دهنده خدمات شخص ثالث (3P):

  • نمونه‌های کد Java جدید برای مدیریت گروه‌بندی منطقه‌ای:

  • گزارش عملکرد عامل UCP (نسخه 1alpha): دو نمای گزارش‌دهی جدید به accounts.reports.search در زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها» (نسخه 1alpha) اضافه شده است تا سنجه‌های عملکرد تسویه‌حساب و تبدیل UCP را در سطوح Google، ازجمله «حالت هوش مصنوعی» در «جستجو» و Gemini، بازیابی کند:

    • UcpAgenticPerformanceView: سنجه‌های انتقال سبد خرید، لغو، سفارش، و قیف تبدیل سطح حساب را که براساس تاریخ و کشور مشتری بخش‌بندی شده است گزارش می‌کند.
    • UcpAgenticProductPerformanceView: سنجه‌های کلیک دکمه خرید offerId در سطح محصول را که براساس تاریخ و کشور مشتری بخش‌بندی شده است گزارش می‌کند.
    • راهنمای تجزیه‌وتحلیل عملکرد عامل‌گرای UCP (آلفا) با نمونه پُرسمان‌های Merchant Center Query Language (MCQL) منتشر شد.

چه چیزی تغییر کرده است:

  • پشتیبانی از مشخصه ضمانت‌نامه گسترش‌یافته: مشخصه warranty در ProductAttributes فراتر از فهرستگان خودرو تعمیم داده شد تا از همه محصولات پشتیبانی کند، و اجازه داده شد مدت ضمانت‌نامه برحسب ماه یا سال مشخص شود.
  • غیرعادی‌سازی مشکل حساب در سطح پیشنهاد: مشکلات خاص تعلیق حساب را مستقیماً روی پیشنهادهای تحت‌تأثیر قرارگرفته نشان می‌دهد، نه به‌عنوان یک ACCOUNT_DISAPPROVAL عمومی، و تشخیص‌های واضح‌تری از تأثیر در سطح پیشنهاد، روش بازاریابی، و کشور ارائه می‌دهد.
  • منسوخ شدن YoutubeProductPerformanceView (v1alpha): منسوخ‌شده YoutubeProductPerformanceView در زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها» (v1alpha) به‌نفع YoutubeProductSoldStatsView و YoutubeProductTaggedStatsView.
  • پیش‌فرض‌های صفحه‌بندی زیرمیانای برنامه‌سازی کاربردی «اعلان‌ها» و راهنماهای جدید: صفحه‌بندی استانداردشدهaccounts.notificationsubscriptions.list با pageSize اختیاری که به‌طور پیش‌فرض روی ۱۰۰ (حداکثر ۲۰۰) تنظیم شده است، و راهنمای جدیدی برای راه‌اندازی اعلان‌های لحظه‌ای برای تغییرات سرویس حساب منتشر شده است.
  • سازمان‌دهی مجدد راهنمای محدودیت‌ها و سهمیه‌ها و اسناد مرجع: همه صفحه‌های مرجع RPC و REST نسخه v1beta را که متوقف شده‌اند از سایت توسعه‌دهنده برداشتیم و محدودیت‌ها و سهمیه‌ها را در راهنماهای اختصاصی برای سهمیه‌های API و محدودیت‌های حساب سازمان‌دهی مجدد کردیم.

اوت ۲۰۲۶

اوت ۲۰۲۶

تازه‌ها:

  • «میانای برنامه‌سازی کاربردی محتوا برای خرید» در ۱۸ اوت ۲۰۲۶ به پایان عمر خود رسید. همه توسعه‌دهندگان باید در اسرع وقت یکپارچه‌سازی‌های موجود خود را به Merchant API منتقل کنند. برای اطلاعات بیشتر، به منسوخ شدن و پایان پشتیبانی مراجعه کنید.
  • ادغام حساب «پروتکل تجارت جهانی» (UCP): UcpCheckoutManagement به‌عنوان نوع سرویس در منبع «سرویس حساب» اضافه شد، به‌همراه پشتیبانی از برنامه ucp-integration و شرایط خدمات ucp_integration با دسترسی محدود.
  • لغو خط‌مشی مرجوع کردن در سطح پیشنهاد: مشخصه returns در ProductAttributes اضافه شد تا خط‌مشی‌های مرجوع کردن (برای مثال، کشور، روزهای بازه زمانی، کارمزدهای مرجوع کردن، وضعیت) مستقیماً در سطح کالا پیکربندی و لغو شود.
  • مشخصه‌های اجاره املاک و مستغلات: مشخصه‌های فهرستگان اصلی، ازجمله leaseTerm به ProductAttributes اضافه شد تا داده‌های آگهی اجاره ارسال شود.
  • بهبودهای زیرمیانای برنامه‌سازی کاربردی موجودی‌ها:
    • localShippingLabel به LocalInventoryAttributes اضافه شد تا قوانین ارسال مختص فروشگاه پیکربندی شود.
    • customAttributes به LocalInventoryAttributes اضافه شد تا از فراداده سفارشی در موجودی‌های محلی پشتیبانی شود.
  • اعلان‌های سرویس حساب: ACCOUNT_SERVICE به‌عنوان NotificationEventType پشتیبانی‌شده در زیرمیانای برنامه‌سازی کاربردی «اعلان‌ها» برای پیگیری تغییرات وضعیت در سرویس‌های حساب اضافه شد. برای اطلاعات بیشتر درباره اعلان‌های مربوط به تغییرات سرویس حساب، به دریافت اعلان لحظه‌ای برای تغییرات سرویس حساب مراجعه کنید.
  • بازدیدهای گزارش‌دهی همکاری «مرکز خرید YouTube» (v1alpha):
    • youtube_product_sold_stats_view برای پرس‌وجو درباره عملکرد فروش محصولات فروش‌یاری در YouTube.
    • youtube_product_tagged_stats_view برای پیگیری ظهورها، کلیک‌ها، و سفارش‌های محصولات برچسب‌گذاری‌شده در ویدیوها.
  • نقطه پایانی «مطابقت مشتری وفادار»: بارگذاری و مدیریت داده‌های وفاداری مشتری برای نمایش مزایای سطح (برای مثال، قیمت‌گذاری برای اعضا) در نتایج جستجوی عادی. برای اطلاعات بیشتر درباره داده‌های وفاداری مشتری، نمای کلی سرویس «مطابقت مشتری وفادار» را ببینید.
  • مخزن عمومی کتابخانه‌های مشتری آلفا: کتابخانه‌های آلفا برای زیرمیانای برنامه‌سازی کاربردی «مرورها» در Python،‏ Java،‏ PHP،‏ C#‎،‏ Ruby،‏ Node.js، و Go اکنون در مخزن عمومی GitHub دردسترس است.

چه چیزی تغییر کرده است:

  • فیلتر سطح دسترسی ListAccounts: پارامتر access معرفی شد که از DIRECT، INDIRECT، و ALL برای فیلتر کردن حساب‌ها براساس اجازه‌های تماس‌گیرنده پشتیبانی می‌کند. از این مقدار می‌توان برای تشخیص حساب‌های پیشرفته از حساب‌های فرعی استفاده کرد.
  • DataSources اعتبارسنجی‌های سهمیه و قانون:
    • مدیریت سهمیه خودکار برای منابع داده در حساب‌های پیشرفته معرفی شد. برای جزئیات بیشتر، آشنایی با سهمیه‌ها و محدودیت‌ها را ببینید.
    • اعتبارسنجی قانون اضافه شد که مستلزم آن است که قوانین پیش‌فرض در منابع داده محصول اصلی دقیقاً یک ارجاع به self یا یک منبع داده اصلی داشته باشند.
    • primaryDataSourceName در DataSourceReference به‌نفع self منسوخ شده است.
  • بهبودهای تأخیر: کاهش سربار میانای برنامه‌سازی کاربردی برای فراخوانی‌های درج، به‌روزرسانی، و حذف محصول.

آنچه در راه است:

  • منسوخ شدن و توقف Content API for Shopping: یادآوری برای انتقال به Merchant API جدید. برای تشویق به انتقال قبل‌از ازکاراندازی کامل و اطمینان از اینکه توسعه‌دهندگان اعلان‌های منسوخ شدن را در گزارش‌های برنامه خود مشاهده می‌کنند، Google فرایند تنزل تدریجی سرویس را از ۱ سپتامبر ۲۰۲۶ آغاز می‌کند. برای اطلاعات بیشتر، بخش جدول زمانی توقف «میانای برنامه‌سازی کاربردی محتوا برای خرید» را ببینید.

مه ۲۰۲۶

مه ۲۰۲۶

تازه‌ها:

چه چیزی تغییر کرده است:

  • نسخه v1beta از «میانای برنامه‌سازی کاربردی بازرگان» متوقف شد. اکنون همه فراخوان‌های میانای برنامه‌سازی کاربردی باید به نسخه‌های v1 یا v1alpha هدایت شوند. برای اطلاع از مراحل انتقال، به انتقال از v1beta به v1 مراجعه کنید.
  • به‌روزرسانی‌های مکررتر در سطح مشخصه برای price و availability اکنون ازطریق روش patch در زیرمیانای برنامه‌سازی کاربردی «محصولات» دردسترس است. این ویژگی با امکان به‌روزرسانی این مشخصه‌های خاص با تأخیر کمتر، تازگی داده‌ها را افزایش می‌دهد. درحال‌حاضر، این ویژگی فقط برای فروشندگان موجود در فهرست مجاز دردسترس است. برای کسب اطلاعات بیشتر یا درخواست دسترسی، با نماینده Google تماس بگیرید.

آنچه در راه است:

  • Analytics برای عملکرد عامل با UCP در Reports API.

ژانویه ۲۰۲۶

ژانویه ۲۰۲۶

تازه‌ها:

چه چیزی تغییر کرده است:

  • InventoryLoyaltyProgram به سرویس موجودی محلی اضافه شد تا کاربران بتوانند کنترل یکپارچه‌ای بر ویژگی‌های وفاداری، مانند تخفیف‌ها، بازگشت نقدی برای خریدهای آینده، و امتیازهای وفاداری داشته باشند.

آنچه در راه است:

  • توقف دائم Merchant API v1beta در ۲۸ فوریه ۲۰۲۶. همه فراخوانی‌های میانای برنامه‌سازی کاربردی را به‌ترتیب به نسخه‌های v1 و v1alpha هدایت کنید، قبل‌از اینکه مهلت پایان v1beta فرا برسد.
  • امکان فعال و غیرفعال کردن برنامه «مرورهای محصول» ازطریق Reviews API v1alpha، که فرایند ارسال و مدیریت مرورهای محصول را ساده می‌کند.

نوامبر ۲۰۲۵

نوامبر ۲۰۲۵

تازه‌ها:

  • اطلاعات آماری جدید برای تجزیه‌وتحلیل‌های وابسته «مرکز خرید YouTube» (v1alpha)، در زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها» برای بازیابی تجزیه‌وتحلیل‌های مربوط به محتواسازان، محتوا، و محصولات ویژه در YouTube. این گزارش‌ها با گزارش‌های موجود در Google Merchant Center‏ (GMC) برابری می‌کنند.
  • ابزار عیب‌یابی میانای برنامه‌سازی کاربردی ارتقایافته برای پشتیبانی از انتقال به Merchant API(نسخه ۱).
  • فیلد جدید product_filters به زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» اضافه شد تا فروشندگان بتوانند فقط زیرمجموعه‌ای از فید خود را براساس برخی فیلترهای شرطی در مشخصه‌های محصولات فروشنده با حساب‌های Google Ads هم‌رسانی کنند. این ویژگی فقط برای تعداد محدودی از فروشندگان دردسترس است.
  • پشتیبانی از ایجاد حساب‌های مستقل برای فروشندگان در پلاتفرم‌های تجارت الکترونیک اضافه شد.
  • دو روش جدید، accounts.limits.get و accounts.limits.list برای پرسمان حدود حساب در Quota API اضافه شد.

چه چیزی تغییر کرده است:

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

آنچه در راه است:

  • اطلاعات آماری جدید برای تجزیه‌وتحلیل‌های وابسته «مرکز خرید YouTube» (v1alpha)، در زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها» برای بازیابی تجزیه‌وتحلیل‌های مربوط به محتواسازان، محتوا، و محصولات ویژه در YouTube. این گزارش‌ها با گزارش‌های موجود در Google Merchant Center‏ (GMC) برابری می‌کنند.

  • توقف دائم نسخه v1beta در Merchant API در ۲۸ فوریه ۲۰۲۶. همه فراخوانی‌های میانای برنامه‌سازی کاربردی باید به‌ترتیب به نسخه‌های v1 و v1alpha هدایت شوند، قبل‌از مهلت پایان v1beta. برای اطلاعات بیشتر، خط‌مشی نسخه‌بندی و توقف Merchant API را ببینید.

سپتامبر ۲۰۲۵

سپتامبر ۲۰۲۵

تازه‌ها:

  • اولین سرویس «پروتکل بافتار مدل» (MCP) برای Merchant API دردسترس است.
    • سرویس MCP جدید اسناد معتبر Google API را در دستیار کدنویسی «محیط توسعه نرم‌افزار یکپارچه» (IDE) شما ادغام می‌کند تا ادغام Merchant API شما را تسریع کند و دقت گردش‌های کاری انتقال شما را بهبود بخشد.
  • روش جدیدی، getAccountForGcpRegistration در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» برای بازیابی حساب فروشنده‌ای که در Google Cloud ثبت شده است.

چه چیزی تغییر کرده است:

  • روش‌های جدید برای مدیریت «مناطق» در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها».
    • معرفی سه روش جدید، batchCreate، batchDelete، و batchUpdate برای فعال کردن دسته‌بندی تماس برای عملیات create، update، و delete برای «مناطق» در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» برای تسهیل مدیریت منطقه و کاهش محدودیت‌های تماس‌های one-region-per-request.
  • پیکربندی ارسال کالا براساس شرکت مخابراتی جدیدی در زیرمیانای برنامه‌سازی کاربردی «محصولات» دردسترس است تا مشخصه‌های ارسال کالا را در سطح محصول مشخص کند.

آنچه در راه است:

  • گزارش‌های جدید برای تجزیه‌وتحلیل برنامه فروش‌یاران «مرکز خرید YouTube»، مانند v1alpha در زیرمجموعه API گزارش‌ها برای بازیابی تجزیه‌وتحلیل درباره محتواسازان، محتوا، و محصولات نمایش‌داده‌شده در YouTube که با گزارش‌های دردسترس در Google Merchant Center برابری می‌کند.
  • فعال کردن به‌روزرسانی‌های مکررتر محصول برای مشخصه‌های دردسترس بودن و قیمت.
  • تجزیه‌وتحلیل آسان‌تر خطاهای میانای برنامه‌سازی کاربردی با ErrorInfo و فراداده غنی‌شده.

ژوئیه ۲۰۲۵

ژوئیه ۲۰۲۵

تازه‌ها:

  • Merchant API (v1) - جانشین رسمی Content API for Shopping اکنون به‌طور عمومی دردسترس است.

    این یعنی ازاین‌پس، فقط زیرمیاناهای برنامه‌سازی کاربردی v1alpha و v1 در Merchant API وجود خواهند داشت و اکثر نسخه‌های v1beta به v1 ارتقا می‌یابند. برای اطلاعات بیشتر با ما همراه باشید.

  • منابع جدید دردسترس است.

    • منبع تصویر در Product Studio API (آلفا) از هوش مصنوعی زایا برای تولید پس‌زمینه‌های جدید محصول، برداشتن پس‌زمینه تصویر، و ارتقای وضوح تصویر استفاده می‌کند.
    • تسویه‌حساب در فروشنده در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» امکان ایجاد، به‌روزرسانی، حذف، و دریافت تنظیمات تسویه‌حساب را فراهم می‌کند.
    • خط‌مشی برگرداندن آنلاین در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» منتقل شده است، اما عملکرد کاربر بدون تغییر باقی مانده است. بهبودهای فنی کوچک، مثل فیلدهای قدیمی و تغییر نام فیلدهای موجود، برای حفظ سازگاری برداشته شده‌اند.
    • AccountIdAlias در منبع AccountRelationship در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» به‌جای شناسه داخلی شما (شناسه حساب) از نام مستعار تعریف‌شده توسط کاربر استفاده می‌کند. این کار مدیریت ساختارهای پیچیده حساب را آسان‌تر می‌کند، مثلاً استفاده از نام مستعار تعریف‌شده توسط کاربر برای بازار شما به‌جای شناسه داخلی شما.

  • اکنون دسترسی به Merchant API برای کاربران Apps Script دردسترس است.

  • روش جدید AggregateProductStatuses اکنون در Issue resolution API برای پُرسمان آمار ادغام‌شده درباره وضعیت‌های محصول دردسترس است.

چه چیزی تغییر کرده است:

  • امکان ایجاد حساب‌های مستقل برای سازندگان فروشگاه و CSSها. قبلاً حساب‌های فروشنده تحت یک حساب پیشرفته ایجاد می‌شدند.

  • رتبه‌بندی‌های پتانسیل کلیک در جدول productView زیر زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها». اکنون، رتبه‌بندی محصولات براساس clickPotential به مقادیر بین ۱ و ۱۰۰۰ نرمال‌سازی شده است. محصولات با clickPotentialRank پایین همچنان بالاترین click potential را در میان محصولات فروشنده دارند که شرایط پرسمان جستجو را برآورده می‌کنند.

آنچه در راه است:

  • دسترسی ازطریق سرور «پروتکل بافتار مدل» (MCP) (نسخه v1alpha).

مه ۲۰۲۵

مه ۲۰۲۵

تازه‌ها:

  • دو میانای برنامه‌سازی کاربردی فرعی جدید راه‌اندازی کردیم.
    • پیگیری سفارش از سابقه پیگیری سفارش کسب‌وکار پشتیبانی می‌کند تا برآوردهای دقیق و درستی از ارسال به مشتریان ارائه دهد. نشان‌های آن همچنین فهرستگان به‌سازی‌شده را با ارسال رایگان و سریع فعال می‌کند.
    • حل‌وفصل مشکل دسترسی به محتوای عیب‌یابی و کنش‌های پشتیبانی را به همان روشی که در رابط کاربری Merchant Center دردسترس است فراهم می‌کند.
  • منابع جدیدی در زیرمیانای برنامه‌سازی کاربردی «حساب‌ها» دردسترس است.
    • OmnichannelSettings پیکربندی حساب را برای ارائه همه‌کاناله، مانند «فهرستگان‌های محلی رایگان» (FLL) و «آگهی‌های فهرست موجودی محلی» (LIA)، مدیریت می‌کند.
    • LfpProviders برای داده‌های موجودی به شرکای «مشارکت فیدهای محلی» (LFP) متصل می‌شود.
    • GbpAccounts برای داده‌های فروشگاه محلی به حساب «نمایه کسب‌وکار Google» متصل می‌شود.
    • OnlineReturnPolicy امکان ایجاد، حذف، و به‌روزرسانی خط‌مشی‌های آنلاین شما را فراهم می‌کند.
  • روش جدیدی در زیرمیانای برنامه‌سازی کاربردی «محصولات» دردسترس است.
    • ProductsUpdate به شما امکان می‌دهد محصولات تکی را بدون نیاز به ارائه همه فیلدهای الزامی برای ProductInput به‌روز کنید.

چه چیزی تغییر کرده است:

  • حداکثر pageSize از ۲۵۰ به ۱۰۰۰ ردیف در هر فراخوانی میانای برنامه‌سازی کاربردی افزایش یافت.
  • تأخیری که برای درج محصول، تبلیغات، مرورهای محصول، و مرورهای فروشنده پس‌از ایجاد DataSources وجود داشت برطرف شده است.

آنچه در راه است:

  • منسوخ شدن و حذف فیلد کانال برای DataSources و محصولات در آینده.
  • راه‌اندازی تعریف به‌روزشده برای clickPotentialRank در productView جدول زیر زیرمیانای برنامه‌سازی کاربردی «گزارش‌ها»:
    • رتبه‌بندی محصولات براساس clickPotential به مقادیر بین ۱ و ۱۰۰۰ نرمال‌سازی می‌شود.
    • محصولات با clickPotentialRank پایین همچنان بالاترین پتانسیل کلیک را در میان محصولات فروشنده که شرایط پرسمان جستجو را برآورده می‌کنند دارند. این یک تغییر غیرمخرب است که ممکن است در ۱ ژوئیه ۲۰۲۵ راه‌اندازی شود.
  • AccountIdAlias در منبع AccountRelationship مدیریت بهتر ساختارهای پیچیده حساب را ممکن می‌سازد. برای مثال، بازارها به‌جای شناسه داخلی فروشنده، مانند شناسه حساب، از نام مستعار تعریف‌شده توسط کاربر استفاده می‌کنند.

آوریل ۲۰۲۵

آوریل ۲۰۲۵

تازه‌ها:

چه چیزی تغییر کرده است:

آنچه در راه است:

  • بازخورد شما را مدنظر قرار داده‌ایم و درحال کار روی چندین بخش برای بهبود مستندات توسعه‌دهنده میانای برنامه‌سازی کاربردی هستیم.
  • منتظر باشید و بیشتر به ما سر بزنید و هر زمان خواستید بازخورد بیشتری به ما ارائه دهید.
قبلی
YouTube Shopping developer policies
بعدی
Design