העברת ההגדרות של מודעות מלאי של חנויות מקומיות (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

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

OmnichannelSetting

‫Shopping Content API		‫Merchant API
שדה	סוג	שדה	סוג	תיאור
(לא רלוונטי)	(לא רלוונטי)	name	string	שם המשאב של הגדרת האומניצ'אנל הזו. פורמט: פורמט: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	חובה. קוד המדינה במאגר נתוני הלוקאל הנפוצים (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 ליצירה. אם lsfType הוא GHLSF, צריך להגדיר רק את inStock.
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 של מדיניות 'בתצוגה, למכירה בהזמנה בלבד'.
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.