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

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

خطاهای تصادفی UnauthenticatedException

گزارش شده: 2026-03-30 UTC

چندین مشتری هنگام آپلود محصولات و دسترسی به سایر APIهای مرکز فروشندگان، به طور متناوب با خطای UnauthenticatedException مواجه می‌شوند. این خطاها حتی با تلاش‌های مجدد، به صورت تصادفی رخ می‌دهند و هم بر تماس‌های اولیه و هم تلاش‌های بعدی تأثیر می‌گذارند. برخی از اتصالات در مدت زمان کوتاهی با شکست مواجه می‌شوند در حالی که برخی دیگر در مدت زمان کوتاهی با موفقیت انجام می‌شوند.

تاکنون هیچ راه حل یا پیشنهادی ارائه نشده است.

پیام‌های تأخیر بالا، DEADLINE_EXCEEDED و INTERNAL_ERROR برای متدهای محصول و موجودی‌ها

گزارش شده: 2026-03-18 UTC | حل شده: 2026-03-31 UTC

برخی از کاربران هنگام استفاده از متدهای productInputs و regionalInventories با تأخیر پایدار و پیام‌های مکرر DEADLINE_EXCEEDED یا INTERNAL_ERROR مواجه می‌شدند. علت اصلی، یک حادثه در سطح backend بود که بر کارایی پردازش تأثیر می‌گذاشت.

راه‌حل: این حادثه در ۳۱ مارس ۲۰۲۶ به طور کامل کاهش یافت. پس از کاهش، میزان خطا به طور قابل توجهی کاهش یافته است. اگر همچنان با تأخیر بالا مواجه هستید، توصیه می‌کنیم وقفه‌های سمت کلاینت خود را تأیید کنید و اندازه دسته درخواست‌ها را کاهش دهید.

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

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

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

ما بهبودهایی را برای افزایش عملکرد سیستم‌های مختلف 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 هنگام تلاش برای درج موارد ظرف ۵ دقیقه پس از ایجاد منبع داده، بازگردانده شد.

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

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

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