Mise à jour de l’API Amazon

L’API Amazon version 4 prend fin à compter du 31 octobre. La nouvelle version, API 5.0 prend le relais avec de nouvelles fonctionnalités. Il est temps de faire la mise à jour de vos sites utilisant l’ancienne version de l’API.

Ci-dessous, vous trouverez la traduction complète de la foire aux questions disponibles en anglais sur le site officiel d’Amazon Web Services (source : https://webservices.amazon.com/paapi5/documentation/faq.html)

Qu’est-ce que PA API 5.0 ?

PA API 5.0 (PA API 5) est la dernière version de l’API Publicité Produit. Il a été mis à jour à partir de la version précédente PA API 4 pour donner accès aux informations les plus récentes sur les produits de détail. PA API 5 est disponible sur les marchés des États-Unis (US), du Canada (CA), du Mexique (MX), du Brésil (BR), du Royaume-Uni (UK), de l’Allemagne (DE), de l’Espagne (ES), de la France (FR), de l’Inde (IN), de l’Italie (IT), des Emirats arabes unis (AE), de la Turquie (TR), du Japon (JP), et d’Australie (AU). Tous les nouveaux marchés ne seront pris en charge que dans PA API 5. Référence locale pour plus de détails.

J’utilise PA API 4, pourquoi dois-je mettre à niveau vers une version plus récente de PA API ?

PA API 5 vous donne accès aux dernières fonctionnalités qui peuvent vous donner non seulement les fonctionnalités les plus importantes disponibles dans PA API 4, mais aussi les nouvelles fonctionnalités qui sont ajoutées aux produits Amazon. Ces nouvelles fonctions vous aideront à offrir de meilleures expériences d’achat à vos clients. PA API 5 a un nouveau support pour les développeurs pour s’intégrer facilement avec l’API et réduire le temps de développement de vos applications et sites. Toutes les améliorations futures du produit seront disponibles uniquement via PA API 5. Pour une liste détaillée des nouvelles fonctionnalités, veuillez consulter les questions ci-dessous et la documentation.
PA API 4 est construit sur une technologie qui est obsolète. Nous mettrons fin à l’API 4 le 31 octobre 2019. Toutes vos applications et sites utilisant PA API 4 ne fonctionneront pas comme prévu après cela. Par conséquent, il est important de mettre à niveau vers la dernière version de l’API PA.

Quelle est la valeur commerciale de la mise à niveau vers PA API 5 en tant qu’associé ?

PA API 5 est une API pour vous aider en tant qu’Associé à faire de la publicité pour vos produits et gagner des commissions en conséquence. Il vous offre les avantages suivants :

  • Augmentez votre capacité à monétiser votre site et vos messages sur les médias sociaux en vendant des produits disponibles sur Amazon via votre site, à l’aide de l’API de publicité produit Amazon (PA API 5) et du service Web.
    • Accédez aux informations sur les dernières offres et produits dans l’ensemble de la base de données produits Amazon / catalogue.
    • De nouvelles façons améliorées d’obtenir l’information la plus pertinente sur les produits pour faire de la publicité.
    • Intégration rapide et développement plus facile avec des coûts d’ingénierie réduits grâce à l’utilisation d’outils et de langages populaires.
    • Mettez à niveau à partir de l’API 4 de PA avant que le service ne soit désactivé afin d’éviter les temps d’arrêt et la perte de revenus.
  • NOUVEAU ! Accédez aux données produits les plus pertinentes disponibles sur le site de vente au détail d’Amazon : des informations sur les nouvelles offres comme Prime, Free Shipping, etc. sont disponibles via PA API 5.
  • NOUVEAU ! Découvrez les produits et les offres en utilisant les meilleurs résultats de recherche de produits pour votre recherche de contenu en filtrant pour Prime, FulfillmentByAmazon et les programmes supplémentaires.
  • AMÉLIORÉ ! Identifier les meilleurs produits pour promouvoir l’utilisation de rangs de vente plus granulaires à l’intérieur des catégories.
  • NOUVEAU ! Accédez aux marchés mondiaux en mondialisant et en régionalisant votre contenu – plusieurs devises et plusieurs langues.
  • NOUVEAU ! Trouvez plus d’informations sur les offres et promotions – PA API 5 renvoie des informations sur les nouvelles offres telles que la promotion SubscribeAndSave à prix réduit.
  • Obtenez un accès programmatique aux dernières offres de produits Amazon en utilisant des informations sur les attributs des articles, les offres, les images, les classements des ventes.
  • NOUVEAU ! Promouvoir les produits qui sont en Prime exclusive, PrimePantry, Fulfilled by Amazon programmes pour améliorer votre conversion parmi les clients Amazon.
  • NOUVEAU ! Pour les clients du monde entier, récupérez les informations sur les prix dans le format des devises et les informations sur les produits dans la langue de votre choix pour cibler les marchés mondiaux.
  • NOUVEAU ! Réduction des coûts d’intégration à l’API en utilisant les SDKs pour Java, PHP, Python et JavaScript et amélioration du traitement des données avec JSON.

Quel est l’avantage technique de la mise à niveau vers PA API 5 en tant que développeur ?

  • AMÉLIORÉ ! Identifiez les meilleurs produits pour promouvoir l’utilisation de rangs de vente plus granulaires à l’intérieur des catégories – PA API 5 retourne maintenant les informations de rang de vente pour chaque catégorie dans un format cohérent comme vous pouvez le voir sur la page produit d’Amazon. (PA API 4 n’avait qu’un seul rang.)
  • NOUVEAU ! Facilité d’intégration grâce à la prise en charge de SDK: PA API 5 inclut des SDK pour les langages de programmation courants (Java, PHP, Python et JavaScript) afin de simplifier votre intégration, de réduire la complexité du code et de faciliter l’adoption de nouvelles fonctionnalités avec un effort de développement minimal.
  • NOUVEAU ! Flexibilité du traitement des données en utilisant le format d’échange JSON qui est plus lisible, plus rapide, plus flexible dans le traitement et beaucoup plus léger.
  • NOUVEAU ! PA API 5 utilise la dernière version 4 de la signature AWS qui offre une sécurité améliorée en utilisant une clé de signature au lieu de vos clés d’accès secrètes.

Si je suis un utilisateur de PA API aujourd’hui, que dois-je faire pour passer à PA API 5 ?

Si vous utilisez PA API 4 aujourd’hui, vous pouvez passer à PA API 5 en suivant les étapes suivantes.

  • Si vous utilisez d’anciennes informations d’identification AWS migrer votre compte vers un nouveau compte PA API.
  • Obtenez de nouvelles références auprès d’Associate Central.
  • Tester l’API 5 de PA à l’aide de Tampons à gratter.
  • Mettre à jour toutes vos applications et sites pour les intégrer aux API PA API 5 en remplacement de PA API 4
  • Testez et déployez votre application nouvellement mise à niveau.
    Un guide détaillé est disponible en Guide de migration.

Cela signifie-t-il que pour mettre à niveau mon site PA API 4 vers PA API 5, je devrai mettre à jour mon site ou mon application ?

Oui, si vous utilisez déjà PA API 4, vous devrez mettre à jour votre site ou application en utilisant PA API 5 pour remplacer tous les appels PA API 4 par des API PA API 5 équivalentes. Pour votre bénéfice, nous avons fourni un tableau simple qui met en correspondance les appels d’API PA API 4 avec les appels d’API PA API 5 dans le fichier guide de migration.

Combien d’efforts et de temps seront nécessaires pour passer de l’API 4 à l’API 5 ?

L’effort et le temps requis pour la mise à niveau vers PA API 5 dépendent de la complexité de votre site ou de votre application. Nous ne pouvons pas fournir cette information avec exactitude. Nous avons constaté qu’il faut 3 ou 4 semaines pour apporter des modifications à une application typique pour passer de PA API 4 à PA API 5, le temps de test et de déploiement dépend de vos installations individuelles.
Pendant la période de mise à jour jusqu’au 31 octobre 2019, vous pouvez accéder à la fois à PA API 4 et PA API 5. Vous pouvez également nous contacter sur l’email fourni dans la FAQ.

Ai-je besoin de nouvelles informations d’identification pour accéder à PA API 5 ou puis-je utiliser les anciennes ?

Si vous avez généré des identifiants après le 30 septembre 2017, aucune action n’est requise de votre part. Si vous avez généré des informations d’identification avant le 29 septembre 2017, veuillez visiter la page de l’API PA d’Associates Central et cliquer sur le bouton « migrer maintenant » qui actualisera vos informations d’identification avec celles qui sont compatibles avec PA API 5. Assurez-vous de vous connecter avec votre compte propriétaire principal. Voir Migrer votre compte pour plus d’informations. Veuillez vous assurer de mettre à jour immédiatement tous vos fichiers de configuration et de stockage de justificatifs existants afin de continuer à utiliser l’API PA avec succès.

Je ne me souviens pas si j’ai généré de nouvelles informations d’identification. Comment puis-je savoir si j’ai d’anciens ou de nouveaux titres de compétences ?

La façon la plus simple de tester l’API PA est de consulter la page de l’API PA sur le site Associates Central. Assurez-vous de vous connecter avec votre compte propriétaire principal.

  • Veuillez utiliser PA API 5 Tampons à gratter Utilisez l’option « Démarrer la visite » pour obtenir une visite guidée du bloc-notes, si vous avez des questions, reportez-vous à la section Guide d’utilisation du bloc-notes.
  • Si vous obtenez « AccessDeniedException » avec le code « AccessDeniedAwsUsers », veuillez visiter l’onglet PA API sur le site Web d’Associates Central et migrer votre identifiant.
  • Si vous n’êtes pas au-dessus de l’exception, jouez avec l’option Tampons à gratter pour voir les fonctionnalités fournies dans PA API 5.
  • Pendant le développement de votre application, si vous souhaitez déboguer votre application, vous pouvez utiliser Scratchpad pour confirmer les réponses de l’API. Plus de détails dans la question relative à l' »aide supplémentaire ».

Puis-je utiliser les nouvelles informations d’identification pour accéder à PA API 4 ?

Oui, vous pouvez utiliser les nouvelles informations d’identification pour accéder à PA API 4 jusqu’à la fermeture de PA API 4 le 31 octobre 2019. Vous pouvez également continuer à utiliser les anciennes informations d’identification avec PA API 4 jusqu’à ce qu’elles soient disponibles. Mais plutôt que de gérer deux ensembles de justificatifs d’identité – anciens et nouveaux, vous pouvez utiliser les nouveaux justificatifs d’identité avec toutes les versions de l’API PA.

Si j’ai mis à niveau vers PA API 5, puis-je revenir à PA API 4 ?

Une fois que vous avez mis à niveau vers PA API 5, vous pouvez continuer à utiliser PA API 5 et PA API 4, ce qui vous permettra d’utiliser les deux systèmes en parallèle pour les tests pendant que vous mettez à niveau, évitant ainsi tout temps d’arrêt. Le 31 octobre 2019, nous fermerons l’API 4 de PA, après quoi vous ne pourrez plus l’utiliser. Vous pouvez continuer à utiliser PA API 5 avec les dernières informations d’identification.

Lorsque je mets à niveau vers PA API 5, les directives d’efficacité s’appliquent-elles ?

Oui, une fois que vous avez mis à niveau vers PA API 5, le même Lignes directrices et limites en matière d’efficacité énergétique s’appliquer.

Je n’ai jamais utilisé PA API. Que dois-je faire pour utiliser PA API 5 ?

Si vous vous êtes inscrit au programme Amazon Associate et que votre compte est approuvé, vous pourrez demander l’accès à l’API PA. Une fois que vous aurez obtenu les informations d’identification d’Associates Central, vous pourrez les utiliser pour appeler PA API 5. Pour plus d’informations, voir S’inscrire à l’API PA.

J’ai des questions ou des commentaires. Comment puis-je obtenir de l’aide supplémentaire ?

Si vous avez des questions ou des commentaires, vous pouvez obtenir de l’aide de l’une des façons suivantes :

  • La documentation comprend de nombreux exemples d’utilisation de PA API 5.
  • Pour les codes et messages d’erreur, voir Gestion des erreurs.
  • Pour créer des exemples de demandes et des exemples de code, voir Utilisation de la fonction Publicité produit Amazon API 5.0 Scratchpad API 5.0.
  • Vous pouvez envoyer un courriel d’aide technique à paapi5@amazon.com avec les informations suivantes.
    • Veuillez inclure votre identifiant e-mail et votre identifiant de magasin associé à votre compte d’associé.
    • Vous devriez également inclure votre exemple de demande/réponse ainsi que des captures d’écran pour référence.
    • Les courriels doivent être en anglais.

Commentaires fermés.