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

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

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

רכיב ליבה	משאב
הגדרת החשבון להצגת מודעות בריבוי פלטפורמות מכירה	OmnichannelSetting
חיבור לשותף Local Feed Partnership (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 כדי לקבל את omnichannelsSettings עבור החשבונות שמעניינים אתכם.
	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

בנוסף, אופן הפעולה של השירות שונה עבור מאפיין סוג האיסוף. מידע נוסף זמין במאמר בנושא איסוף.

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 ב-API ליצירה, אבל צריך להגדיר רק את inStock אם lsfType הוא GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	ה-URI של דף המוצר לאיסוף והסטטוס של הצגת המוצר הזה regionCode. אם בחרתם באחד מהסוגים MHLSF, צריך להגדיר לפחות אחד מהאובייקטים inStock או Pickup ב-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.