אתם יכולים להיעזר במדריך הזה כדי לשלב את Merchant API עם ההטמעה הקיימת של Content API for Shopping.
שנתחיל?
לפרטים על העיצוב של Merchant API Merchant API, וממשקי ה-API המשניים שלו.
כדי להתחיל להשתמש ב-Merchant API, צריך לשנות את כתובות ה-URL של הבקשות לכתובות הבאות פורמט:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
עיין במדריך למתחילים מידע נוסף זמין בחומר לעיון ב-Merchant API.
תמיכה ב-gRPC
Merchant API תומך ב-gRPC וב-REST. אפשר להשתמש gRPC ל-Merchant API ול-REST ב-Content API for Shopping בו-זמנית בזמן האימון.
צריך להשתמש בספריות הלקוח של Merchant API gRPC.
מידע נוסף זמין במאמר שימוש ב-gRPC מידע.
תאימות
במדריך הזה מתוארים שינויים כלליים שחלים על כל Merchant API. צפייה את המדריכים הבאים לשינויים בתכונות ספציפיות:
- העברת ניהול החשבונות
- העברת הגדרות המשלוח
- העברת ניהול מוצרים
- ניהול של מקורות נתונים
- העברת ניהול מלאי שטחי פרסום
- העברה של ניהול מבצעים
- העברת ניהול הדוחות
- העברת ניהול של מקורות המרות
- העברת ניהול שותפות של פידים מקומיים
Merchant API תוכנן לפעול במקביל ל-Content API for Shopping הקיים תכונות גרסה 2.1.
לדוגמה, אפשר להשתמש ב-Merchant Inventories API לצד החשבון הקיים
Content API for Shopping גרסה 2.1 של מלאי שטחי הפרסום
products. שלך
עשוי להשתמש ב-Content API for Shopping כדי להעלות נכס מקומי חדש
המוצר (שאתם מוכרים
בחנות מקומית), ואז להשתמש ב-Merchant Inventories API
LocalInventory
לניהול המידע בחנות לגבי אותו מוצר.
בקשות אצווה
Merchant API לא תומך בשיטה customBatch שמופיעה
Content API for Shopping. במקום זאת, ראו שליחת מקבץ הודעות
בקשות. אם משתמשים ב-customBatch, וגם
צריכים את התכונה הזו ל-Merchant API, ספר לנו למה
משוב.
מזהים
כדי להתאים לעקרונות ה-API לשיפור ה-API של Google, ביצע כמה שינויים במזהים של המשאבים של Merchant API.
השם מחליף את המזהה
כל המשאבים ב-Merchant API משתמשים בשדה name בתור המזהה הייחודי שלהם.
הנה דוגמה לשימוש בשדה name בשיחות:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
השדה name החדש מוחזר בתור מזהה המשאב לכל הפעולות שנקראו
לכתוב קריאות ב-Merchant API.
הערך שמוחזר בשדות name הוא בפורמט המזהה החדש.
לדוגמה, הטמעה של method getName() כדי לאחזר את name
משאב, ולאחסן את הפלט כמשתנה במקום ליצור את name
מהמוכר וממזהי המשאבים.
פורמט חדש של מזהה
ב-Merchant API, מזהי המשאבים מופיעים בפורמט הבא:
channel~language~feedLabel~offerId
במשאבי ה-Content API נעשה שימוש ב-: במקום ב-~ בין כל ערך במזהה:
channel:language:feedLabel:offerId
כל הקריאות ל-Merchant API מחזירות את הפורמט החדש עם ~ בין הערכים של
ID. מומלץ לשמור את הפורמט החדש מהתשובה ולהשתמש בו
שיחות עתידיות.
שדות הורה למשאבי צאצא
ב-Merchant API, כל משאבי הצאצא כוללים את השדה parent. אפשר להשתמש
השדה parent כדי לציין את ה-name של המשאב שאליו צריך להוסיף את הצאצא,
במקום להעביר את כל משאב ההורה. אפשר גם להשתמש ב-parent
שדה עם methods של list כדי להציג את רשימת משאבי הצאצא של ה-parent.
לדוגמה, כדי להציג את נתוני המלאי בחנות המקומית של מוצר נתון, צריך לציין את
name של המוצר
parent
שדה עבור
list
. במקרה הזה, product הנתון הוא parent של
LocalInventory
משאבים שהוחזרו.
סוגים
לפניכם כמה סוגים נפוצים של ממשקי המשנה של ממשקי ה-API של Merchant API.
מחיר
אלה השינויים שבוצעו ב-Price בחבילה של Merchant Common:
| Content API | ממשק API של Merchant | |
|---|---|---|
| שדה סכום | value:string |
amountMicros:int64 |
| שדה מטבע | currency:string
|
currencyCode:string |
הסכום של Price מתועד עכשיו במיליוניות השנייה, שבהן מיליון מיקרו-שניות
שמקביל ליחידה הרגילה של המטבע שלך.
ב-Content API for Shopping, הערך Price היה מספר עשרוני בצורת
String.
השם של שדה הסכום השתנה. השם הישן: value השם החדש: amountMicros
השם של שדה המטבע השתנה מ-currency ל-currencyCode.
נשאר בפורמט ISO 4217.