Publicado: 15 de octubre de 2025
A partir de hoy, lanzaremos una nueva versión (V2) de la API de Chrome Web Store. La nueva API es mucho más fácil de usar y admite funciones como las cuentas de servicio, lo que facilita la integración con los flujos de trabajo empresariales. También agregamos más funciones, como la capacidad de controlar el lanzamiento porcentual y cancelar de forma programática los envíos pendientes.
Una nueva API basada en los comentarios de los desarrolladores
La nueva API se creó teniendo en cuenta los comentarios de los desarrolladores. Trabajamos para que los extremos y las respuestas de la API sean más intuitivos.
Nuevas funciones
También agregamos funciones nuevas que antes no estaban disponibles en la API.
Acceder al estado de los elementos publicados y en borrador
Anteriormente, solo era posible recuperar la revisión de borrador más reciente de un elemento. Ahora puedes recuperar la revisión publicada y la pendiente.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Esto devolverá una respuesta que incluye lo siguiente:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Cómo cancelar un envío pendiente
Ahora puedes cancelar un envío pendiente con la API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Modifica el porcentaje del lanzamiento
Ahora puedes actualizar el porcentaje de lanzamiento de una extensión sin enviarla a revisión. Esto se basa en los comentarios de los desarrolladores, quienes señalaron que, en la versión anterior de la API, cualquier actualización, incluido el porcentaje objetivo, se trataría como un nuevo envío que se sometería a revisión por separado.
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
Asistencia para cuentas de servicio
Ahora puedes otorgar acceso a las cuentas de servicio a la API de Chrome Web Store. Solo tienes que agregar los correos electrónicos requeridos en el Panel del desarrollador.
Cómo preparar un elemento para su publicación
Anteriormente, las revisiones enviadas a través de la API siempre se publicaban inmediatamente después de que se aprobaban. Ahora puedes usar el campo publishType con STAGED_PUBLISH. Cuando se apruebe tu elemento, se preparará y se podrá publicar manualmente más adelante con otra llamada a la API o de forma manual con el panel para desarrolladores.
Ergonomía mejorada
La API de Chrome Web Store ahora publica un documento de descubrimiento. Esto te permite interactuar con la API a través de varias herramientas y bibliotecas de Google. También definimos con mayor claridad el concepto de revisiones de elementos como un concepto central en la API, lo que facilita su uso y desbloquea más flexibilidad para métodos adicionales en el futuro.
Se mejoró la documentación.
Publicamos documentación de referencia de la API mucho más extensa, con las mismas herramientas que se usan para otras APIs de Google. También incluye la opción "Pruébalo". Explorador de API que te permite configurar una sola solicitud con las credenciales de tu Cuenta de Google autenticada
OAuth Playground
Ahora puedes seleccionar el alcance de la API de Chrome Web Store en OAuth 2.0 Playground. Esto te permite obtener credenciales de prueba y realizar solicitudes de prueba a la API en el navegador. Si bien esta herramienta siempre admitió la API de Chrome Web Store, los permisos y los métodos de la API no se sugerían automáticamente.
Bibliotecas cliente de Google
Estas actualizaciones también significarán que la API estará disponible en futuras versiones de las bibliotecas cliente de las APIs de Google. Esto facilitará la llamada a la API desde el lenguaje que prefieras, incluidos JavaScript, Node.js, Python y Java.
Cómo realizar la migración
La mayoría de los métodos de la API de la versión 1 tienen un método equivalente en la API de la versión 2. Actualiza tu código para usar los nuevos extremos y el formato de solicitud, y para controlar las respuestas actualizadas.
| Caso de uso | Extremo de API anterior | Nuevo extremo de API |
|---|---|---|
| Cómo obtener un elemento | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Cómo actualizar un elemento | 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 |
| Cómo publicar un elemento | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Puedes encontrar ejemplos de solicitudes en el instructivo Usa la API de Chrome Web Store y la documentación completa de los nuevos métodos aquí.
La nueva API no admite la creación de elementos nuevos. Esta función se usaba poco y tenía una utilidad limitada, ya que se debían proporcionar metadatos adicionales en el panel para desarrolladores.
Además, ya no admitimos el cambio de la visibilidad de un elemento con la API. Esto es para asegurarnos de que el desarrollador confirme cualquier cambio de visibilidad en el panel para desarrolladores.
Cronograma de migración
Planeamos admitir la API anterior hasta el 15 de octubre de 2026, momento en el que deberás migrar a la API v2 para seguir realizando solicitudes.
Conclusión
Nos entusiasma compartir estos cambios contigo. Como siempre, si tienes comentarios, háznoslo saber en la lista de distribución de chromium-extensions.