תוכלו להשתמש ב-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/{merchantId}/pos/{targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
|
| מזהים |
{merchantId}/pos/{targetMerchantId}
|
{parent} |
לפניכם השוואה לדוגמה בין Content API for Shopping לבין API של שותפות הפיד המקומי לבקשת הוספת מכירה:
| Content API | Merchant API | |
| כתובת URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
| מזהים | {merchantId}/pos/{targetMerchantId} |
{parent} |
לפניכם השוואה לדוגמה בין Content API for Shopping לבין ה-API של שותפי הפיד המקומי לבקשת הוספת חנות:
| Content API | Merchant API | |
| כתובת URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert |
| מזהים | {merchantId}/pos/{targetMerchantId} |
{parent} |
שיטות
אלה השינויים בשיטות של 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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent בפורמט accounts/{lfpPartnerAccountId} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name בפורמט accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name בפורמט accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores |
/{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} בפורמט accounts/{lfpPartnerAccountId} |
אלה השינויים בשיטות ה-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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent בפורמט accounts/{lfpPartnerAccountId} |
אלה השינויים בשיטות של 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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} בפורמט accounts/{lfpPartnerAccountId} |
משאבים
בטבלה הבאה מפורטים השינויים במשאב החנות ב-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 בממשק ה-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 של שותף לניהול פידים של חנויות מקומיות. |