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

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

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

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

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

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

בקשות

דומיין חדש	שם השיטה של Content API	שם השיטה של Merchant API
accounts.omnichannelSettings	liasettings.custombatch	השיטה הזו תוסר. ‫Merchant API תומך באפשרות לשלוח כמה בקשות בבת אחת.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	אין יותר שיטה לקבל את כל הגדרות המודעות עם מידע על מוצרים מקומיים עבור כל חשבונות המשנה. במקום זאת, שולחים שאילתה לכל החשבונות המשניים ומשתמשים ב-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
שדה	סוג	שדה	סוג	תיאור
(לא רלוונטי)	(לא רלוונטי)	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 (דף של חנות מקומית שמתארח באתר החנות (מלא), שמפנה לדפי מוצר עם נתוני זמינות במלאי)
(לא רלוונטי)	(לא רלוונטי)	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 והסטטוס של המדיניות 'בתצוגה, למכירה בהזמנה בלבד' עבור 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	חובה. מזהה החשבון שדרכו המוכר הזה מוכר לספק של התכונה 'השוואת מוצרים בחנויות מקומיות'
(לא רלוונטי)	(לא רלוונטי)	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}
(לא רלוונטי)	(לא רלוונטי)	regionCode	string	חובה. קוד המדינה במאגר CLDR
providerId	string	(לא רלוונטי)	(לא רלוונטי)	השדה הזה יוסר.
displayName	string	displayName	string	השם המוצג של ספק LFP

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

GbpAccount

Shopping Content API		‫Merchant API
Field	Type	שדה	סוג	תיאור
name	string	name	string	שם המשאב של חשבון 'פרופיל העסק ב-Google' פורמט: 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.