Publicado em: 15 de outubro de 2025
Hoje, estamos lançando uma nova versão (V2) da API Chrome Web Store. A nova API é muito mais fácil de usar e tem suporte a recursos como contas de serviço, o que facilita a integração com fluxos de trabalho empresariais. Também adicionamos mais funcionalidades com a capacidade de controlar a implantação de porcentagens e cancelar envios pendentes de forma programática.
Uma nova API baseada no feedback dos desenvolvedores
A nova API foi criada com foco no feedback dos desenvolvedores. Trabalhamos para tornar os endpoints e as respostas da API mais intuitivos.
Novos recursos
Também adicionamos novos recursos que não estavam disponíveis na API.
Acessar o status de itens publicados e em rascunho
Antes, só era possível recuperar a revisão de rascunho mais recente de um item. Agora é possível recuperar a revisão publicada e a pendente.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Isso vai retornar uma resposta que inclui o seguinte:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Cancelar um envio pendente
Agora é possível cancelar um envio pendente usando a API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Modificar o lançamento de porcentagem
Agora é possível atualizar a porcentagem de lançamento de uma extensão sem enviá-la para revisão. Isso se baseia no feedback dos desenvolvedores, que apontaram que, na versão anterior da API, todas as atualizações, incluindo a porcentagem de destino, seriam tratadas como um novo envio que passaria por revisão separadamente.
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
Suporte para contas de serviço
Agora você pode conceder acesso às contas de serviço à API Chrome Web Store. Basta adicionar os e-mails necessários no Painel de controle do desenvolvedor.
Preparar um item para publicação
Antes, as revisões enviadas usando a API eram sempre publicadas imediatamente após a aprovação. Agora, você pode usar o campo publishType com STAGED_PUBLISH. Quando o item for aprovado na revisão, ele será armazenado em etapas e poderá ser publicado manualmente mais tarde usando outra chamada de API ou manualmente usando o painel do desenvolvedor.
Ergonomia aprimorada
A API Chrome Web Store agora publica um documento de descoberta. Isso permite que você interaja com a API usando várias ferramentas e bibliotecas do Google. Também definimos mais claramente o conceito de revisões de itens como um conceito principal na API, o que facilita o uso e oferece mais flexibilidade para outros métodos no futuro.
Documentação aprimorada
Publicamos uma documentação de referência da API muito mais extensa, usando as mesmas ferramentas de outras APIs do Google. Isso também inclui a seção "Teste agora!" O API Explorer, que permite configurar uma única solicitação usando as credenciais da sua Conta do Google autenticada.
Playground do OAuth
Agora é possível selecionar o escopo da API Chrome Web Store no OAuth 2.0 Playground. Isso permite receber credenciais de teste e fazer solicitações de API de teste no navegador. Embora essa ferramenta sempre tenha oferecido suporte à API da Chrome Web Store, os escopos e métodos da API não eram sugeridos automaticamente.
Bibliotecas-cliente do Google
Essas atualizações também significam que a API estará disponível em versões futuras das bibliotecas de cliente das APIs do Google. Isso facilita a chamada da API na linguagem de sua escolha, incluindo JavaScript, Node.js, Python e Java.
Como migrar
A maioria dos métodos na API V1 tem um método equivalente na API V2. Atualize seu código para usar os novos endpoints e o formato de solicitação, além de processar as respostas atualizadas.
| Caso de uso | Endpoint da API antiga | Novo endpoint de API |
|---|---|---|
| Receber um item | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Atualizar um item | 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 |
| Publicar um item | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Confira exemplos de solicitações no tutorial Usar a API Chrome Web Store e a documentação completa dos novos métodos aqui.
A nova API não permite criar itens. Essa funcionalidade era pouco usada e tinha utilidade limitada, já que outros metadados ainda precisavam ser fornecidos no painel do desenvolvedor.
Além disso, não é mais possível mudar a visibilidade de um item usando a API. Isso garante que todas as mudanças de visibilidade sejam confirmadas pelo desenvolvedor no painel do desenvolvedor.
Cronograma da migração
Planejamos oferecer suporte à API antiga até 15 de outubro de 2026. Depois disso, será necessário migrar para a API V2 para continuar fazendo solicitações.
Conclusão
Estamos muito felizes em compartilhar essas mudanças com você. Como sempre, se você tiver algum feedback, entre em contato na lista de e-mails chromium-extensions.