העברה של ספק ניהול פידים עבור חנויות מקומיות

אתם יכולים להשתמש ב-Merchant API כדי לשתף עם Google את המלאי, החנויות ונתוני המכירות שלכם, וכך לשפר את החשיפה והניהול שלהם.

תכונות חדשות

בנוסף לתכונות של Content API, Merchant API מציע את התכונות החדשות הבאות:

  • שיטה לאחזור המצב של נכסים ברמת המוכר שקשורים לשילוב של התוכנית לספקי ניהול פידים עבור חנויות מקומיות
  • שיטה לשליחת התראה לקמעונאי

פרטים על השיטות האלה זמינים במאמר Local feeds partnership API.

בקשות

צריך להשתמש בפורמט הבא של כתובת ה-URL של הבקשה ל-API של התוכנית לספקי ניהול פידים עבור חנויות מקומיות:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert

מידע נוסף זמין במאמר שיטה: accounts.lfpInventories.insert.

לפניכם השוואה לדוגמה בין Content API for Shopping לבין ה-API של שותפי הפיד המקומי לבקשת הוספת מלאי:

Content API Merchant API
כתובת URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
מזהים {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

לפניכם השוואה לדוגמה בין Content API for Shopping לבין API של שותפי הפיד המקומי בבקשה להוספת מכירה:

Content API Merchant API
כתובת URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert
מזהים {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

לפניכם השוואה לדוגמה בין Content API for Shopping לבין ה-API של שותפי הפיד המקומי לבקשת הוספת חנות:

Content API Merchant API
כתובת URL POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert
מזהים {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

Methods

אלה השינויים בשיטות של Store API ב-API של תוכנית השותפים לניהול פידים של חנויות מקומיות:

שיטה כתובת URL ב-Content API for Shopping כתובת URL ב-Merchant API מזהים ב-Content API for Shopping מזהים ב-Merchant API תיאור
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent בפורמט של accounts/{IFP_PARTNER_ACCOUNT_ID}
delete DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} name בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
get GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} name בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
list GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores ‎/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}

אלה השינויים בשיטות ה-API של מלאי שטחי הפרסום ב-API של תוכנית השותפים לניהול פידים מקומיים:

שיטה כתובת URL ב-Content API for Shopping כתובת URL ב-Merchant API מזהים ב-Content API for Shopping מזהים ב-Merchant API תיאור
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}

אלה השינויים בשיטות של Sales API ב-API של שותפי התוכנית לניהול פידים של חנויות מקומיות:

שיטה כתובת URL ב-Content API for Shopping כתובת URL ב-Merchant API מזהים ב-Content API for Shopping מזהים ב-Merchant API תיאור
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}

משאבים

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

Content API for Shopping Merchant API תיאור
לא נתמך name: string הוספנו שדה חדש כדי להבדיל בין חנויות שונות
לא נתמך targetAccount: integer חשבון המוכר שאליו רוצים להוסיף מלאי
targetCountry: string regionCode: string השם של targetCountry השתנה ל-regionCode
websiteUrl: string websiteUri: string השם של websiteUrl השתנה ל-websiteUri
kind: string לא נתמך kind לא נתמך ב-Partner API של פידים של חנויות מקומיות

ריכזנו כאן את השינויים בהוספת מלאי שטחי פרסום. שדות שלא נכללים כאן לא משתנים.

Content API for Shopping Merchant API תיאור
לא נתמך name: string הוספנו שדה חדש כדי להבדיל בין מלאי שטחי פרסום שונים
לא נתמך targetAccount: integer חשבון המוכר שאליו רוצים להוסיף מלאי.
targetCountry: string regionCode: string השם של targetCountry שונה ל-regionCode. קוד האזור במאגר CLDR של המדינה שבה המוצר נמכר.
itemId: string offerId: string השם של itemId השתנה ל-offerId
quantity: string quantity: string השדה quantity עודכן ל'אופציונלי'
לא נתמך availability: string חובה להגדיר availability

price: {

object (Price)

}

price: {

object (Price)

}

הגדרת המחיר השתנתה. מידע נוסף זמין בקטע מחיר.
timestamp: string collectionTime: string השם של timestamp השתנה ל-collectionTime
kind: string לא נתמך אין תמיכה ב-kind ב-API של שותף לניהול פידים של חנויות מקומיות.

ריכזנו כאן את השינויים בנוגע להוספת מכירה. שדות שלא נכללים כאן לא משתנים.

Content API for Shopping Merchant API תיאור
לא נתמך name: string הוספנו שדה חדש כדי להבדיל בין מלאי שטחי פרסום שונים
לא נתמך targetAccount:integer חשבון המוכר שאליו רוצים להוסיף מכירות
targetCountry: string regionCode: string קוד האזור במאגר CLDR של המדינה שבה המוצר נמכר.
itemId: string offerId: string השם של itemId השתנה ל-offerId

price: {

object (Price)

}

price: {

object (Price)

}

הגדרת המחיר השתנתה. מידע נוסף זמין בקטע מחיר.
timestamp: string saleTime: string השם של timestamp השתנה ל-saleTime
kind: string לא נתמך אין תמיכה ב-kind ב-API של שותף לניהול פידים של חנויות מקומיות.