Migrer les paramètres des annonces produits en magasin (APM)

Si vous avez utilisé les paramètres des annonces produits en magasin dans l'API Shopping Content, plusieurs modifications importantes ont été apportées à l'API Merchant.

Les paramètres LIA appartiennent désormais à l'un des trois composants principaux, chacun ayant une ressource associée.

Composant principal	Ressource
Configuration du compte pour la diffusion omnicanale	OmnichannelSetting
Connexion à un partenaire du programme de partenariat pour les flux en magasin pour les données d'inventaire	LfpProvider
Association à un compte Fiche d'établissement Google pour les données des magasins physiques	GbpAccount

De plus, avec les paramètres des annonces produits en magasin, il n'y avait qu'une seule ressource par compte, qui contenait une liste de paramètres pour chaque entité nationale. Avec OmnichannelSettings, vous pouvez associer plusieurs ressources à un compte. Chaque ressource représente les paramètres d'une entité nationale spécifique.

Voici comment les demandes et les ressources ont changé.

Requêtes

Nouveau domaine	Nom de la méthode Content API	Nom de la méthode de l'API Merchant
accounts.omnichannelSettings	liasettings.custombatch	Cette méthode va disparaître. L'API Merchant vous permet d'envoyer plusieurs requêtes à la fois.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Il n'est plus possible d'obtenir directement les paramètres relatifs aux annonces produits en magasin pour tous les sous-comptes. Interrogez plutôt tous les sous-comptes et utilisez accounts.omnichannelSettings.list pour obtenir les omnichannelSettings pour ceux qui vous intéressent.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Cette méthode va disparaître. Utilisez plutôt accounts.omnichannelSettings.create ou accounts.omnichannelSettings.update avec un masque de mise à jour.
	liasettings.setomnichannelexperience	Cette méthode va disparaître. Utilisez plutôt accounts.omnichannelSettings.create ou accounts.omnichannelSettings.update avec un masque de mise à jour.
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

Ressources

• OmnichannelSetting
  • LsfType
  • InStock
  • Retrait
  • LfpLink
  • OnDisplayToOrder
  • À propos
  • InventoryVerification
• LfpProvider
• GbpAccount

De plus, le service se comporte différemment pour PickupType. Consultez Prise en charge.

OmnichannelSetting

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
(n/a)	(n/a)	name	string	Nom de ressource de ce paramètre omnicanal. Format : Format : accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Obligatoire. Code pays CLDR (Common Locale Data Repository) (par exemple, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obligatoire. Type Local Store Front (LSF) pour ce regionCode. Les valeurs possibles sont les suivantes : GHLSF (vitrine du magasin hébergée par Google) MHLSF_BASIC (vitrine du magasin hébergée par le marchand (version de base), qui fait référence aux pages produit avec disponibilité en magasin) MHLSF_FULL (vitrine du magasin hébergée par le marchand (version complète), qui fait référence aux pages produit avec disponibilité en magasin)
(n/a)	(n/a)	inStock	object (InStock)	URI (Universal Resource Identifier) de la page du produit en stock et état de diffusion de ce regionCode. Définissez au moins l'un des objets inStock ou pickup dans l'API Create si vous avez choisi l'un des types MHLSF, mais définissez uniquement inStock si lsfType est GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	URI de la page produit avec retrait et état de diffusion pour ce regionCode. Définissez au moins l'un des objets inStock ou Pickup dans l'API Create si vous avez choisi l'un des types MHLSF, mais ne le définissez pas lorsque GHLSF est défini comme lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Uniquement en sortie. Lien établi vers un fournisseur LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI et état de la règle "exposé et disponible sur commande" pour ce regionCode
about	object (LiaAboutPageSettings)	about	object (About)	URI de la page "À propos" et état de ce regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	État du processus de vérification de l'inventaire et coordonnées pour ce regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(n/a)	(n/a)	Utilisez lsfType et pickup (ci-dessus).

LsfType

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
lsfType	string	lsfType	enum (LsfType)	Type de page vitrine du magasin. Les valeurs possibles sont les suivantes : GHLSF (vitrine du magasin hébergée par Google) MHLSF_BASIC (page vitrine du magasin hébergée par le marchand, version de base) MHLSF_FULL (page vitrine du magasin hébergée par le marchand, version complète)

InStock

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
(n/a)	(n/a)	uri	string	URI de la page de destination du produit. Obligatoire si vous avez choisi l'un des types MHLSF. Obligatoire si l'objet est défini. Pour GHLSF, il doit être vide, mais pour MHLSF, non vide. Le service ne l'utilise que pour examiner la diffusion en stock. Le domaine de cet URI doit correspondre à la page d'accueil du marchand.
(n/a)	(n/a)	state	enum (ReviewState.State)	Uniquement en sortie. État de la diffusion en stock. Les valeurs disponibles sont les suivantes : ACTIVE FAILED RUNNING ACTION_REQUIRED

Pour consulter la version du contenu Shopping, consultez LiaCountrySettings et LiaOmnichannelExperience.

Retrait

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
(n/a)	(n/a)	uri	string	URI de la page produit pour le retrait. Obligatoire si l'objet est défini. L'API ne l'utilise que pour examiner la diffusion des points de retrait. Le domaine de cet URI doit correspondre à la page d'accueil du marchand.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Uniquement en sortie. État du service de retrait. Les valeurs disponibles sont les suivantes : ACTIVE FAILED RUNNING

Pour consulter la version du contenu Shopping, consultez LiaCountrySettings et LiaOmnichannelExperience.

LfpLink

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
posDataProviderId	string	lfpProvider	string	Obligatoire. Nom de ressource du fournisseur LFP
posExternalAccountId	string	externalAccountId	string	Obligatoire. ID de compte sous lequel ce marchand est connu du fournisseur LFP
(n/a)	(n/a)	state	enum (ReviewState.State)	Uniquement en sortie. État de LfpLink. Les valeurs disponibles sont les suivantes : ACTIVE RUNNING

Pour consulter la version du contenu Shopping, consultez LiaPosDataProvider.

OnDisplayToOrder

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
shippingCostPolicyUrl	string	uri	string	Obligatoire. URI des règles "Exposé et disponible sur commande" (EDSC).
status	string	state	enum (ReviewState.State)	Uniquement en sortie. État de l'URI. Les valeurs possibles sont les suivantes : ACTIVE FAILED RUNNING

Pour consulter la version du contenu Shopping, consultez LiaOnDisplayToOrderSettings.

À propos

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
url	string	uri	string	Obligatoire. URI de la page "À propos"
status	string	state	enum (ReviewState.State)	Uniquement en sortie. État de l'URI. Les valeurs possibles sont les suivantes : ACTIVE FAILED RUNNING

Pour consulter la version du contenu Shopping, consultez LiaAboutPageSettings.

InventoryVerification

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
status	string	state	enum (InventoryVerification.State)	Uniquement en sortie. État du processus de vérification de l'inventaire. Les valeurs possibles sont les suivantes : ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Obligatoire. Nom du contact pour la procédure de vérification de l'inventaire
inventoryVerificationContactEmail	string	contactEmail	string	Obligatoire. Adresse e-mail du contact chargé de la vérification de l'inventaire
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Uniquement en sortie. État de la validation du contact. Les valeurs possibles sont les suivantes : ACTIVE RUNNING

Pour consulter la version du contenu Shopping, consultez LiaCountrySettings et LiaInventorySettings.

LfpProvider

Content API for Shopping		API Merchant
Champ	Type	Champ	Type	Description
fullName	string	name	string	Nom de ressource du fournisseur LFP. Format : accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(n/a)	(n/a)	regionCode	string	Obligatoire. Code pays CLDR
providerId	string	(n/a)	(n/a)	Ce champ va disparaître.
displayName	string	displayName	string	Nom à afficher du fournisseur LFP

Pour consulter la version du contenu Shopping, consultez PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Champ	Type	Description
name	string	name	string	Nom de ressource du compte GBP Format : accounts/{account}/gbpAccount/{gbp_account}
(n/a)	(n/a)	gbpAccountId	string	ID de la fiche d'établissement
type	string	type	enum (GbpAccount.Type)	Type de fiche d'établissement. Les valeurs disponibles sont les suivantes : USER (compte personnel) BUSINESS_ACCOUNT (compte d'entreprise)
email	string	gbpAccountName	string	Nom de la fiche d'établissement : Pour les comptes personnels, il s'agit de l'adresse e-mail du propriétaire. Pour les comptes d'entreprise, il s'agit du nom du compte d'entreprise.
listingCount	string	listingCount	int64	Nombre de fiches associées à ce compte

Pour consulter la version de Shopping Content, consultez GmbAccountsGmbAccount.