Date de publication : 15 octobre 2025
À partir d'aujourd'hui, nous lançons une nouvelle version (V2) de l'API Chrome Web Store. La nouvelle API est beaucoup plus facile à utiliser et est compatible avec des fonctionnalités telles que les comptes de service, ce qui facilite l'intégration aux workflows d'entreprise. Nous avons également ajouté des fonctionnalités permettant de contrôler le déploiement en pourcentage et d'annuler de manière programmatique les envois en attente.
Une nouvelle API basée sur les commentaires des développeurs
La nouvelle API a été conçue en tenant compte des commentaires des développeurs. Nous avons travaillé à rendre les points de terminaison et les réponses de l'API plus intuitifs.
Nouvelles fonctionnalités
Nous avons également ajouté de nouvelles fonctionnalités qui n'étaient pas disponibles dans l'API auparavant.
Accéder à l'état des articles publiés et en brouillon
Auparavant, il n'était possible de récupérer que la révision brouillon la plus récente d'un élément. Vous pouvez désormais récupérer la révision publiée et celle en attente.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
La réponse renvoyée inclura les éléments suivants :
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Annuler un envoi en attente
Vous pouvez désormais annuler une demande en attente à l'aide de l'API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Modifier le pourcentage de déploiement
Vous pouvez désormais modifier le pourcentage de déploiement d'une extension sans l'envoyer pour examen. Cette modification est basée sur les commentaires des développeurs, qui ont souligné que dans la version précédente de l'API, toute modification, y compris du pourcentage cible, était traitée comme une nouvelle demande qui était examinée séparément.
curl -H "Authorization: Bearer $TOKEN" -X POST -H "Content-Type: application/json" -d "{ "deployPercentage": 100 }" https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:setPublishedDeployPercentage
Assistance pour les comptes de service
Vous pouvez désormais autoriser les comptes de service à accéder à l'API Chrome Web Store. Il vous suffit d'ajouter les adresses e-mail requises dans le tableau de bord du développeur.
Préparer un élément pour la publication
Auparavant, les révisions envoyées à l'aide de l'API étaient toujours publiées immédiatement après avoir été examinées. Vous pouvez désormais utiliser le champ publishType avec STAGED_PUBLISH. Lorsque votre élément est approuvé, il est mis en scène et peut être publié manuellement ultérieurement à l'aide d'un autre appel d'API ou manuellement à l'aide du tableau de bord des développeurs.
Ergonomie améliorée
L'API Chrome Web Store publie désormais un document de découverte. Cela vous permet d'interagir avec l'API à l'aide de divers outils et bibliothèques Google. Nous avons également défini plus clairement le concept de révisions d'éléments comme concept de base dans l'API, ce qui la rend plus facile à utiliser et offre plus de flexibilité pour les méthodes supplémentaires à l'avenir.
Amélioration de la documentation
Nous avons publié une documentation de référence de l'API beaucoup plus complète, en utilisant les mêmes outils que pour les autres API Google. Cela inclut également la section "Essayez-le !". L'explorateur d'API vous permet de configurer une seule requête à l'aide des identifiants de votre compte Google authentifié.
OAuth Playground
Vous pouvez désormais sélectionner le champ d'application de l'API Chrome Web Store dans OAuth 2.0 Playground. Cela vous permet d'obtenir des identifiants de test et d'envoyer des requêtes API de test dans le navigateur. Bien que cet outil ait toujours été compatible avec l'API Chrome Web Store, les niveaux d'accès et les méthodes d'API n'étaient pas suggérés automatiquement.
Bibliothèques clientes Google
Ces mises à jour signifient également que l'API sera disponible dans les prochaines versions des bibliothèques clientes des API Google. Cela vous permettra d'appeler plus facilement l'API dans le langage de votre choix, y compris JavaScript, Node.js, Python et Java.
Comment procéder ?
La plupart des méthodes de l'API V1 ont une méthode équivalente dans l'API V2. Mettez à jour votre code pour utiliser les nouveaux points de terminaison et le nouveau format de requête, et pour gérer les réponses mises à jour.
| Cas d'utilisation | Ancien point de terminaison de l'API | Nouveau point de terminaison de l'API |
|---|---|---|
| Obtenir un article | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Mettre à jour un élément | PUT https://www.googleapis.com/upload/chromewebstore/v1.1/items/itemId |
POST https://chromewebstore.googleapis.com/upload/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:upload |
| Publier un élément | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Vous trouverez des exemples de requêtes dans le tutoriel Utiliser l'API Chrome Web Store et la documentation complète pour les nouvelles méthodes.
La nouvelle API ne permet pas de créer des éléments. Cette fonctionnalité était rarement utilisée et son utilité était limitée, car des métadonnées supplémentaires devaient toujours être fournies dans le tableau de bord des développeurs.
De plus, nous ne permettons plus de modifier la visibilité d'un élément à l'aide de l'API. Cela permet de s'assurer que les modifications de visibilité sont confirmées par le développeur dans le tableau de bord des développeurs.
Calendrier de la migration
Nous prévoyons de prendre en charge l'ancienne API jusqu'au 15 octobre 2026. Vous devrez ensuite passer à l'API V2 pour continuer à envoyer des requêtes.
Conclusion
Nous sommes ravis de vous présenter ces changements. Comme toujours, si vous avez des commentaires, n'hésitez pas à nous les faire parvenir sur la liste de diffusion chromium-extensions.