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

Si vous avez utilisé les paramètres des annonces produits en magasin dans Content API, plusieurs changements importants ont été apportés à Merchant API.

Les paramètres des APM 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 (LFP) pour les données d'inventaire	LfpProvider
Association à un compte de fiche d'établissement Google pour les données des magasins physiques	GbpAccount

De plus, avec les paramètres des APM, il n'y avait qu'une seule ressource par compte, qui contenait une liste de paramètres pour chaque entité nationale. OmnichannelSettings vous permet d'associer plusieurs ressources à un compte. Chaque ressource représente les paramètres d'une entité nationale particulière.

Voici comment les demandes et les ressources ont évolué.

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 disparaît. 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 tous les paramètres des APM pour tous les sous-comptes. Interrogez plutôt tous les sous-comptes et utilisez accounts.omnichannelSettings.list pour obtenir les paramètres omnichannelSettings 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 Retrait.

OmnichannelSetting

API Shopping Content		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 ce regionCode. 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), qui fait référence aux pages produit avec disponibilité en magasin) MHLSF_FULL (page 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 produit en stock 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 définissez que 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 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 vers un fournisseur de PLS
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI et état de la page sur les conditions "exposé et disponible sur commande" (ODO) pour ce regionCode
about	object (LiaAboutPageSettings)	about	object (About)	L'URI de la page "À propos" et l'é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

API Shopping Content		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

API Shopping Content		API Merchant
Champ	Type	Champ	Type	Description
(n/a)	(n/a)	uri	string	URI de la page produit de destination. (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 être vide. Le service l'utilise uniquement pour examiner la diffusion des produits 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 des produits en stock. Les valeurs disponibles sont ACTIVE FAILED RUNNING ACTION_REQUIRED .

Pour consulter la version de Shopping Content, consultez LiaCountrySettings et LiaOmnichannelExperience.

Retrait

API Shopping Content		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 retraits. 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. Valeurs disponibles : ACTIVE FAILED RUNNING

Pour consulter la version de Shopping Content, consultez LiaCountrySettings et LiaOmnichannelExperience.

LfpLink

API Shopping Content		API Merchant
Champ	Type	Champ	Type	Description
posDataProviderId	string	lfpProvider	string	Obligatoire. Nom de ressource du fournisseur de LFP
posExternalAccountId	string	externalAccountId	string	Obligatoire. ID de 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 ressource LfpLink. Valeurs disponibles : ACTIVE RUNNING

Pour consulter la version de Shopping Content, consultez LiaPosDataProvider.

OnDisplayToOrder

API Shopping Content		API Merchant
Champ	Type	Champ	Type	Description
shippingCostPolicyUrl	string	uri	string	Obligatoire. URI de la page des règles concernant la fonctionnalité "Exposé et disponible sur commande".
status	string	state	enum (ReviewState.State)	Uniquement en sortie. État de l'URI. Valeurs possibles : ACTIVE FAILED RUNNING

Pour consulter la version du contenu de shopping, consultez LiaOnDisplayToOrderSettings.

À propos

API Shopping Content		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. Valeurs possibles : ACTIVE FAILED RUNNING

Pour consulter la version de contenu de shopping, consultez LiaAboutPageSettings.

InventoryVerification

API Shopping Content		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. Valeurs possibles : 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 le processus 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 ACTIVE RUNNING .

Pour consulter la version Contenu de shopping, consultez LiaCountrySettings et LiaInventorySettings.

LfpProvider

API Shopping Content		API Merchant
Champ	Type	Champ	Type	Description
fullName	string	name	string	Nom de ressource du fournisseur de 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 de LFP

Pour consulter la version du contenu de shopping, consultez PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Champ	Type	Description
name	string	name	string	Nom de ressource du compte de la fiche d'établissement Google : 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'ID 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 contenu de shopping, consultez GmbAccountsGmbAccount.