העברת ההגדרות של מודעות מלאי של חנויות מקומיות (LIA)

אם השתמשתם בהגדרות של מודעות מלאי של חנויות מקומיות ב-Shopping Content API, יש כמה שינויים חשובים ב-Merchant API.

ההגדרות של מודעות LIA שייכות עכשיו לאחד משלושה רכיבי ליבה, ולכל אחד מהם משויך משאב.

רכיב ליבה	משאב
הגדרת החשבון להצגת מודעות בכל הערוצים	OmnichannelSetting
חיבור לשותף LFP כדי לקבל נתוני מלאי	LfpProvider
קישור לחשבון פרופיל העסק ב-Google‏ (GBP) כדי לקבל נתונים על חנויות מקומיות	GbpAccount

בנוסף, בהגדרות של מודעות LIA היה משאב אחד לכל חשבון, והוא הכיל רשימה של הגדרות לכל ישות לאומית. ב-OmnichannelSettings אפשר לשייך כמה משאבים לחשבון. כל משאב מייצג את ההגדרות של ישות לאומית מסוימת.

ככה השתנו הבקשות והמשאבים.

בקשות

דומיין חדש	שם השיטה של Content API	שם השיטה של Merchant API
accounts.omnichannelSettings	liasettings.custombatch	השיטה הזו תוסר. ‫Merchant API תומך באפשרות לשלוח כמה בקשות בו-זמנית.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	אין יותר שיטה ישירה לקבלת כל ההגדרות של מודעות LIA בכל חשבונות המשנה. במקום זאת, צריך לשלוח שאילתה לכל חשבונות המשנה ולהשתמש ב-accounts.omnichannelSettings.list כדי לקבל את omnichannelSettings של החשבונות הרלוונטיים.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	השיטה הזו תוסר. במקום זאת, צריך להשתמש ב-accounts.omnichannelSettings.create או ב-accounts.omnichannelSettings.update עם מסכה מעודכנת.
	liasettings.setomnichannelexperience	השיטה הזו תוסר. במקום זאת, צריך להשתמש ב-accounts.omnichannelSettings.create או ב-accounts.omnichannelSettings.update עם מסכה מעודכנת.
accounts.omnichannelSettings.lfpProvider	liasettings.listposdataproviders	accounts.omnichannelSettings.lfpProviders.findLfpProviders
	liasettings.setposdataprovider	accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount	liasettings.getaccessiblegmbaccounts	accounts.gbpAccount.list
	liasettings.requestgmbaccess	accounts.gbpAccount.linkGbpAccount

משאבים

• OmnichannelSetting
  • LsfType
  • InStock
  • איסוף
  • LfpLink
  • OnDisplayToOrder
  • מידע כללי
  • InventoryVerification
• LfpProvider
• GbpAccount

בנוסף, השירות פועל באופן שונה עבור PickupType. איסוף

OmnichannelSetting

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
(לא רלוונטי)	(לא רלוונטי)	name	string	שם המשאב של ההגדרה הזו של כל הערוצים. פורמט: פורמט: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	חובה. קוד מדינה של מאגר הנתונים של הלוקאלים הנפוצים (CLDR) (לדוגמה, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	חובה. סוג הדף של החנות המקומית (LSF) של regionCode. הערכים האפשריים כוללים: GHLSF (דף של חנות מקומית ב-Google) MHLSF_BASIC (דף של חנות מקומית באתר של המוכר (בסיסי), שמתייחס לדפי מוצר עם נתוני זמינות במלאי) MHLSF_FULL (דף של חנות מקומית באתר של המוכר (מלא), שמתייחס לדף מוצר עם נתוני זמינות במלאי)
(לא רלוונטי)	(לא רלוונטי)	inStock	object (InStock)	ה-URI (מזהה משאבים אחיד) של דף המוצר במלאי וסטטוס ההצגה של regionCode הזה. צריך להגדיר לפחות אחד מהאובייקטים inStock או pickup ב-API ליצירה אם בחרת באחד מהסוגים של MHLSF, אבל צריך להגדיר רק את inStock אם lsfType הוא GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	ה-URI של דף המוצר לאיסוף וסטטוס ההצגה של regionCode. צריך להגדיר לפחות אחד מהאובייקטים inStock או Pickup ב-API ליצירה אם בחרתם באחד מהסוגים של MHLSF, אבל לא להגדיר אותו כש-GHLSF מוגדר בתור lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	פלט בלבד. הקישור שנוצר לספק LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	הסטטוס וכתובת ה-URI של המדיניות בנושא "בתצוגה, למכירה בהזמנה בלבד" (ODO) של regionCode
about	object (LiaAboutPageSettings)	about	object (About)	ה-URI של דף האודות והסטטוס של regionCode הזה
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	סטטוס תהליך אימות המלאי והפרטים ליצירת קשר של regionCode הזה
omnichannelExperience	object (LiaOmnichannelExperience)	(לא רלוונטי)	(לא רלוונטי)	משתמשים ב-lsfType וב-pickup (למעלה).

LsfType

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
lsfType	string	lsfType	enum (LsfType)	סוג הדף של החנות המקומית (LSF). הערכים האפשריים הם: GHLSF (דף של חנות מקומית שמתארח ב-Google) MHLSF_BASIC (דף בסיסי של חנות מקומית באתר של המוכר) MHLSF_FULL (דף של חנות מקומית באתר של המוכר – מלא)

InStock

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
(לא רלוונטי)	(לא רלוונטי)	uri	string	ה-URI של דף הנחיתה של המוצר. חובה אם בחרתם באחד מהסוגים של MHLSF. חובה אם האובייקט מוגדר. ב-GHLSF הוא צריך להיות ריק, אבל ב-MHLSF הוא לא יכול להיות ריק. השירות משתמש בו רק כדי לבדוק את הצגת המוצרים שבמלאי. הדומיין של ה-URI הזה צריך להיות זהה לדף הבית של המוכר.
(לא רלוונטי)	(לא רלוונטי)	state	enum (ReviewState.State)	פלט בלבד. סטטוס הצגת המודעות של מוצרים במלאי. הערכים האפשריים הם ACTIVE FAILED RUNNING ACTION_REQUIRED

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמרים LiaCountrySettings ו-LiaOmnichannelExperience.

איסוף

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
(לא רלוונטי)	(לא רלוונטי)	uri	string	ה-URI של דף המוצר לאיסוף. חובה אם האובייקט מוגדר. ה-API משתמש בו רק כדי לבדוק את הצגת האיסוף. הדומיין של ה-URI הזה צריך להיות זהה לדומיין של דף הבית של המוכר.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	פלט בלבד. סטטוס ההצגה של האיסוף. הערכים האפשריים הם ACTIVE FAILED RUNNING

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמרים LiaCountrySettings ו-LiaOmnichannelExperience.

LfpLink

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
posDataProviderId	string	lfpProvider	string	חובה. שם המשאב של ספק ה-LFP
posExternalAccountId	string	externalAccountId	string	חובה. מספר החשבון שבאמצעותו המוכר הזה מזוהה אצל ספק ה-LFP
(לא רלוונטי)	(לא רלוונטי)	state	enum (ReviewState.State)	פלט בלבד. הסטטוס של הקישור ל-LFP. הערכים האפשריים הם ACTIVE RUNNING

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמר LiaPosDataProvider.

OnDisplayToOrder

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
shippingCostPolicyUrl	string	uri	string	חובה. ה-URI של המדיניות בנושא "בתצוגה, למכירה בהזמנה בלבד" (ODO).
status	string	state	enum (ReviewState.State)	פלט בלבד. הסטטוס של ה-URI. הערכים האפשריים הם ACTIVE FAILED RUNNING

כדי לעיין בגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמר LiaOnDisplayToOrderSettings.

מידע כללי

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
url	string	uri	string	חובה. ה-URI של דף המידע הכללי
status	string	state	enum (ReviewState.State)	פלט בלבד. הסטטוס של ה-URI. הערכים האפשריים הם ACTIVE FAILED RUNNING

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמר LiaAboutPageSettings.

InventoryVerification

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
status	string	state	enum (InventoryVerification.State)	פלט בלבד. הסטטוס של תהליך אימות המלאי. הערכים האפשריים הם ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	חובה. שם איש הקשר לתהליך אימות המלאי
inventoryVerificationContactEmail	string	contactEmail	string	חובה. כתובת האימייל של איש הקשר לתהליך אימות המלאי
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	פלט בלבד. סטטוס האימות של איש הקשר. הערכים האפשריים הם ACTIVE RUNNING

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמרים LiaCountrySettings ו-LiaInventorySettings.

LfpProvider

‫Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
fullName	string	name	string	שם המשאב של ספק ה-LFP. פורמט: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(לא רלוונטי)	(לא רלוונטי)	regionCode	string	חובה. קוד המדינה במאגר CLDR
providerId	string	(לא רלוונטי)	(לא רלוונטי)	השדה הזה יוסר.
displayName	string	displayName	string	השם המוצג של ספק ה-LFP

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמר PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		Merchant API
Field	Type	שדה	סוג	תיאור
name	string	name	string	שם המשאב של חשבון GBP פורמט: accounts/{account}/gbpAccount/{gbp_account}
(לא רלוונטי)	(לא רלוונטי)	gbpAccountId	string	המזהה של פרופיל העסק
type	string	type	enum (GbpAccount.Type)	סוג פרופיל העסק. הערכים האפשריים הם USER (חשבון אישי) BUSINESS_ACCOUNT (חשבון עסקי)
email	string	gbpAccountName	string	השם של פרופיל העסק: בחשבונות אישיים, זהו מזהה האימייל של הבעלים. בחשבונות עסקיים, זה השם של החשבון העסקי.
listingCount	string	listingCount	int64	מספר כרטיסי המוצר שמשויכים לחשבון הזה

כדי לבדוק את הגרסה של תוכן לשיווק מוצרים, אפשר לעיין במאמר GmbAccountsGmbAccount.