התחלת ההעברה

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

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

תכנון ההעברה

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

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

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

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

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

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