התחלת ההעברה

בדף הזה מוסבר איך לתכנן את המיגרציה של ה-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 שבו משתמשים ב-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. מעקב.

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