אתם יכולים להשתמש ב-Merchant API כדי לשתף את נתוני המלאי, החנויות והמכירות שלכם עם Google לשיפור החשיפה והניהול.
בקשות
עבור ה-API של השותפות עם פידים מקומיים צריך להשתמש בפורמט הבא של כתובת URL:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
למידע נוסף, ראו שיטה: accounts.lfpInventories.insert.
השוואה לדוגמה בין Content API for Shopping לבין פידים מקומיים Partner API לבקשה להוסיף מלאי:
Content API | ממשק API של Merchant | |
כתובת 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 לבין פידים מקומיים Partner API לבקשה להוספת מכירה:
Content API | ממשק API של Merchant | |
כתובת 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 לבין פידים מקומיים Partner API לבקשה להוספת חנות:
Content API | ממשק API של Merchant | |
כתובת 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} |
שיטות
אלה השינויים שבוצעו בשיטות ה-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} |
אלה השינויים שבוצעו בשיטות ה-API של 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 | ממשק API של Merchant | תיאור |
לא נתמך | name: string |
נוסף שדה חדש כדי להבדיל בין חנויות שונות |
לא נתמך | targetAccount: integer |
חשבון המוכר שבו רוצים להוסיף את נתוני המלאי |
targetCountry: string |
regionCode: string |
השם של targetCountry השתנה ל-regionCode |
websiteUrl: string |
websiteUri: string |
השם של websiteUrl השתנה ל-websiteUri |
kind: string |
לא נתמך | אין תמיכה ב-kind בממשק ה-API של השותפות לניהול פידים של חנויות מקומיות |
אלה השינויים שביצענו בהוספת מלאי שטחי פרסום. השדות שלא נכללים כאן הם ללא שינוי.
Content API for Shopping | ממשק API של Merchant | תיאור |
לא נתמך | 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 | ממשק API של Merchant | תיאור |
לא נתמך | 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 של השותפות לניהול פידים עבור חנויות מקומיות. |