Data di pubblicazione: 15 ottobre 2025
A partire da oggi, rilasceremo una nuova versione (V2) dell'API Chrome Web Store. La nuova API è molto più facile da usare e supporta funzionalità come i service account, semplificando l'integrazione con i flussi di lavoro aziendali. Abbiamo anche aggiunto altre funzionalità con la possibilità di controllare l'implementazione percentuale e annullare a livello di programmazione gli invii in attesa.
Una nuova API basata sul feedback degli sviluppatori
La nuova API è stata creata tenendo conto del feedback degli sviluppatori. Abbiamo lavorato per rendere gli endpoint e le risposte dell'API più intuitivi.
Nuove funzionalità
Abbiamo anche aggiunto nuove funzionalità che in precedenza non erano disponibili nell'API.
Accedere allo stato degli elementi pubblicati e delle bozze
In precedenza, era possibile recuperare solo la revisione della bozza più recente di un elemento. Ora puoi recuperare sia la revisione pubblicata sia quella in attesa.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Verrà restituita una risposta che include quanto segue:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Annullare un invio in attesa
Ora puoi annullare un invio in attesa utilizzando l'API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Modificare l'implementazione percentuale
Ora puoi aggiornare la percentuale di implementazione di un'estensione senza inviarla per la revisione. Ciò si basa sul feedback degli sviluppatori, che hanno sottolineato che nella versione precedente dell'API qualsiasi aggiornamento, incluso quello alla percentuale target, sarebbe stato trattato come un nuovo invio che sarebbe stato sottoposto a revisione separatamente.
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
Assistenza per i service account
Ora puoi concedere agli account di servizio l'accesso all'API Chrome Web Store. Basta aggiungere gli indirizzi email richiesti nella Dashboard per sviluppatori.
Mettere in scena un elemento per la pubblicazione
In precedenza, le revisioni inviate tramite l'API venivano sempre pubblicate immediatamente dopo aver superato la revisione. Ora puoi utilizzare il campo publishType con STAGED_PUBLISH: quando il tuo elemento supera la revisione, viene messo in staging e può essere pubblicato manualmente in un secondo momento utilizzando un'altra chiamata API o manualmente utilizzando la dashboard per gli sviluppatori.
Ergonomia migliorata
L'API Chrome Web Store ora pubblica un documento di rilevamento. In questo modo, puoi interagire con l'API tramite vari strumenti e librerie Google. Abbiamo anche definito in modo più chiaro il concetto di revisioni degli elementi come concetto principale dell'API, il che rende l'API più facile da usare e offre maggiore flessibilità per metodi aggiuntivi in futuro.
Documentazione migliorata
Abbiamo pubblicato una documentazione di riferimento dell'API molto più completa, utilizzando gli stessi strumenti utilizzati per altre API di Google. Sono inclusi anche i suggerimenti della sezione "Prova". Esploratore API che consente di configurare una singola richiesta utilizzando le credenziali del tuo Account Google autenticato.
OAuth Playground
Ora puoi selezionare l'ambito dell'API Chrome Web Store in OAuth 2.0 Playground. In questo modo puoi ottenere le credenziali di test ed effettuare richieste API di test nel browser. Sebbene questo strumento abbia sempre supportato l'API Chrome Web Store, gli ambiti e i metodi API non venivano suggeriti automaticamente.
Librerie client Google
Questi aggiornamenti comporteranno anche la disponibilità dell'API nelle versioni future delle librerie client delle API di Google. In questo modo, sarà più facile chiamare l'API dal linguaggio che preferisci, tra cui JavaScript, Node.js, Python e Java.
Come eseguire la migrazione
La maggior parte dei metodi dell'API V1 ha un metodo equivalente nell'API V2. Aggiorna il codice in modo da utilizzare i nuovi endpoint e il nuovo formato delle richieste e per gestire le risposte aggiornate.
| Caso d'uso | Vecchio endpoint API | Nuovo endpoint API |
|---|---|---|
| Ottenere 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 |
| Aggiornare 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 |
| Pubblicare 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 |
Puoi trovare richieste di esempio nell'esercitazione Utilizzare l'API Chrome Web Store e nella documentazione completa per i nuovi metodi qui.
La nuova API non supporta la creazione di nuovi elementi. Questa funzionalità veniva utilizzata raramente e aveva un'utilità limitata, dato che i metadati aggiuntivi dovevano comunque essere forniti nella dashboard per gli sviluppatori.
Inoltre, non supportiamo più la modifica della visibilità di un elemento tramite l'API. In questo modo, lo sviluppatore conferma le modifiche alla visibilità nella dashboard dello sviluppatore.
Sequenza temporale della migrazione
Prevediamo di supportare la vecchia API fino al 15 ottobre 2026, dopodiché dovrai passare all'API V2 per continuare a effettuare richieste.
Conclusione
Siamo davvero entusiasti di condividere queste modifiche con te. Come sempre, se hai feedback, comunicacelo nella mailing list chromium-extensions.