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