مهاجرت خود را شروع کنید

در این صفحه، ما راهنمایی هایی را برای برنامه ریزی مهاجرت API ارائه می دهیم.

سپس مروری بر مراحلی که برای مهاجرت به آنها نیاز دارید، می اندازیم.

برای مهاجرت خود برنامه ریزی کنید

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

   درک واضح روش ها و منابع جدیدی که برای Merchant API نیاز دارید بسیار مفید است.

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

   توصیه می کنیم منابع زیر را مرور کرده و در نظر داشته باشید زیرا برای مهاجرت شما مفید خواهند بود:

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

3. API های فرعی را که قصد مهاجرت آنها را دارید و می خواهید پیاده سازی کنید، شناسایی کنید.

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

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

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

   توصیه می کنیم همه چیز را یا تا حد امکان مهاجرت کنید. اگر به دلیل اهمیت و پیچیدگی قادر به انتقال کل اجرای Content API خود در ابتدا نیستید، APIهای فرعی زیر را در اولویت قرار دهید.

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

مراحل مهاجرت

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

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

   فرمت URL های درخواست برای Merchant API است

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

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

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

   ما همچنین قطعات نمونه کد را در راهنماهای خود قرار می دهیم. برای مثال، افزودن یک محصول را ببینید.

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

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

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

راه اندازی خود را برنامه ریزی کنید

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

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

مهاجرت خود را اجرا کنید

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

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

2. نظارت کنید.

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