במסמך הזה מתוארות כמה שיטות מומלצות לשימוש ב-CSS API. ההמלצות שבדף הזה לא חובה לפעול לפיהן כדי להשתמש ב-API, אבל הן יכולות לעזור להבהיר חלק מהשימושים המיועדים.
הגדרת הסביבה
כדי להגדיר את סביבת הפיתוח, פועלים לפי השלבים שמפורטים במסמכי המדריך למתחילים.
- יצירת משתמש וקובץ JSON של הרשאות במסוף Google Cloud
- הפעלת CSS API במסוף Google Cloud
- מוסיפים את המשתמש הזה עם הרשאות אדמין לחשבון ה-CSS (קבוצה או דומיין)
ספריות הלקוח נמצאות עכשיו במאגרים הרגילים של רוב שפות התכנות. רשימה שלהם מופיעה בדף ספריית הלקוח.
שיטות טובות להתחלה
מומלץ לבדוק באמצעות השיטות הבאות:
ListChildAccounts
ListChildAccounts היא קריאה לקריאה בלבד שמציגה רשימה של כל הדומיינים של ה-CSS (אם הקריאה היא לקבוצת CSS) או של המוכרים (אם הקריאה היא לדומיין CSS). לכן זוהי שיטה טובה לבדוק אם הכל מוגדר בצורה נכונה.
הוספה, הצגה ברשימה, עדכון ומחיקה של מוצרים
אחרי שתבדקו שה-API פועל, נסו להוסיף מוצר. חשוב להשתמש ב-raw_provided_id שקל לזכור.
- מוסיפים מוצר בדיקה באמצעות InsertCssProductInput. אם אתם צריכים עזרה לגבי המאפיינים שצריך לשלוח, יש לנו קוד לדוגמה.
- מציגים את כל המוצרים באמצעות ListCssProducts. יש עיכוב עיבוד קצר לפני שהמוצר מופיע אחרי ההוספה, לכן אם הוא לא מופיע, נסו שוב אחרי כמה שניות.
- מעדכנים מוצר יחיד באמצעות UpdateCssProductInput באמצעות
cssproductinput.name. צריך לשלוח רק את המאפיינים שרוצים לעדכן. כאן תוכלו למצוא קוד לדוגמה. - מוחקים את מוצר הבדיקה באמצעות DeleteCssProductInput.
תצטרכו להשתמש ב-
raw_provided_id.
שימוש ב-Async כדי לשפר את הביצועים
ה-CSS API מיועד לקריאות מקבילות. תוכלו לראות שהביצועים של פעולות בודדות יכולים להיות איטיים, אבל הם יהיו מהירים הרבה יותר כשמפעילים את אותה פעולה כמה פעמים במקביל. הדרך הטובה ביותר להשתמש בתכונה הזו היא להשתמש בפונקציונליות האסינכרונית של שפת התכנות.
דוגמאות משפות תכנות מסוימות:
- ב-Java, משתמשים ב-insertCssProductInputCallable().futureCall()
- ב-Python, משתמשים ב-CssProductInputsServiceAsyncClient
- ב-C#, משתמשים ב-InsertCssProductInputAsync
מוצאים את הפונקציונליות של Async בשפת התכנות שלכם ומשתמשים בה כדי להוסיף כמה מוצרים בו-זמנית. אין צורך לדאוג לגבי עומס יתר על המערכות שלנו – לכך משמשות המגבלות על המכסות.
פרטים נוספים זמינים בדף הביצועים.
עדכון מוצר
אחרי שמעלים מוצר, הוא נשאר במערכת שלנו עד שהוא מתעדכן, נמחק או שתוקף המוצר פג.
- כדי לעדכן את המוצר המלא, שולחים שוב את הבקשה
InsertCssProductInput, עם אותוraw_provided_idשבו השתמשתם בהתחלה. בשלב הזה, תצטרכו לשלוח את נתוני המוצר המלאים, גם אם רק חלק מהמאפיינים (אולי רק המחיר או הזמינות) השתנו. - אפשר לעדכן חלקים של מוצר באמצעות שיטת ה-PATCH
UpdateCssProductInput, לציין את שם המוצר וגוף JSON שמכיל את הנתונים שרוצים לעדכן במוצר. בניגוד ל-InsertCssProductInput, שבו צריך לציין את כל השדות הרלוונטיים, ב-UpdateCssProductInputצריך לציין רק את השדות שרוצים לשנות. - כדי למחוק מוצר, צריך להפעיל את
DeleteCssProductInputעם אותוraw_provided_id. - התוקף של המוצרים פג באופן אוטומטי כחודש לאחר העדכון האחרון.
מצב פעולה רציף
מצב פעולה רציף עשוי להיראות כך:
- משתמשים במזהים פנימיים משלכם כ-
raw_provided_id. - להעלות מחדש את כל המוצרים במסגרת לוח זמנים קבוע, אולי שבועי. כך תוכלו לוודא שתוקף המוצרים הפעילים לא יפוג.
- מעדכנים מוצרים ספציפיים ברגע שמקבלים מהמוכרים את הנתונים המעודכנים.
- אם אין לכם אפשרות להגיב לשינויים באופן מיידי, כדאי למצוא את כל המוצרים שהשתנו בתדירות גבוהה (אולי מדי שעה) ולהעלות מחדש רק את המוצרים האלה.
- לגבי מוצרים שלא זמינים יותר, אפשר להשתמש באפשרות המחיקה או להגדיר את מספר המוצרים הזמינים ל-0.
- אין לשלוח לנו מוצרים ללא שינוי בתדירות גבוהה. הקריאות האלה ייחשבו כחלק ממכסת ה-API שלכם. עדכון שבועי מספיק.
בחירת המוצר המרכזי בדף
המוצר המרכזי בדף לא חייב להיות המוצר המוביל או המוצר הזול ביותר באתר, אבל הוא צריך להיות מוצג בצורה בולטת. אפשר להשתמש באפשרות הזו במקרים שבהם המבצע המוביל משתנה במהירות: במקרה כזה, תוכלו לבחור מבצע אחר יציב יותר.
כדאי לבדוק שוב את המסמך הזה מדי פעם
קיבלנו משוב על שיפורים אפשריים ל-API הזה, ואנחנו עובדים על הפצת חלק מהשיפורים האלה. הדף הזה יתעדכן כשיהיו לנו תכונות חדשות שיקלו על השימוש ב-CSS API.