Gepubliceerd: 15 oktober 2025
Vanaf vandaag brengen we een nieuwe versie (V2) van de Chrome Web Store API uit. De nieuwe API is aanzienlijk gebruiksvriendelijker en biedt ondersteuning voor functies zoals serviceaccounts, waardoor integratie met zakelijke workflows eenvoudiger is. We hebben ook meer functionaliteit toegevoegd, zoals de mogelijkheid om het uitrolpercentage te bepalen en in behandeling zijnde inzendingen programmatisch te annuleren.
Een nieuwe API gebaseerd op feedback van ontwikkelaars
De nieuwe API is ontwikkeld met feedback van ontwikkelaars als uitgangspunt. We hebben gewerkt aan het intuïtiever maken van de API-eindpunten en -reacties.
Nieuwe functies
We hebben ook nieuwe functies toegevoegd die voorheen niet beschikbaar waren in de API.
Toegang tot de status van gepubliceerde en conceptartikelen
Voorheen was het alleen mogelijk om de meest recente conceptversie van een item op te halen. Nu kunt u zowel de gepubliceerde als de in behandeling zijnde versie ophalen.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Dit zal een antwoord opleveren met daarin het volgende:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Een in behandeling zijnde indiening annuleren
U kunt nu een in behandeling zijnde indiening annuleren via de API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Wijzig percentage uitrol
U kunt nu het uitrolpercentage voor een extensie bijwerken zonder deze ter beoordeling in te dienen. Dit is gebaseerd op feedback van ontwikkelaars, die erop wezen dat in de vorige API-versie alle updates, inclusief het streefpercentage, als een nieuwe indiening werden behandeld die afzonderlijk zou worden beoordeeld.
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
Ondersteuning voor serviceaccounts
U kunt nu serviceaccounts toegang verlenen tot de Chrome Web Store API. Voeg hiervoor de vereiste e-mailadressen toe in het ontwikkelaarsdashboard.
Een item voorbereiden voor publicatie
Voorheen werden revisies die via de API werden ingediend, altijd direct na de beoordeling gepubliceerd. Nu kunt u het veld publishType gebruiken met STAGED_PUBLISH . Wanneer uw item de beoordeling heeft doorstaan, wordt het in de stage geplaatst en kan het later handmatig worden gepubliceerd via een andere API-aanroep of handmatig via het ontwikkelaarsdashboard.
Verbeterde ergonomie
De Chrome Web Store API publiceert nu een discovery-document . Hiermee kunt u met de API communiceren via verschillende Google-tools en -bibliotheken. We hebben ook het concept van itemrevisies duidelijker gedefinieerd als een kernconcept in de API, waardoor de API gebruiksvriendelijker is en er in de toekomst meer flexibiliteit ontstaat voor aanvullende methoden.
Verbeterde documentatie
We hebben veel uitgebreidere API-referentiedocumentatie gepubliceerd, met dezelfde tools die we ook voor andere Google API's gebruiken. Dit omvat ook de "Probeer het!" API-explorer, waarmee u één verzoek kunt configureren met behulp van de inloggegevens van uw geverifieerde Google-account.
OAuth-speeltuin
U kunt nu de scope van de Chrome Web Store API selecteren in de OAuth 2.0-playground . Hiermee kunt u testreferenties ophalen en test-API-verzoeken in de browser indienen. Hoewel deze tool de Chrome Web Store API altijd al ondersteunde, werden scopes en API-methoden niet automatisch voorgesteld.
Google-clientbibliotheken
Deze updates betekenen ook dat de API beschikbaar zal zijn in toekomstige releases van de Google API-clientbibliotheken . Dit maakt het gemakkelijker om de API aan te roepen vanuit uw favoriete taal, waaronder JavaScript, Node.js, Python en Java.
Hoe te migreren
De meeste methoden in de V1 API hebben een equivalente methode in de V2 API. Werk uw code bij om de nieuwe eindpunten en aanvraagindeling te gebruiken en de bijgewerkte reacties te verwerken.
| Gebruiksscenario | Oud API-eindpunt | Nieuw API-eindpunt |
|---|---|---|
| Een item verkrijgen | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId | GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Een item bijwerken | 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 |
| Een item publiceren | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish | POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
U kunt voorbeeldverzoeken vinden in de tutorial De Chrome Web Store API gebruiken en de volledige documentatie voor de nieuwe methoden vindt u hier.
De nieuwe API ondersteunt het aanmaken van nieuwe items niet. Deze functionaliteit werd zelden gebruikt en had een beperkt nut, aangezien er nog steeds aanvullende metadata in het ontwikkelaarsdashboard moest worden verstrekt.
Bovendien ondersteunen we het wijzigen van de zichtbaarheid van een item via de API niet langer. Dit om ervoor te zorgen dat eventuele zichtbaarheidswijzigingen door de ontwikkelaar worden bevestigd in het ontwikkelaarsdashboard.
Migratietijdlijn
We zijn van plan om de oude API te ondersteunen tot 15 oktober 2026. Daarna moet u overstappen op de V2 API om verzoeken te kunnen blijven doen.
Afronden
We zijn erg enthousiast om deze wijzigingen met jullie te delen. Zoals altijd: als je feedback hebt, laat het ons dan weten via de chromium-extensions -mailinglijst.