התחלת ההעברה

בדף הזה מוסבר איך לתכנן את המעבר ל-API החדש ומפורטים השלבים הנדרשים.

תכנון ההעברה

1. ממפים את השיטות של Content API for Shopping לשיטות של Merchant API.

   להבין את השיטות והמשאבים החדשים שנדרשים ל-Merchant API.

2. הבנת השינויים המשמעותיים ביותר שחלים על ההעברה.

   ריכזנו כאן קישורים למקורות מידע שיעזרו לכם בתהליך ההעברה:

   • מעבר מ-Content API – סקירה כללית: במאמר הזה מפורטים השינויים העיקריים שכדאי להכיר ב-Merchant API
   • מדריכים ספציפיים להעברת נתונים (מיגרציה) של ממשקי 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. מעקב.

   הכנה לטיפול בבעיות פוטנציאליות.