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

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

תכונות חדשות

בנוסף לתכונות של Content API, ‏ Merchant API כולל את התכונות החדשות הבאות:

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

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

בקשות

משתמשים בפורמט הבא של כתובת URL לבקשה עבור Local Feeds Partnership API:

POST https://merchantapi.googleapis.com/lfp/v1/{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/v1/{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/v1/{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/v1/{PARENT}/lfpStores:insert
מזהים {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

Methods

אלה השינויים שבוצעו בשיטות של 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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} הערך {PARENT} הוא בפורמט accounts/{IFP_PARTNER_ACCOUNT_ID}

משאבים

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

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

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

Content API for Shopping Merchant API תיאור
לא נתמך name: string נוסף שדה חדש כדי להבחין בין מלאי שטחי פרסום שונים
לא נתמך targetAccount: integer חשבון Merchant Center שאליו רוצים להוסיף מלאי.
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 חשבון Merchant Center שאליו רוצים להוסיף את נתוני המכירות
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 של שותפים לניהול פידים של חנויות מקומיות.