העברת ההגדרות של מודעות מלאי של חנויות מקומיות (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	אין יותר שיטה לקבל את כל הגדרות ה-LIA של כל חשבונות המשנה באופן ישיר. במקום זאת, שולחים שאילתה לכל החשבונות המשניים ומשתמשים ב-accounts.omnichannelSettings.list כדי לקבל את omnichannnelSettings של החשבונות הרלוונטיים.
	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 והסטטוס של המדיניות 'בתצוגה, למכירה בהזמנה בלבד' עבור 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	שם המשאב של חשבון 'פרופיל העסק ב-Google' פורמט: 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.