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

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

Les paramètres de l'API 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 omnicanal	OmnichannelSetting
Connexion à un partenaire du partenariat pour les flux en magasin pour les données d'inventaire	LfpProvider
Association à un compte de fiche d'établissement Google pour les données sur les magasins en magasin	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 requêtes et les ressources ont changé.

Demandes

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

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 de Page vitrine du magasin pour cette 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 (Uniform Resource Identifier) de la page produit en stock et état de diffusion pour cette regionCode. Définissez au moins l'un des objets inStock ou pickup dans l'API de création si vous avez choisi l'un des types MHLSF, mais ne définissez inStock que si lsfType est GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	URI de la page produit "Retrait" et état de diffusion pour ce regionCode. Définissez au moins l'un des objets inStock ou Pickup dans l'API de création 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 avec un fournisseur LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI et état de la règle "exposé et disponible sur commande" (ODO) pour ce regionCode
about	object (LiaAboutPageSettings)	about	object (About)	URI et état de la page d'informations de cette regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	État du processus de vérification de l'inventaire et coordonnées du contact pour cette 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, il ne doit pas l'être. Le service ne l'utilise que pour examiner la diffusion en stock. Le domaine de l'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 : 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 avec retrait en magasin. Obligatoire si l'objet est défini. L'API ne l'utilise que pour examiner le service 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 de la diffusion du 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 la ressource du fournisseur LFP
posExternalAccountId	string	externalAccountId	string	Obligatoire. ID du compte par lequel ce marchand est connu du fournisseur de LFP
(n/a)	(n/a)	state	enum (ReviewState.State)	Uniquement en sortie. État de la 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 de la règle "exposé et disponible sur commande".
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 le processus de vérification de l'inventaire
inventoryVerificationContactEmail	string	contactEmail	string	Obligatoire. Adresse e-mail du contact pour la procédure de 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 la 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 disparaît.
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 la 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 la fiche d'établissement. Les valeurs disponibles sont les suivantes : USER (compte personnel) BUSINESS_ACCOUNT (compte professionnel)
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 Content API for Shopping, consultez GmbAccountsGmbAccount.