תוכלו להשתמש ב-Merchant API כדי לשתף עם Google את נתוני המלאי, החנויות והמכירות שלכם, כדי לשפר את החשיפה והניהול.
בקשות
עבור ה-API לשותפות עם פידים של חנויות מקומיות, צריך להשתמש בפורמט הבא לכתובת ה-URL של הבקשה:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
לפניכם השוואה לדוגמה בין Content API for Shopping לבין ה-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 לבין ה-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 לבין ה-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} |
שיטות
אלה השינויים שבוצעו ב-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/ {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} |
אלה השינויים שחלו ב-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/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | parent הוא בפורמט של accounts/ {lfpPartnerAccountId} |
אלה השינויים שבוצעו ב-methods של 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 לשותפות עם פידים של חנויות מקומיות. |