ما رابط برنامهنویسی فروشگاه (Merchant API) را طوری طراحی کردهایم که با رابط برنامهنویسی محتوا برای توسعهدهندگان خرید (Content API for Shopping) آشنا باشد، اما در عین حال سادهتر و انعطافپذیرتر باشد. در اینجا اطلاعات دقیقی در مورد طراحی رابط برنامهنویسی فروشگاه ارائه شده است.
زیر-APIها
رابط برنامهنویسی کاربردی فروشگاه (Merchant API) مجموعهای از زیر-APIها است. زیر-APIها گروههایی از خدمات و منابع مرتبط هستند. این طراحی به این معنی است که شما میتوانید فقط از زیر-APIهای مورد نیاز برای یکپارچهسازی منحصر به فرد خود استفاده کنید.
API فروشنده شامل زیر API های زیر است:
- حسابها : حسابهای مرکز فروش را در مقیاس بزرگ مدیریت کنید.
- تبدیلها : منابع تبدیل را برای حساب خود مدیریت کنید.
- منابع داده : منابع داده محصولات خود را مشاهده و مدیریت کنید.
- حل مشکل : مشکلات مربوط به حساب کاربری خود را دریافت کنید و یک صفحه تشخیص درون برنامهای ایجاد کنید.
- موجودی کالا : محصولات خود را بر اساس فروشگاه یا منطقه در گوگل نمایش دهید.
- مشارکت در فیدهای محلی : فید موجودی محصولات محلی خود را بارگذاری کنید.
- اعلانها : اشتراکهای اعلان را مدیریت کنید.
- ردیابی سفارش : دادههای ردیابی سفارشهای قبلی را برای بهبود تخمینهای ارسال و بهبود فهرستها با حاشیهنویسیهای ارسال ارائه دهید.
- محصولات : دادههای محصول، مانند قیمت و موجودی را مدیریت کنید.
- استودیوی محصول : از استودیوی محصول گوگل برای تولید خودکار تصاویر محصول و پیشنهاد متن استفاده کنید.
- تبلیغات : برای نمایش پیشنهادات ویژه محصولات خود، تبلیغات ایجاد و مدیریت کنید.
- سهمیه : سهمیه API حسابهای خود را بررسی کنید.
- گزارشها : دادههای مربوط به محصولات، عملکرد و چشمانداز رقابتی خود را در سراسر گوگل مشاهده کنید.
- نظرات : نظرات مربوط به محصولات و فروشندگان را مدیریت کنید.
حمل و نقل
مکانیزم انتقال پیشفرض رابط برنامهنویسی کاربردی فروشنده، gRPC است. شما همچنین میتوانید از REST استفاده کنید.
برای اطلاعات بیشتر به راهنمای شروع سریع مراجعه کنید.
انومها
فیلدهای Enum در سراسر API فروشگاه ممکن است در آینده مقادیر جدیدی را نمایش دهند. کد شما باید به گونهای ساختار یافته باشد که بتواند مقادیر ناشناخته را به خوبی مدیریت کند. شما باید وقوع مقادیر ناشناخته enum را رصد کنید و برای بهروز نگه داشتن کد، مداخله کنید.
نسخهبندی
زیر-APIها به صورت جداگانه نسخهبندی میشوند. این یعنی اگر ما یک زیر-API را که استفاده نمیکنید بهروزرسانی کنیم، لازم نیست کاری انجام دهید. فقط زمانی که نسخههای جدید زیر-APIهایی که استفاده میکنید منتشر شوند، باید کد خود را بهروزرسانی کنید. برای اطلاعات بیشتر، به بخش نسخهبندی مراجعه کنید.
نسخههایی که به «بتا» ختم میشوند، در معرض تغییر یا حذف هستند.