אתם יכולים להשתמש ב-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 |
|
|
ההגדרה של המחיר השתנתה. מידע נוסף מופיע במאמר בנושא מחיר. |
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 |
|
|
ההגדרה של המחיר השתנתה. מידע נוסף מופיע במאמר בנושא מחיר. |
timestamp: string |
saleTime: string |
השם של timestamp השתנה לשם saleTime |
kind: string |
לא נתמך | kind לא נתמך ב-API של שותפים לניהול פידים של חנויות מקומיות. |