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

אם השתמשתם בהגדרות של מודעות מלאי של חנויות מקומיות במסגרת Content API for Shopping, יש כמה שינויים חשובים ב-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 כדי לקבל את ההגדרות של omnichannel בחשבונות המעניינים.
	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
שדה	סוג	שדה	סוג	תיאור
(n/a)	(n/a)	name	string	שם המשאב של ההגדרה הזו בכל הערוצים. פורמט: פורמט: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	חובה. קוד המדינה במאגר Common Locale Data Repository‏ (CLDR) (לדוגמה, 'US')
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	חובה. הסוג Local Store Front‏ (LSF) של regionCode הזה. הערכים האפשריים כוללים: GHLSF (דף של חנות מקומית ב-Google) MHLSF_BASIC (דף של חנות מקומית באתר של המוכר (בסיסי), שמתייחס לדפי מוצרים עם נתוני זמינות במלאי) MHLSF_FULL (דף של חנות מקומית שמתארח באתר החנות (מלא), שבו מוצגים דפי מוצר עם נתוני זמינות במלאי)
(n/a)	(n/a)	inStock	object (InStock)	מזהה ה-URI (מזהה משאב אוניברסלי) של דף המוצר שנמצא במלאי וסטטוס ההצגה של regionCode הזה. אם בחרתם באחד מהסוגים MHLSF, צריך להגדיר לפחות אחד מהאובייקטים inStock או pickup ב-create API, אבל צריך להגדיר את inStock רק אם הערך של lsfType הוא GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	ה-URI של דף המוצר לאיסוף והסטטוס של הצגת המוצר ב-regionCode הזה. אם בחרתם באחד מהסוגים MHLSF, צריך להגדיר לפחות אחד מהאובייקטים inStock או Pickup ב-create API, אבל לא להגדיר אותו כש-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)	(n/a)	(n/a)	משתמשים ב-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
שדה	סוג	שדה	סוג	תיאור
(n/a)	(n/a)	uri	string	ה-URI של דף הנחיתה של המוצר. חובה אם בחרתם באחד מהסוגים של MHLSF. חובה אם האובייקט מוגדר. בשדה GHLSF, הוא חייב להיות ריק, אבל בשדה MHLSF, הוא לא יכול להיות ריק. השירות משתמש בה רק כדי לבדוק את הצגת המוצרים שזמינים במלאי. דומיין ה-URI הזה צריך להתאים לדף הבית של המוכר.
(n/a)	(n/a)	state	enum (ReviewState.State)	פלט בלבד. הסטטוס של הצגת המוצרים במלאי. הערכים הזמינים הם ACTIVE FAILED RUNNING ACTION_REQUIRED

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

איסוף

Shopping Content API		Merchant API
שדה	סוג	שדה	סוג	תיאור
(n/a)	(n/a)	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
(n/a)	(n/a)	state	enum (ReviewState.State)	פלט בלבד. הסטטוס של LfpLink. הערכים הזמינים הם: 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}
(n/a)	(n/a)	regionCode	string	חובה. קוד המדינה במאגר CLDR
providerId	string	(n/a)	(n/a)	השדה הזה ייעלם.
displayName	string	displayName	string	השם המוצג של ספק ה-LFP

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

GbpAccount

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

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