התחלת ההעברה

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

   הערה: אם אתם צריכים לעבור לפרויקט חדש ב-Google Cloud או לנהל כמה פרויקטים במהלך ההעברה, קראו את המאמר ניהול פרויקטים ב-Google Cloud ומעבר ביניהם.

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. מעקב.

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