게시일: 2025년 10월 15일
오늘부터 Chrome 웹 스토어 API의 새로운 버전 (V2)이 출시됩니다. 새 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
서비스 계정 지원
이제 Chrome 웹 스토어 API에 대한 서비스 계정 액세스 권한을 부여할 수 있습니다. 개발자 대시보드에 필요한 이메일을 추가하기만 하면 됩니다.
게시를 위해 항목 스테이징
이전에는 API를 사용하여 제출된 수정사항이 검토를 통과하면 항상 즉시 게시되었습니다. 이제 STAGED_PUBLISH와 함께 publishType 필드를 사용할 수 있습니다. 항목이 검토를 통과하면 스테이징되며 다른 API 호출을 사용하거나 개발자 대시보드를 사용하여 나중에 수동으로 게시할 수 있습니다.
인체공학적 개선
이제 Chrome 웹 스토어 API가 디스커버리 문서를 게시합니다. 이를 통해 다양한 Google 도구 및 라이브러리를 통해 API와 상호작용할 수 있습니다. 또한 API의 핵심 개념으로 항목 수정사항의 개념을 더 명확하게 정의하여 API를 더 쉽게 사용할 수 있고 향후 추가 메서드의 유연성을 높였습니다.
문서 개선
다른 Google API에 사용되는 것과 동일한 도구를 사용하여 훨씬 광범위한 API 참조 문서가 게시되었습니다. 여기에는 '직접 해보기'도 포함됩니다. 인증된 Google 계정의 사용자 인증 정보를 사용하여 단일 요청을 구성할 수 있는 API 탐색기
OAuth 플레이그라운드
이제 OAuth 2.0 플레이그라운드에서 Chrome 웹 스토어 API 범위를 선택할 수 있습니다. 이를 통해 테스트 사용자 인증 정보를 가져오고 브라우저에서 테스트 API 요청을 할 수 있습니다. 이 도구는 항상 Chrome 웹 스토어 API를 지원했지만 범위와 API 메서드는 자동으로 제안되지 않았습니다.
Google 클라이언트 라이브러리
이러한 업데이트는 향후 출시되는 Google API 클라이언트 라이브러리에서 API를 사용할 수 있다는 의미이기도 합니다. 이렇게 하면 JavaScript, Node.js, Python, Java 등 원하는 언어에서 API를 더 쉽게 호출할 수 있습니다.
마이그레이션 방법
V1 API의 대부분의 메서드에는 V2 API의 상응하는 메서드가 있습니다. 새 엔드포인트와 요청 형식을 사용하고 업데이트된 응답을 처리하도록 코드를 업데이트합니다.
| 사용 사례 | 이전 API 엔드포인트 | 새 API 엔드포인트 |
|---|---|---|
| 상품 가져오기 | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| 항목 업데이트 | 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 |
| 항목 게시 | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Chrome 웹 스토어 API 사용 튜토리얼에서 요청 예시를 확인할 수 있으며, 새로운 메서드에 관한 전체 문서는 여기에서 확인할 수 있습니다.
새 API는 새 항목 만들기를 지원하지 않습니다. 이 기능은 사용 빈도가 낮았으며 개발자 대시보드에서 추가 메타데이터를 제공해야 했으므로 유용성이 제한적이었습니다.
또한 API를 사용한 항목의 공개 상태 변경이 더 이상 지원되지 않습니다. 이는 개발자가 개발자 대시보드에서 공개 상태 변경사항을 확인하도록 하기 위한 것입니다.
이전 타임라인
2026년 10월 15일까지 이전 API를 지원할 예정이며, 그 이후에는 계속 요청하려면 V2 API로 이동해야 합니다.
마무리
이러한 변화를 여러분과 공유하게 되어 정말 기쁩니다. 언제나처럼 의견이 있으면 chromium-extensions 메일링 리스트에 알려주세요.