Method: publishers.items.publish

Gửi mặt hàng để xuất bản trong cửa hàng.

Mặt hàng sẽ được gửi đi xem xét, trừ phi bạn đặt skipReview thành true hoặc mặt hàng được lên lịch từ một lần gửi trước đó với publishType được đặt thành STAGED_PUBLISH.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của mặt hàng ở dạng publishers/{publisherId}/items/{itemId}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Trường
publishType

enum (PublishType)

Không bắt buộc. Sử dụng chế độ này để kiểm soát việc mặt hàng có được xuất bản ngay khi được phê duyệt hay được lên lịch xuất bản trong tương lai. Mặc định là DEFAULT_PUBLISH nếu bạn không đặt.
deployInfos[]

object (DeployInfo)

Không bắt buộc. Thông tin triển khai bổ sung, bao gồm cả tỷ lệ triển khai ban đầu mong muốn. Mặc định là giá trị hiện tại được lưu trong trang tổng quan dành cho nhà phát triển nếu bạn không đặt giá trị này.
skipReview

boolean

Không bắt buộc. Có nên cố gắng bỏ qua bước xem xét mặt hàng hay không. API sẽ xác thực xem mặt hàng có đủ điều kiện hay không và trả về lỗi xác thực nếu mặt hàng cần được xem xét. Mặc định là false nếu bạn không đặt.
blockOnWarnings

boolean

Không bắt buộc. Khi được đặt thành true, yêu cầu sẽ không thành công nếu có bất kỳ cảnh báo nào trong quá trình xác thực và thông tin chi tiết sẽ được đưa vào error.details. Nếu không, các cảnh báo sẽ được coi là không chặn và sẽ bị bỏ qua để xác thực nhưng sẽ được đưa vào phản hồi để kiểm tra. Mặc định là false nếu bạn không đặt.

Nội dung phản hồi

Thông báo phản hồi cho items.publish.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Trường
name

string

Tên của mặt hàng mà bạn đã gửi
itemId

string

Chỉ có đầu ra. Mã của mặt hàng.
state

enum (ItemState)

Chỉ có đầu ra. Trạng thái hiện tại của yêu cầu gửi.
warningInfo

object (WarningsInfo)

Chỉ có đầu ra. Đã gặp phải các cảnh báo không chặn trong quá trình yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

PublishType

Loại xuất bản mà mặt hàng này sẽ tuân theo nếu vượt qua quy trình xem xét.

Enum
PUBLISH_TYPE_UNSPECIFIED Giá trị mặc định. Điều này cũng giống như DEFAULT_PUBLISH.
DEFAULT_PUBLISH Nội dung bạn gửi sẽ được xuất bản ngay sau khi được phê duyệt.
STAGED_PUBLISH Sau khi được phê duyệt, bản gửi sẽ được dàn dựng và nhà phát triển có thể xuất bản bản gửi đó.

DeployInfo

Thông tin triển khai cho một kênh phát hành cụ thể. Được dùng trong các yêu cầu cập nhật tham số triển khai.

Biểu diễn dưới dạng JSON 
{
  "deployPercentage": integer
}
Trường
deployPercentage

integer

Bắt buộc. Phần trăm triển khai hiện tại cho kênh phát hành (số không âm trong khoảng từ 0 đến 100).

WarningsInfo

Thông báo chứa thông tin chi tiết về các cảnh báo gặp phải trong quá trình items.publish.

Biểu diễn dưới dạng JSON 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Trường
warnings[]

object (Warning)

Tất cả các cảnh báo gặp phải trong yêu cầu.

Cảnh báo

Biểu thị một cảnh báo duy nhất gặp phải trong yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "reason": string,
  "description": string
}
Trường
reason

string

Lý do xuất hiện cảnh báo. Đây là một giá trị hằng số xác định nguyên nhân gần nhất gây ra cảnh báo.
description

string

Nội dung mô tả về cảnh báo. Nhà phát triển nên sử dụng thông báo này để hiểu cảnh báo và thực hiện hành động thích hợp để giải quyết vấn đề.