Chrome 웹 스토어 API 참조

이 참조에서는 Chrome Web Store Publish API에 사용할 수 있는 메서드와 리소스 표현을 설명합니다. 각 리소스 유형에는 하나 이상의 데이터 표현과 하나 이상의 메서드가 있습니다. 구현에 관한 자세한 내용은 Chrome Web Store Publish API 사용을 참조하세요.

항목

items 리소스에 대한 자세한 내용은 리소스 표현을 참조하세요. URI는 별도로 명시되지 않는 한 https://www.googleapis.com을 기준으로 합니다.

작업 HTTP 요청 설명
받기 GET
/chromewebstore/v1.1/items/itemId 		Chrome 웹 스토어 항목을 가져옵니다. URL에 projection="DRAFT"를 제공합니다 (대소문자 구분).
삽입 POST
/upload/chromewebstore/v1.1/items 		새 항목을 삽입합니다.
publish POST
/chromewebstore/v1.1/
items/itemId/publish 		항목을 게시합니다.

선택사항인 publishTarget 쿼리 매개변수는 항목이 게시되는 방식을 지정합니다. 유효한 값은 "trustedTesters" 및 "default"입니다.
업데이트 PUT
/upload/chromewebstore/v1.1/
items/itemId

및

PUT
/items/itemId 		기존 항목을 업데이트합니다.

리소스 표현

{
  "kind": "chromewebstore#item",
  "id": string,
  "publicKey": string,
  "uploadState": string,
  "itemError": [
    (value)
  ]
}
속성 이름값설명
id문자열상품의 고유 ID입니다.
itemError[]list사람이 읽을 수 있는 작업의 세부정보입니다(영어로만 제공). 앱을 Chrome 웹 스토어에 업로드할 때도 동일한 오류 메시지가 표시됩니다.
kind문자열이 리소스를 항목으로 식별합니다. 값은 고정 문자열 "chromewebstore#item"입니다.
publicKey문자열이 항목의 공개 키입니다.
uploadState문자열연산의 상태입니다.

허용되는 값은 다음과 같습니다.
  • "FAILURE"
  • "IN_PROGRESS"
  • "NOT_FOUND"
  • "SUCCESS"

가져오기

Chrome 웹 스토어 항목을 가져옵니다. projection="DRAFT" (대소문자 구분)를 URL 매개변수로 제공합니다.

요청

HTTP 요청

GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId

매개변수

매개변수 이름값설명
경로 매개변수
itemId문자열Chrome 앱, Chrome 확장 프로그램 또는 Chrome 테마를 나타내는 고유 식별자입니다.
선택적 쿼리 매개변수
projection문자열반환할 항목 정보의 하위 집합을 결정합니다.

허용되는 값은 다음과 같습니다.
  • 'DRAFT': 현재 초안에서 추출된 정보를 반환합니다.
  • 'PUBLISHED': 게시된 항목 초안에서 추출한 정보를 반환합니다.
현재 "DRAFT"만 지원됩니다.

승인

이 요청에는 다음 범위의 승인이 필요합니다.

https://www.googleapis.com/auth/chromewebstore.readonly

위 URL은 액세스 토큰을 생성할 때 범위 매개변수로 사용됩니다. API 승인 및 인증에 대한 자세한 내용은 OAuth 2.0 문서를 참고하세요.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메서드는 응답 본문에 Items 리소스를 반환합니다.

삽입

새 item을 삽입합니다.

이 메서드는 업로드 URI를 지원하고 업로드된 미디어를 허용합니다.

요청

HTTP 요청

POST https://www.googleapis.com/upload/chromewebstore/v1.1/items

매개변수

매개변수 이름값설명
필수 쿼리 매개변수
uploadType문자열/upload URI에 대한 업로드 요청 유형입니다. 유일하게 허용되는 값은 media이며 미디어 데이터를 간단하게 업로드하는 값입니다.
선택적 쿼리 매개변수
publisherEmail문자열항목을 소유한 게시자의 이메일입니다. 기본값은 발신자의 이메일 주소입니다.

승인

이 요청에는 다음 범위의 승인이 필요합니다.

https://www.googleapis.com/auth/chromewebstore

위 URL은 액세스 토큰을 생성할 때 범위 매개변수로 사용됩니다. API 승인 및 인증에 대한 자세한 내용은 OAuth 2.0 문서를 참고하세요.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메서드는 응답 본문에 Items 리소스를 반환합니다.

게시

항목을 게시합니다. URL에 정의된 publishTarget을 제공합니다 (대소문자 구분). publishTarget = "trustedTesters" 또는 publishTarget = "default"입니다.

요청

HTTP 요청

POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish

매개변수

매개변수 이름값설명
경로 매개변수
itemId문자열게시할 항목의 ID입니다.
선택적 쿼리 매개변수
publishTarget문자열URL에 정의된 publishTarget(대소문자 구분)을 제공합니다(publishTarget="trustedTesters" 또는 publishTarget="default"). 기본값은 publishTarget="default"입니다.

요청 본문

요청 본문에서 선택적으로 다음 구조의 데이터를 제공할 수 있습니다.

JSON

{
  "target": string
}
속성 이름값설명
targetstring이 게시 작업의 게시 대상입니다. 이는 publishTarget을 URL 쿼리 매개변수로 사용하는 것과 같습니다. 문자열 값은 target="trustedTesters" 또는 target="default"일 수 있습니다. 지정하지 않을 경우 기본값은 target="default"입니다. URL 쿼리 매개변수를 사용하여 값을 지정하는 것이 좋습니다.

승인

이 요청에는 다음 범위의 승인이 필요합니다.

https://www.googleapis.com/auth/chromewebstore

위 URL은 액세스 토큰을 생성할 때 범위 매개변수로 사용됩니다. API 승인 및 인증에 대한 자세한 내용은 OAuth 2.0 문서를 참고하세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "chromewebstore#item",
  "item_id": string,
  "status": [
    string
  ],
  "statusDetail": [
    string
  ]
}
속성 이름값설명
kindstring정적 문자열 값은 항상 "chromewebstore#item"입니다.
item_idstring이 항목의 ID입니다.
status[]list이 게시 작업의 상태 코드입니다. OK, NOT_AUTHORIZED, INVALID_DEVELOPER, DEVELOPER_NO_OWNERSHIP, DEVELOPER_SUSPENDED, ITEM_NOT_FOUND, ITEM_PENDING_REVIEW, ITEM_TAKEN_DOWN, PUBLISHER_SUSPENDED 목록의 요소가 여러 개 포함될 수 있습니다.
statusDetail[]list위의 상태 코드에 관해 사람이 이해할 수 있는 자세한 설명

업데이트

기존 item을 업데이트합니다.

이 메서드는 업로드 URI를 지원하고 업로드된 미디어를 허용합니다.

요청

HTTP 요청

이 메서드는 두 개의 개별 URI를 통해 미디어 업로드 기능을 제공합니다.

  • 미디어 업로드 요청인 경우 업로드 URI:

    PUT https://www.googleapis.com/upload/chromewebstore/v1.1/items/itemId

  • 메타데이터 전용 요청인 메타데이터 URI:

    PUT https://www.googleapis.com/chromewebstore/v1.1/items/itemId

매개변수

매개변수 이름값설명
경로 매개변수
itemIdstring업로드할 항목의 ID입니다.
필수 쿼리 매개변수
uploadTypestring/upload URI에 대한 업로드 요청 유형입니다. 사용 가능한 값: media - 간단한 업로드 메타데이터 없이 미디어만 업로드합니다.

요청 본문

요청 본문에서는 메타데이터로 항목 리소스를 제공합니다.

승인

이 요청에는 다음 범위의 승인이 필요합니다.

https://www.googleapis.com/auth/chromewebstore

위 URL은 액세스 토큰을 생성할 때 범위 매개변수로 사용됩니다. API 승인 및 인증에 대한 자세한 내용은 OAuth 2.0 문서를 참고하세요.

응답

요청에 성공할 경우 이 메서드는 응답 본문에 Items 리소스를 반환합니다.