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

אתם יכולים להשתמש ב-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 של התוכנית לספקי ניהול פידים עבור חנויות מקומיות:

שיטה	כתובת 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 של שותפים לניהול פידים של חנויות מקומיות.