התחלת ההעברה

בדף הזה אנחנו מספקים הנחיות לתכנון המיגרציה של ה-API.

לאחר מכן, נספק סקירה כללית של השלבים שצריך לבצע כדי להעביר את הנתונים.

תכנון ההעברה

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

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

2. חשוב להבין את השינויים המשמעותיים ביותר שרלוונטיים להעברה שלכם.

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

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

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