Einstellungen für Anzeigen für lokales Inventar migrieren

Wenn Sie die Einstellungen für Anzeigen für lokales Inventar in der Shopping Content API verwendet haben, gibt es einige wichtige Änderungen bei der Merchant API.

Die LIA-Einstellungen gehören jetzt zu einer von drei Kernkomponenten, die jeweils eine zugehörige Ressource haben.

Kernkomponente Ressource
Kontokonfiguration für die Omnichannel-Bereitstellung OmnichannelSetting
Verbindung zu einem Local Feed Partnership (LFP)-Partner für Inventardaten LfpProvider
Verbindung zum Google Unternehmensprofil-Konto für Daten zu lokalen Geschäften GbpAccount

Außerdem gab es bei den Einstellungen für lokale Anzeigen eine einzelne Ressource pro Konto, die eine Liste mit Einstellungen für jede nationale Einheit enthielt. Mit OmnichannelSettings können Sie einem Konto mehrere Ressourcen zuordnen. Jede Ressource steht für die Einstellungen für ein bestimmtes Land.

So haben sich Anfragen und Ressourcen geändert.

Anfragen

Neue Domain Name der Content API-Methode Name der Merchant API-Methode
accounts.omnichannelSettings liasettings.custombatch Diese Methode wird eingestellt. Die Merchant API unterstützt die Möglichkeit, mehrere Anfragen gleichzeitig zu senden.
liasettings.get accounts.omnichannelSettings.list
liasettings.list Eine Methode zum Abrufen aller Einstellungen für lokale Inventaranzeigen für alle Unterkonten ist nicht mehr direkt verfügbar. Fragen Sie stattdessen alle Unterkonten ab und verwenden Sie accounts.omnichannelSettings.list, um die Omnichannel-Einstellungen für die gewünschten Konten abzurufen.
liasettings.update accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
liasettings.requestinventoryverification accounts.omnichannelSettings.requestInventoryVerification
liasettings.setinventoryverificationcontact Diese Methode wird eingestellt. Verwenden Sie stattdessen accounts.omnichannelSettings.create oder accounts.omnichannelSettings.update mit einer aktualisierten Maske.
liasettings.setomnichannelexperience Diese Methode wird eingestellt. Verwenden Sie stattdessen accounts.omnichannelSettings.create oder accounts.omnichannelSettings.update mit einer aktualisierten Maske.
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

Ressourcen

Außerdem verhält sich der Dienst je nach PickupType unterschiedlich. Weitere Informationen finden Sie unter Abholung.

OmnichannelSetting

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
name string Der Ressourcenname dieser Omnichannel-Einstellung. Format:
Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string Erforderlich. CLDR-Ländercode (Common Locale Data Repository), z. B. „US“
hostedLocalStorefrontActive boolean lsfType enum (LsfType) Erforderlich. Der Typ Local Store Front (LSF) für diese regionCode. Zulässige Werte:
  • GHLSF (Verkäuferseite auf Google)
  • MHLSF_BASIC (vom Händler gehostete Verkäuferseite (einfach), die sich auf Produktseiten mit Informationen zur Verfügbarkeit im Geschäft bezieht)
  • MHLSF_FULL (Vom Händler gehostete Verkäuferseite (vollständig), was sich auf Produktseiten mit Informationen zur Verfügbarkeit im Geschäft bezieht)
inStock object
(InStock)
Der URI (Universal Resource Identifier) der Produktseite für das auf Lager befindliche Produkt und der Bereitstellungsstatus für dieses regionCode. Legen Sie mindestens eines der Objekte inStock oder pickup in der Create API fest, wenn Sie einen der MHLSF-Typen ausgewählt haben. Legen Sie inStock nur fest, wenn lsfType GHLSF ist.
storePickupActive boolean pickup object
(Pickup)
Der URI der Produktseite für die Abholung und der Auslieferungsstatus für dieses regionCode. Legen Sie mindestens eines der Objekte inStock oder Pickup in der Create API fest, wenn Sie einen der MHLSF-Typen ausgewählt haben. Legen Sie es jedoch nicht fest, wenn GHLSF als lsfType festgelegt ist.
posDataProvider object
(LiaPosDataProvider)
lfpLink object
(LfpLink)
Nur Ausgabe. Die eingerichtete Verknüpfung zu einem LFP-Anbieter
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)
odo object
(OnDisplayToOrder)
Die URI und der Status der Richtlinie „Im Geschäft ausgestellt und bestellbar“ (ODO) für dieses regionCode
about object
(LiaAboutPageSettings)
about object
(About)
Der URI und der Status der „Über“-Seite für diese regionCode
inventory object
(LiaInventorySettings)
inventoryVerification object
(InventoryVerification)
Der Status der Inventarüberprüfung und die Kontaktdaten für diese regionCode
omnichannelExperience object (LiaOmnichannelExperience) Verwenden Sie lsfType und pickup (siehe oben).

LsfType

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
lsfType string lsfType enum (LsfType) Der Typ der Verkäuferseite. Mögliche Werte:
  • GHLSF (Verkäuferseite auf Google)
  • MHLSF_BASIC (einfache vom Händler gehostete Verkäuferseite)
  • MHLSF_FULL (Vom Händler gehostete Verkäuferseite (vollständig))

InStock

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
uri string URI der Produkt-Landingpage. Erforderlich, wenn Sie einen der MHLSF-Typen ausgewählt haben. Erforderlich, wenn das Objekt festgelegt ist. Für GHLSF muss es leer sein, für MHLSF nicht. Der Dienst verwendet sie nur, um die Bereitstellung von Artikeln auf Lager zu überprüfen. Die URI-Domain sollte mit der Händler-Homepage übereinstimmen.
state enum
(ReviewState.State)
Nur Ausgabe. Der Status der Auslieferung auf Lager. Verfügbare Werte sind
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

Die Version der Shopping-Inhalte finden Sie unter LiaCountrySettings und LiaOmnichannelExperience.

Abholung

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
uri string URI der Produktseite mit Abholung. Erforderlich, wenn das Objekt festgelegt ist. Die API verwendet sie nur, um die Bereitstellung von Abholungen zu prüfen. Die URI-Domain muss mit der Startseite des Händlers übereinstimmen.
LiaInventorySettings.status string state enum (ReviewState.State) Nur Ausgabe. Der Status der Abholung. Verfügbare Werte:
  • ACTIVE
  • FAILED
  • RUNNING

Die Version der Shopping-Inhalte finden Sie unter LiaCountrySettings und LiaOmnichannelExperience.

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
posDataProviderId string lfpProvider string Erforderlich. Der Ressourcenname des LFP-Anbieters
posExternalAccountId string externalAccountId string Erforderlich. Die Konto-ID, unter der dieser Händler dem LFP-Anbieter bekannt ist.
state enum (ReviewState.State) Nur Ausgabe. Der Status des LfpLink. Verfügbare Werte:
  • ACTIVE
  • RUNNING

Informationen zum Überprüfen der Version von Shopping-Inhalten finden Sie unter LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
shippingCostPolicyUrl string uri string Erforderlich. Die URI der Richtlinie „Im Geschäft ausgestellt und bestellbar“ (ODO).
status string state enum (ReviewState.State) Nur Ausgabe. Der Status des URI. Mögliche Werte sind:
  • ACTIVE
  • FAILED
  • RUNNING

Informationen zur Version der Shopping-Inhalte finden Sie unter LiaOnDisplayToOrderSettings.

Info

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
url string uri string Erforderlich. Die URI der Seite „Über uns“
status string state enum (ReviewState.State) Nur Ausgabe. Der Status des URI. Mögliche Werte sind:
  • ACTIVE
  • FAILED
  • RUNNING

Die Version der Shopping-Inhalte finden Sie unter LiaAboutPageSettings.

InventoryVerification

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
status string state enum (InventoryVerification.State) Nur Ausgabe. Der Status der Inventarüberprüfung. Mögliche Werte sind:
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
inventoryVerificationContactName string contact string Erforderlich. Der Name der Kontaktperson für die Inventarüberprüfung
inventoryVerificationContactEmail string contactEmail string Erforderlich. Die E-Mail-Adresse des Kontakts für die Inventarüberprüfung
inventoryVerificationContactStatus string contactState enum (ReviewState.State) Nur Ausgabe. Der Status der Kontaktbestätigung. Mögliche Werte sind:
  • ACTIVE
  • RUNNING

Informationen zur Version von Shopping-Inhalten finden Sie unter LiaCountrySettings und LiaInventorySettings.

LfpProvider

Shopping Content API Merchant API
Feld Typ Feld Typ Beschreibung
fullName string name string Der Ressourcenname des LFP-Anbieters.
Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
regionCode string Erforderlich. CLDR-Ländercode
providerId string Dieses Feld wird entfernt.
displayName string displayName string Der Anzeigename des LFP-Anbieters

Informationen zur Version der Shopping-Inhalte finden Sie unter PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API Merchant API
Field Type Feld Typ Beschreibung
name string name string Der Ressourcenname des GBP-Kontos
Format: accounts/{account}/gbpAccount/{gbp_account}
gbpAccountId string Die ID des Unternehmensprofils
type string type enum (GbpAccount.Type) Der Typ des Unternehmensprofils. Verfügbare Werte sind:
  • USER (privates Konto)
  • BUSINESS_ACCOUNT (Geschäftskonto)
email string gbpAccountName string Name des Unternehmensprofils:
  • Bei privaten Konten ist das die E‑Mail-ID des Inhabers.
  • Bei Geschäftskonten ist das der Name des Geschäftskontos.
listingCount string listingCount int64 Anzahl der mit diesem Konto verknüpften Einträge

Die Version der Shopping-Inhalte finden Sie unter GmbAccountsGmbAccount.