Data publikacji: 15 października 2025 r.
Od dziś udostępniamy nową wersję (V2) interfejsu Chrome Web Store API. Nowy interfejs API jest znacznie łatwiejszy w użyciu i obsługuje funkcje takie jak konta usługi, co ułatwia integrację z procesami firmowymi. Dodaliśmy też więcej funkcji, w tym możliwość kontrolowania procentowego wdrażania i programowego anulowania oczekujących zgłoszeń.
Nowy interfejs API oparty na opiniach deweloperów
Nowy interfejs API został opracowany z uwzględnieniem opinii programistów. Zadbamy o to, aby punkty końcowe interfejsu API i odpowiedzi były bardziej intuicyjne.
Nowe funkcje
Dodaliśmy też nowe funkcje, które wcześniej nie były dostępne w interfejsie API.
Dostęp do stanu opublikowanych i roboczych elementów
Wcześniej można było pobrać tylko najnowszą wersję roboczą elementu. Możesz teraz pobrać zarówno opublikowaną, jak i oczekującą wersję.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
W odpowiedzi otrzymasz m.in.:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Anulowanie oczekującego przesłania
Za pomocą interfejsu API możesz teraz anulować oczekujące przesłanie.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Zmienianie wdrożenia procentowego
Możesz teraz zaktualizować odsetek użytkowników biorących udział we wdrożeniu rozszerzenia bez przesyłania go do sprawdzenia. Wynika to z opinii deweloperów, którzy zwrócili uwagę, że w poprzedniej wersji interfejsu API wszelkie aktualizacje, w tym docelowego odsetka, były traktowane jako nowe zgłoszenie, które podlegało osobnej weryfikacji.
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
Pomoc dotycząca kont usługi
Możesz teraz przyznawać kontom usług dostęp do interfejsu Chrome Web Store API. Wystarczy, że dodasz wymagane adresy e-mail w Panelu dewelopera.
Przygotowywanie elementu do publikacji
Wcześniej zmiany przesłane za pomocą interfejsu API były zawsze publikowane natychmiast po sprawdzeniu. Teraz możesz używać pola publishType z wartością STAGED_PUBLISH – gdy Twój produkt przejdzie weryfikację, zostanie przygotowany do publikacji i będzie można go opublikować ręcznie w późniejszym czasie za pomocą innego wywołania interfejsu API lub ręcznie w Panelu dewelopera.
Ulepszona ergonomia
Interfejs Chrome Web Store API publikuje teraz dokument wykrywania. Umożliwia to interakcję z interfejsem API za pomocą różnych narzędzi i bibliotek Google. Wyraźniej zdefiniowaliśmy też pojęcie wersji produktu jako podstawową koncepcję interfejsu API, co ułatwia korzystanie z niego i zapewnia większą elastyczność w przypadku dodatkowych metod w przyszłości.
Ulepszona dokumentacja
Opublikowaliśmy znacznie obszerniejszą dokumentację referencyjną interfejsu API, korzystając z tych samych narzędzi co w przypadku innych interfejsów API Google. Obejmuje to również sekcję „Wypróbuj!”. Eksplorator interfejsu API, który umożliwia skonfigurowanie pojedynczego żądania przy użyciu danych logowania z uwierzytelnionego konta Google.
OAuth playground
W OAuth 2.0 Playground możesz teraz wybrać zakres interfejsu Chrome Web Store API. Dzięki temu możesz uzyskać dane logowania do testów i wysyłać testowe żądania API w przeglądarce. To narzędzie zawsze obsługiwało interfejs Chrome Web Store API, ale zakresy i metody interfejsu API nie były sugerowane automatycznie.
Biblioteki klienta Google
Te zmiany oznaczają też, że interfejs API będzie dostępny w przyszłych wersjach bibliotek klienta interfejsów API Google. Ułatwi to wywoływanie interfejsu API w wybranym języku, np. JavaScript, Node.js, Python czy Java.
Jak przeprowadzić migrację
Większość metod w interfejsie API w wersji 1 ma odpowiednik w interfejsie API w wersji 2. Zaktualizuj kod, aby używać nowych punktów końcowych i formatu żądania oraz obsługiwać zaktualizowane odpowiedzi.
| Przypadek użycia | Stary punkt końcowy API | Nowy punkt końcowy interfejsu API |
|---|---|---|
| Pobieranie elementu | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Aktualizowanie elementu | 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 |
| Publikowanie elementu | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Przykładowe żądania znajdziesz w samouczku Korzystanie z interfejsu Chrome Web Store API oraz w pełnej dokumentacji nowych metod.
Nowy interfejs API nie obsługuje tworzenia nowych elementów. Ta funkcja była rzadko używana i miała ograniczone zastosowanie, ponieważ dodatkowe metadane i tak trzeba było podawać w panelu dewelopera.
Nie obsługujemy już też zmiany widoczności elementu za pomocą interfejsu API. Dzięki temu deweloper może potwierdzić w Panelu dewelopera, że zmiany widoczności zostały przez niego wprowadzone.
Harmonogram migracji
Planujemy obsługę starego interfejsu API do 15 października 2026 r. Po tym terminie, aby nadal wysyłać żądania, musisz przejść na interfejs API w wersji 2.
Podsumowanie
Cieszymy się, że możemy Ci przedstawić te zmiany. Jeśli masz jakieś uwagi, daj nam znać na liście mailingowej chromium-extensions.