Представляем новый API Chrome Web Store

Oliver Dunk

Опубликовано: 15 октября 2025 г.

С сегодняшнего дня мы выпускаем новую версию (V2) API Chrome Web Store . Новый API значительно проще в использовании и поддерживает такие функции, как учетные записи служб, что упрощает интеграцию с корпоративными рабочими процессами. Мы также добавили больше функций, включая возможность контролировать процент развертывания и программно отменять ожидающие отправки.

Новый API, основанный на отзывах разработчиков

Новый API был разработан с учётом отзывов разработчиков. Мы постарались сделать конечные точки и ответы API более интуитивно понятными.

Новые функции

Мы также добавили новые функции, которые ранее были недоступны в API.

Доступ к статусу опубликованного и чернового элемента

Раньше можно было получить только последнюю черновую версию элемента. Теперь можно получить как опубликованную, так и ожидающую версию.

curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus

В ответ будет выведена следующая информация:

{
  ...,
  "publishedItemRevisionStatus": { ... },
  "submittedItemRevisionStatus": { ... },
  ...
}

Отменить ожидающую отправку

Теперь вы можете отменить ожидающую отправку с помощью API.

curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission

Изменить процент развертывания

Теперь вы можете обновить процент внедрения расширения, не отправляя его на проверку. Это сделано на основе отзывов разработчиков, которые отметили, что в предыдущей версии API любые изменения, включая целевой процент, рассматривались как новая заявка, которая проходила бы отдельную проверку.

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

Поддержка учетной записи службы

Теперь вы можете предоставить сервисным аккаунтам доступ к API Chrome Web Store. Просто добавьте необходимые адреса электронной почты в панели разработчика.

Подготовка материала к публикации

Раньше версии, отправленные через API, всегда публиковались сразу после прохождения проверки. Теперь вы можете использовать поле publishType с STAGED_PUBLISH : после прохождения проверки ваш элемент будет подготовлен и его можно будет опубликовать вручную позже, используя другой вызов API или панель разработчика.

Улучшенная эргономика

API Chrome Web Store теперь публикует документ Discovery . Это позволяет взаимодействовать с API через различные инструменты и библиотеки Google. Мы также более чётко определили концепцию ревизий элементов как ключевую концепцию API, что упрощает его использование и открывает большую гибкость для дополнительных методов в будущем.

Улучшенная документация

Мы опубликовали гораздо более подробную справочную документацию по API, используя тот же инструментарий, что и для других API Google. Сюда также входит API-обозреватель «Попробуйте!», позволяющий настроить один запрос, используя данные вашей аутентифицированной учётной записи Google.

Площадка OAuth

Теперь вы можете выбрать область действия API Chrome Web Store в тестовой среде OAuth 2.0 . Это позволяет получать тестовые учётные данные и выполнять тестовые запросы API в браузере. Хотя этот инструмент всегда поддерживал API Chrome Web Store, области действия и методы API не предлагались автоматически.

Клиентские библиотеки Google

Эти обновления также означают, что API будет доступен в будущих версиях клиентских библиотек Google API . Это упростит вызов API из выбранного вами языка, включая JavaScript, Node.js, Python и Java.

Как мигрировать

Большинство методов в API V1 имеют эквивалентные методы в API V2. Обновите код, чтобы использовать новые конечные точки и формат запроса, а также обрабатывать обновлённые ответы.

Примеры запросов можно найти в руководстве Использование API Chrome Web Store , а полную документацию по новым методам можно найти здесь.

Новый API не поддерживает создание новых элементов. Эта функция использовалась редко и имела ограниченную полезность, поскольку дополнительные метаданные всё равно приходилось предоставлять на панели разработчика.

Кроме того, мы больше не поддерживаем изменение видимости элемента через API. Это сделано для того, чтобы гарантировать, что любые изменения видимости будут подтверждены разработчиком на панели разработчика.

Хронология миграции

Мы планируем поддерживать старый API до 15 октября 2026 года, после чего вам потребуется перейти на API V2, чтобы продолжить делать запросы.

Заворачивать

Мы очень рады поделиться с вами этими изменениями. Как всегда, если у вас есть отзывы, дайте нам знать в рассылке chromium-extensions .