شروع انتقال

این صفحه راهنمایی‌هایی درباره برنامه‌ریزی انتقال میانای برنامه‌سازی کاربردی ارائه می‌دهد و مراحل لازم را به‌طور خلاصه بیان می‌کند.

برنامه‌ریزی انتقال

1. روش‌های Content API for Shopping را به روش‌های Merchant API نگاشت کنید.

   روش‌ها و منابع جدید موردنیاز برای Merchant API را درک کنید.

2. مهم‌ترین تغییراتی را که برای انتقال شما اعمال می‌شود درک کنید.

   برای کمک به انتقال، منابع زیر را مرور کنید:

   • نمای کلی انتقال از Content API: این بخش جزئیات تغییرات عمده‌ای را که باید در Merchant API از آن‌ها مطلع باشید ارائه می‌دهد
   • راهنماهای انتقال خاص زیرمیانای برنامه‌سازی کاربردی: راهنماهای انتقال خاص زیرمیانای برنامه‌سازی کاربردی موردنیازتان را مرور کنید، زیرا اطلاعات مهمی مانند نگاشت‌های فیلد جدید را ارائه می‌دهند. برای مثال، انتقال مدیریت محصولات را ببینید.
   • مرجع Merchant API جزئیات منابع و روش‌های Merchant API را ارائه می‌دهد.
   • راهنمای شروع سریع نحوه شروع سریع استفاده از Merchant API را برای ایجاد حساب و بارگذاری محصول نمونه نشان می‌دهد.
   • راهنماهای ویژه ویژگی: برای پیاده‌سازی ویژگی جدید یا برای شفاف‌سازی بیشتر، می‌توانید راهنماهای ویژگی ارائه‌شده در پیمایش را مرور کنید.

3. زیر-واسط‌های برنامه‌سازی کاربردی را که قصد دارید انتقال دهید و می‌خواهید پیاده‌سازی کنید شناسایی کنید.

   دو چیز را مشخص کنید:

   • ویژگی‌های Merchant API که باید انتقال دهید
   • ویژگی‌های جدیدی که می‌خواهید پیاده‌سازی کنید

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

   اگر نمی‌توانید کل پیاده‌سازی Content API خود را در ابتدا انتقال دهید، زیر-APIهای زیر را براساس اهمیت و پیچیدگی اولویت‌بندی کنید.

   • حساب‌ها
   • محصولات
   • منابع داده
   • گزارش‌ها
   توجه: بسته به نوع ادغام، می‌توانید این کار را به‌صورت موردی انجام دهید. برای مثال، ویژگی‌ای مثل موجودی‌ها ممکن است اولویت بالاتری داشته باشد.

مراحل انتقال

1. ثبت‌نام به‌عنوان توسعه‌دهنده برای استفاده از Merchant API، باید پیوندی بین پروژه Google Cloud و حساب Merchant Center اصلی‌تان ایجاد کنید. این ثبت‌نام یک‌باره برای هر پروژه Google Cloud که با Merchant API استفاده می‌کنید الزامی است. می‌توانید کل فرایند را در صفحه نمای کلی دنبال کنید.

   توجه: اگر نیاز دارید به پروژه جدید Google Cloud انتقال دهید یا چندین پروژه را درطول مهاجرت مدیریت کنید، مدیریت و انتقال پروژه‌های Google Cloud را ببینید.

2. روش‌های مختلف را آزمایش کنید تا به شما در افزایش سرعت کمک کند. توصیه می‌کنیم برای انجام آزمایش‌های پایه از Google APIs Explorer استفاده کنید.

   قالب نشانی‌های وب درخواست برای Merchant API به‌صورت زیر است

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. از نمونه‌های کد و کتابخانه‌های مشتری ما بهره ببرید.

   برای کمک به کاهش زمان پیاده‌سازی و بهره‌مندی از gRPC، از کتابخانه‌های کاربر و نمونه‌های کد استفاده کنید.

   راهنماها شامل تکه‌کدهای نمونه کد هستند. برای مثال، افزودن محصول را ببینید.

4. سفرهای ساده کاربر را آزمایش کنید.

   آزمایش سفر کاربر را روی همه میاناهای برنامه‌سازی کاربردی فرعی و عملکردهایی که قصد دارید منتقل کنید با اهداف زیر انجام دهید:

   • منابع و تماس‌های انتقال‌یافته شما نتایج پاسخ صحیح دارند.
   • نسبت خطا همچنان پایین است.

برنامه‌ریزی برای عرضه

رویکرد زیر را توصیه می‌کنیم:

• هر بار یک روش یا میانای برنامه‌سازی کاربردی فرعی را پیاده‌سازی کنید.
• هر بار فقط برای بخش کوچکی از کسب‌وکار پیاده‌سازی کنید.
• همواره مشکلات را پایش کنید.

پیاده‌سازی انتقال

1. بااستفاده از منابع و نقاط پایانی جدید، روی کدنویسی کار کنید.

   پس‌از آزمایش اولیه و توسعه طرح انتشار، Merchant API را در گردش‌های کاری‌تان ادغام کنید.

2. مانیتور.

   برای رسیدگی به مشکلات احتمالی آماده شوید.