בדף הזה אנחנו מספקים הנחיות לתכנון המיגרציה של ה-API.
לאחר מכן, נספק סקירה כללית של השלבים שצריך לבצע כדי להעביר את הנתונים.
תכנון ההעברה
מיפוי של שיטות Content API for Shopping לשיטות Merchant API
מאוד מועיל להבין בבירור את השיטות והמשאבים החדשים שנדרשים ל-Merchant API.
חשוב להבין את השינויים המשמעותיים ביותר שרלוונטיים להעברה שלכם.
מומלץ לעיין במקורות המידע הבאים ולזכור אותם, כי הם יעזרו לכם בתהליך ההעברה:
- סקירה כללית של מעבר מ-Content API: כאן מפורטים השינויים העיקריים שכדאי להכיר ב-Merchant API
- מדריכים להעברת נתונים (מיגרציה) ספציפיים לכל sub-API: חשוב לעיין במדריכים הספציפיים לכל sub-API שרלוונטיים לכם, כי הם כוללים מידע חשוב כמו מיפויים של שדות חדשים. לדוגמה, אפשר לעיין במאמר בנושא העברת ניהול מוצרים.
- בהפניית API של Merchant API מפורטים המשאבים והשיטות של Merchant API.
- במדריך למתחילים מוסבר איך להתחיל להשתמש ב-Merchant API במהירות כדי ליצור חשבון ולהעלות מוצר לדוגמה.
- מדריכים ספציפיים לתכונות: כדי להטמיע תכונות חדשות או לקבל הבהרות נוספות, אפשר לעיין במדריכים לתכונות שמופיעים בסרגל הניווט.
מזהים את ממשקי ה-API המשניים שמתכננים להעביר ורוצים להטמיע.
צריך לקבוע שני דברים:
- התכונות של Merchant API שצריך להעביר
- התכונות החדשות שרוצים להטמיע
אחרי שתעשו את זה, תוכלו לקבוע את רמת המאמץ ואת רשימת העדיפויות של ממשקי ה-API המשניים שצריך לעבוד עליהם.
מומלץ להעביר הכול, או כמה שיותר. אם לא ניתן להעביר את כל ההטמעה של Content API בהתחלה, בגלל חשיבות ומורכבות, כדאי לתת עדיפות לממשקי המשנה הבאים של API.
שלבים בהעברה
הרשמה כמפתח כדי להשתמש ב-Merchant API, צריך ליצור קישור בין פרויקט Google Cloud לבין חשבון Merchant Center הראשי. ההרשמה הזו מתבצעת פעם אחת בלבד, והיא נדרשת לכל פרויקט בענן ב-Google שבו משתמשים ב-Merchant API. כאן אפשר לעקוב אחרי התהליך כולו.
כדאי לבדוק שיטות שונות כדי להבין מה הכי מתאים לכם. מומלץ להשתמש בGoogle APIs Explorer כדי לבצע בדיקות בסיסיות.
הפורמט של כתובות URL של בקשות ל-Merchant API הוא
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…כדאי להשתמש בדוגמאות הקוד ובספריות הלקוח שלנו.
כדי לקצר את זמן ההטמעה וליהנות מ-gRPC, מומלץ להשתמש בספריות הלקוח ובדוגמאות הקוד.
אנחנו גם מטמיעים קטעי דוגמאות קוד במדריכים שלנו. לדוגמה, אפשר לעיין במאמר בנושא הוספת מוצר.
בודקים תהליכים פשוטים שעוברים המשתמשים.
כדאי לבצע בדיקות של תהליך המשתמש בכל ממשקי ה-API המשניים והפונקציות שמתכננים להעביר, עם המטרות הבאות:
- המשאבים והשיחות שהועברו כוללים תוצאות תגובה נכונות.
- שיעור השגיאות נשאר נמוך.
תכנון ההשקה
אנחנו ממליצים על הגישה הבאה:
- הטמעה של שיטת API או שיטת משנה אחת בכל פעם.
- מטמיעים רק בפלח קטן של העסק בכל פעם.
- מעקב אחר בעיות בכל שלב.
הטמעת ההעברה
עובדים על קידוד באמצעות המשאבים ונקודות הקצה החדשים.
אחרי בדיקה ראשונית ופיתוח של תוכנית השקה, משלבים את Merchant API בתהליכי העבודה.
מעקב.
הכנה לטיפול בבעיות פוטנציאליות.