مشکلات شناخته شده

این صفحه نگرانی‌های شناخته‌شده‌ی توسعه‌دهندگان در مورد رابط برنامه‌نویسی کاربردی فروشگاه (Merchant API) را مستند می‌کند.

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

گزارش شده: 2026-01-28 UTC | آخرین به‌روزرسانی: 2026-03-31 UTC

ما گزارش‌هایی مبنی بر مشکلات عملکرد سمت کلاینت در توان عملیاتی هنگام ارسال حجم زیادی از داده‌ها به رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) دریافت کردیم. ممکن است هنگام استفاده از کتابخانه‌های کلاینت برای روش‌های زیر با این مشکل مواجه شوید:

• accounts.productInputs.insert
• accounts.products.localInventories.insert
• accounts.products.regionalInventories.insert

ما بهبودهایی را برای افزایش عملکرد سیستم‌های مختلف backend انجام داده‌ایم. اگر هنوز با این مشکل مواجه هستید، ممکن است لازم باشد یک channel pool را برای به حداکثر رساندن توان عملیاتی پیکربندی کنید. این کار با مدیریت چندین اتصال اساسی، محدودیت معمول ۱۰۰ جریان یک کانال gRPC را دور می‌زند. برای اطلاعات بیشتر، به Refactor code برای درخواست‌های همزمان مراجعه کنید: Improve throughput with channel pools .

شناسه‌های محصول با کاراکترهای ویژه

گزارش شده: 2025-10-03 UTC | آخرین به‌روزرسانی: 2026-04-08 UTC

کاربران ممکن است هنگام مدیریت محصولاتی که productId یا offerId (propertyId) آنها از دستورالعمل‌های قالب‌بندی شناسه محصول پیروی نمی‌کند، با مشکلاتی مواجه شوند. چنین شناسه‌های محصولی ممکن است حاوی کاراکترهای خاص باشند - به‌ویژه اسلش ( / )، دو نقطه ( : ، مدک ( ~ ) و علامت درصد ( % ). سطوحی مانند مرکز فروشندگان (Merchant Center) از قبل برخی از کاراکترهای خاص را در شناسه‌های محصول مجاز می‌دانند.

از آنجا که Merchant API شناسه محصول را مستقیماً در name منبع به عنوان بخشی از URL (برای مثال accounts/{account}/products/{productId} ) قرار می‌دهد، این کاراکترها می‌توانند در مسیریابی و تجزیه استاندارد URL اختلال ایجاد کنند و منجر به خطاهای غیرمنتظره 404 Not Found یا 400 Bad Request در حین عملیات GET، PATCH یا DELETE شوند.

برای تعامل ایمن با محصولاتی که حاوی این کاراکترها هستند، باید بخش productId یا offerId از نام منبع را کدگذاری کنید. الگوریتم کدگذاری، کدگذاری Base64URL بدون padding است. برای اطلاعات بیشتر، به accounts.productInputs.name مراجعه کنید.

حل شد: ما راهکاری برای استانداردسازی رفتار در سراسر اکوسیستم رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) ارائه دادیم. ما یک فیلد جدید base64_encoded_name به پاسخ‌های API اضافه کرده‌ایم که نام منبع از پیش کدگذاری شده را ارائه می‌دهد و به شما امکان می‌دهد از خروجی یک لیست استفاده کنید یا مستقیماً فراخوانی را به عنوان ورودی برای به‌روزرسانی‌های بعدی بدون انجام کدگذاری دستی دریافت کنید.

تأخیر پس از ایجاد منبع داده

گزارش شده: 2024-04-10 UTC | آخرین به‌روزرسانی: 2024-05-12 UTC

هنگام تلاش برای درج محصولات، تبلیغات یا نظرات بلافاصله پس از ایجاد یک DataSource جدید، تأخیر شناخته‌شده‌ای رخ داد. خطای « Data source not found هنگام تلاش برای درج موارد ظرف ۵ دقیقه پس از ایجاد منبع داده، بازگردانده شد.

حل شد: این تأخیر حذف شده است و امکان تعامل فوری‌تر با منابع داده تازه ایجاد شده را فراهم می‌کند.

مسئله دیگه ای؟

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