התחלת ההעברה

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

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