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

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

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

گزارش‌شده: ۲۰۲۶-۰۱-۲۸ ساعت هماهنگ جهانی | آخرین به‌روزرسانی: ۲۰۲۶-۰۳-۳۱ ساعت هماهنگ جهانی

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

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

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

شناسه‌های محصول با نویسه‌های خاص

گزارش‌شده: ۲۰۲۵-۱۰-۰۳ UTC | آخرین به‌روزرسانی: ۲۰۲۶-۰۴-۰۸ UTC

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

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

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

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

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

گزارش‌شده: ۲۰۲۴-۰۴-۱۰ به‌وقت ساعت هماهنگ جهانی | آخرین به‌روزرسانی: ۲۰۲۴-۰۵-۱۲ به‌وقت ساعت هماهنگ جهانی

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

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

مشکل دیگری دارید؟

برای هر مشکل دیگری، به صفحه‌های دریافت راهنمایی درباره Merchant API و ارائه بازخورد ما بروید.