Method: publishers.items.publish

스토어에 게시할 항목을 제출합니다.

skipReview이 true로 설정되어 있거나 publishTypeSTAGED_PUBLISH로 설정된 이전 제출에서 항목이 스테이징되지 않는 한 항목이 검토를 위해 제출됩니다.

HTTP 요청

POST https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:publish

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. publishers/{publisherId}/items/{itemId} 형식의 상품 이름

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
필드
publishType

enum (PublishType)

선택사항입니다. 이 옵션을 사용하여 승인 시 항목을 즉시 게시할지 아니면 나중에 게시할지 관리합니다. 설정하지 않으면 기본값은 DEFAULT_PUBLISH입니다.

deployInfos[]

object (DeployInfo)

선택사항입니다. 원하는 초기 비율 출시를 포함한 추가 배포 정보입니다. 설정되지 않은 경우 개발자 대시보드에 저장된 현재 값으로 기본 설정됩니다.

skipReview

boolean

선택사항입니다. 상품 검토를 건너뛸지 여부입니다. API는 상품이 자격 요건을 충족하는지 확인하고 상품에 검토가 필요한 경우 검증 오류를 반환합니다. 설정하지 않으면 기본값은 false입니다.

blockOnWarnings

boolean

선택사항입니다. true로 설정하면 유효성 검사 중에 경고가 있는 경우 요청이 실패하고 세부정보가 error.details에 포함됩니다. 그렇지 않으면 경고가 차단되지 않는 것으로 처리되어 유효성 검사에서는 무시되지만 검사를 위해 응답에 포함됩니다. 설정하지 않으면 기본값은 false입니다.

응답 본문

items.publish의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
필드
name

string

제출된 항목의 이름

itemId

string

출력 전용입니다. 상품의 ID입니다.

state

enum (ItemState)

출력 전용입니다. 제출의 현재 상태입니다.

warningInfo

object (WarningsInfo)

출력 전용입니다. 요청 중에 발생한 차단되지 않는 경고입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

PublishType

이 항목이 검토를 통과하면 게시 유형이 적용됩니다.

열거형
PUBLISH_TYPE_UNSPECIFIED 기본값 이는 DEFAULT_PUBLISH와 동일합니다.
DEFAULT_PUBLISH 제출이 승인되면 즉시 게시됩니다.
STAGED_PUBLISH 승인 후 제출 항목이 스테이징되며 개발자가 게시할 수 있습니다.

DeployInfo

특정 출시 채널의 배포 정보입니다. 배포 매개변수를 업데이트하는 요청에 사용됩니다.

JSON 표현
{
  "deployPercentage": integer
}
필드
deployPercentage

integer

필수 항목입니다. 출시 채널의 현재 배포 비율입니다 (0~100 사이의 음수가 아닌 숫자).

WarningsInfo

items.publish 중에 발생한 경고에 관한 세부정보가 포함된 메시지입니다.

JSON 표현
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
필드
warnings[]

object (Warning)

요청 중에 발생한 모든 경고입니다.

경고

요청 중에 발생한 단일 경고를 나타냅니다.

JSON 표현
{
  "reason": string,
  "description": string
}
필드
reason

string

경고의 이유입니다. 경고의 근본 원인을 식별하는 상수 값입니다.

description

string

경고에 대한 설명입니다. 개발자는 이 메시지를 사용하여 경고를 이해하고 문제를 해결하기 위한 적절한 조치를 취해야 합니다.