Ce document présente les bonnes pratiques à suivre. Pour en savoir plus, consultez les conseils sur l'amélioration des performances.
Quand utiliser l'API ?
Pour envoyer des requêtes de manière programmatique
Que vous préfériez automatiser chaque partie de votre workflow ou créer un accès direct à votre système ERP (Enterprise Resource Planning), Content API vous permet d'envoyer des mises à jour dès que votre inventaire change.
Pour recevoir un retour immédiat
Dans Content API, vous recevez instantanément une réponse à chaque requête, plutôt qu'un récapitulatif par e-mail envoyé une fois les flux de données traités. Une latence de cinq à dix secondes est attendue pour les requêtes par lot volumineuses.
Si vous modifiez fréquemment vos données produit
Avec Content API, vous pouvez effectuer des mises à jour incrémentielles plusieurs fois par jour sur votre inventaire de produits qui change rapidement, alors qu'il n'est pas possible d'envoyer l'intégralité de votre flux de données à chaque fois. Si des mises à jour sont disponibles individuellement, envoyez-les individuellement sans attendre qu'il y en ait plusieurs pour pouvoir les regrouper. De même, si des mises à jour sont disponibles par lots, envoyez-les par lots sans les diviser en requêtes individuelles.
Pour gérer plusieurs sous-comptes
Les nouveaux comptes Merchant Center sont des comptes uniques comportant leur propre ensemble de données produit. Cela fonctionne bien dans la plupart des cas, mais à mesure que votre compte se développe, vous devrez peut-être utiliser un système de gestion plus complexe pour vos produits. Si tel est votre cas, envisagez d'utiliser un multicompte (MC). La gestion d'un MC au niveau de l'API peut s'effectuer via le service Accounts, et permet d'ajouter et de gérer des sous-comptes de manière programmatique. Pour savoir comment obtenir un multicompte, consultez cette page.
Utiliser l'API
N'utilisez pas l'API de la même façon que les flux de données
Évitez de mettre à jour quotidiennement l'intégralité de votre flux de produits lorsque vous utilisez la ressource products.
Au lieu de cela, ne mettez à jour spécifiquement que les produits dont les données ont réellement changé. L'envoi de l'intégralité de votre flux de données via la ressource products nécessite plus de temps et de ressources à la fois pour Google et pour vous.
N'utilisez pas l'API pour récupérer régulièrement des informations produit que vous avez importées
Si vous êtes chargé de gérer les informations produit dans un compte Merchant Center, évitez de les demander régulièrement dans Content API via les méthodes products.get ou products.list. Pour les clients qui importent des informations, ces méthodes peuvent aider à déboguer les problèmes lors de la conception de solutions utilisant Content API. Toutefois, elles ne sont pas destinées à permettre à ces clients de récupérer régulièrement des informations sur des produits. Vous devez disposer d'une autre source pour les informations sur vos produits, comme une base de données de produits locale, et les produits dans Merchant Center doivent correspondre au contenu de cette source.
N'utilisez pas à la fois les flux de données et Content API pour envoyer vos articles
Si vous envisagez de passer à l'API pour envoyer vos articles, assurez-vous de ne plus utiliser les flux de données. Si vous utilisez les deux méthodes à la fois, des résultats inattendus peuvent se produire.
Existe-t-il une façon sûre d'utiliser à la fois l'API et les flux de données ?
Vous pouvez manipuler vos flux de données à l'aide du service Datafeed de l'API. Bien que cela facilite considérablement la gestion des flux de données à grande échelle, n'oubliez pas que vous ne devez pas insérer ni mettre à jour de produits à l'aide de l'API en même temps que des flux, car vous risqueriez d'obtenir des résultats inattendus.
Voici d'autres exemples de cas où vous pouvez utiliser l'API et les flux en même temps:
Exécuter des requêtes en lecture seule (get ou list) depuis l'API: certains marchands souhaitent utiliser l'API pour récupérer des informations et des mises à jour de l'état de leurs produits. Ce type d'utilisation est accepté, car les informations produit ne sont actualisées que par les flux.
Gérer des sous-comptes (service Accounts) et/ou les paramètres de taxes et de livraison au niveau du compte (service Accounttax et service Shippingsettings) à l'aide de l'API : Datafeeds ne fournit pas ces fonctions. L'utilisation de l'API pour gérer ces fonctions ne pose donc aucun problème.
Comment passer de l'utilisation des flux de données à celle de l'API uniquement, ou inversement ?
Si vous utilisez actuellement des flux de données et que vous souhaitez utiliser exclusivement l'API pour mettre à jour vos produits, vous devez réimporter vos données produit avec l'API. Lorsque vous mettez à jour un produit donné à l'aide du service Products, l'API prend le contrôle des informations produit. Ces informations ne sont alors plus supprimées de votre compte Merchant Center lorsque vous supprimez le produit du flux de données ou le flux de données lui-même. Si vous souhaitez supprimer le produit du flux de données ou le flux de données lui-même, assurez-vous que le flux de données n'est pas mis à jour. Sinon, le flux de données reprendra le contrôle, et la suppression du produit du flux de données entraînera la suppression du produit.
Si vous n'utilisez actuellement que l'API pour obtenir des informations sur les produits et que vous souhaitez utiliser les flux de données comme source principale d'informations sur les produits, il vous suffit d'ajouter le nouveau flux de données à votre compte Merchant Center pour qu'il devienne propriétaire des produits listés. Si vous souhaitez supprimer des produits importés uniquement à partir de l'API avant qu'ils n'expirent, vous devez les supprimer via Merchant Center ou via l'API.
Comment cibler plusieurs pays avec mes produits à l'aide de Content API for Shopping ?
Pour cibler plusieurs pays avec des annonces et des fiches sans frais pour les produits envoyés via Content API, configurez des pays supplémentaires dans le flux principal de Content API dans Merchant Center ou ajoutez ces pays via le champ shipping de la ressource products.
Vous trouverez ci-dessous un exemple de modification des paramètres du flux principal de Content API.
Pour en savoir plus, consultez Cibler plusieurs pays avec des annonces Shopping et des fiches sans frais.
Assurez-vous que vos bibliothèques clientes sont à jour
Si vous utilisez une bibliothèque cliente Google pour interagir avec Content API, veillez à utiliser le gestionnaire de packages pour le langage de programmation de votre choix et assurez-vous que la version de la bibliothèque est à jour. Pour en savoir plus, consultez le guide du développeur pour le langage de votre choix dans Exemples et bibliothèques.
Veillez à utiliser les attributs de destination pour déterminer quels produits s'affichent dans les différents programmes d'achat
Content API adopte automatiquement les paramètres par défaut de votre flux Content API tels qu'ils ont été configurés dans Merchant Center. Vous pouvez utiliser les attributs de produit includedDestinations ou excludedDestinations pour contrôler la participation au programme au niveau d'un produit dans un flux ou via Content API.
Si votre flux API a été activé dans un programme, par exemple Acheter sur Google (anciennement Shopping Actions), mais que vous souhaitez exclure certains produits, utilisez l'attribut excludedDestinations et spécifiez Shopping Actions comme valeur. Si aucune erreur n'est détectée, les paramètres de flux par défaut seront remplacés dans Merchant Center, et cet article n'apparaîtra pas dans Acheter sur Google (anciennement Shopping Actions). À l'inverse, si votre flux n'a pas été activé dans un programme (Shopping, par exemple), vous pouvez inclure des articles individuels en utilisant l'attribut includedDestinations avec la valeur Shopping_ads. L'article apparaîtra alors dans les annonces Shopping.
Pour en savoir plus sur les attributs de produit includedDestinations et excludedDestinations, consultez le Centre d'aide.
Assurez-vous de mettre à jour les articles avant qu'ils expirent
Si un article ne change pas avant d'expirer, c'est-à-dire 30 jours après la dernière mise à jour ou à la date d'expiration spécifiée si elle est antérieure, mettez-le à jour pour éviter sa désactivation. Si vous devez mettre à jour de nombreux articles, car aucun d'entre eux n'a changé ou vous ne pouvez pas savoir quand ils ont été mis à jour pour la dernière fois, ne mettez pas à jour tous les articles en même temps, mais répartissez la charge uniformément sur plusieurs jours.
Ne supprimez pas le flux Content API pour éviter que vos produits disparaissent
La première fois que vous importez un produit avec channel:online via Content API, un nouveau flux intitulé Content API apparaît dans Merchant Center. La première fois que vous importez un produit avec channel:local via Content API, un nouveau flux intitulé Content API apparaît dans Merchant Center, avec un sous-titre Produits en magasin. Assurez-vous de ne pas supprimer accidentellement le flux Content API en ligne ou en magasin. En fonction du flux que vous supprimez, les produits en ligne ou en magasin que vous avez ajoutés à Merchant Center via Content API seront supprimés.
Regroupez plusieurs requêtes envoyées au même service à l'aide de la méthode custombatch
Au lieu d'envoyer plusieurs requêtes séquentielles ou parallèles au même service, créez une seule requête custombatch contenant toutes les requêtes souhaitées. De cette façon, la latence d'envoi des requêtes au point de terminaison de l'API ne se produit qu'une seule fois pour l'appel custombatch et non pour chaque requête individuelle, ce qui est particulièrement important si vous effectuez des requêtes séquentielles.
N'envoyez pas plusieurs actualisations d'un article dans un même lot
Cette opération entraîne des résultats inattendus, car l'ordre des mises à jour est inconnu, et peut également générer une erreur de conflit.
N'envoyez pas d'actualisations pour des articles inchangés
Veillez à n'envoyer des requêtes que pour les articles nouveaux, modifiés ou supprimés, sauf si ces articles arrivent à expiration.
Utilisez des flux supplémentaires si les prix et/ou la disponibilité changent souvent
Si vous ne parvenez pas à maintenir à jour le prix, la disponibilité ou les informations sur le prix soldé d'un produit, vous pouvez envoyer des mises à jour uniquement pour ces attributs à l'aide des flux supplémentaires de la ressource products. Étant donné que les mises à jour des flux supplémentaires sont petites, vous pouvez en effectuer beaucoup plus sur une période donnée que des mises à jour complètes des produits. Vous pourrez ainsi vous assurer que les prix et la disponibilité de vos produits correspondent à ceux affichés sur vos pages de destination.
Un autre moyen de mettre à jour le prix et la disponibilité d'un produit consiste à utiliser les mises à jour automatiques des articles. Vous pouvez l'utiliser en complément des mises à jour de l'API pour éviter les incohérences entre les informations de Merchant Center et celles figurant sur les pages de destination des produits. Cependant, sachez que cette fonctionnalité est conçue pour corriger les petits problèmes de précision en termes de prix et de disponibilité des produits. Les mises à jour automatiques des articles ne vous dispensent donc pas de fournir des informations correctes via l'API.
Quand utiliser un jeton d'actualisation
Le jeton d'actualisation est renvoyé dans l'en-tête HTTP des requêtes d'autorisation. Il contient de nombreuses autres informations d'authentification, mais les développeurs l'utilisent souvent, car il évite de demander plusieurs fois à l'utilisateur de s'authentifier, car les jetons d'accès ne sont valables que 60 minutes avant d'expirer.