Method: publishers.items.publish

ส่งรายการที่จะเผยแพร่ใน Store

ระบบจะส่งรายการเข้ารับการตรวจสอบ เว้นแต่จะตั้งค่า skipReview เป็น "จริง" หรือรายการได้รับการจัดเตรียมจากการส่งครั้งก่อนโดยตั้งค่า publishType เป็น STAGED_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

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" คำขอจะล้มเหลวหากมีคำเตือนระหว่างการตรวจสอบความถูกต้อง และรายละเอียดจะรวมอยู่ใน error.details มิฉะนั้น ระบบจะถือว่าคำเตือนไม่ทำให้เกิดการบล็อกและจะละเว้นคำเตือนสำหรับการตรวจสอบความถูกต้อง แต่จะรวมคำเตือนไว้ในการตอบกลับเพื่อให้ตรวจสอบ ค่าเริ่มต้นคือ false หากไม่ได้ตั้งค่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ items.publish

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
ฟิลด์
name

string

ชื่อของรายการที่ส่ง

itemId

string

เอาต์พุตเท่านั้น รหัสของสินค้า

state

enum (ItemState)

เอาต์พุตเท่านั้น สถานะปัจจุบันของการส่ง

warningInfo

object (WarningsInfo)

เอาต์พุตเท่านั้น คำเตือนที่ไม่ทำให้เกิดการบล็อกซึ่งพบระหว่างคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

PublishType

ประเภทการเผยแพร่ที่รายการนี้จะดำเนินการหากผ่านการตรวจสอบ

Enum
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

คำอธิบายของคำเตือน นักพัฒนาแอปควรใช้ข้อความนี้เพื่อทำความเข้าใจคำเตือนและดำเนินการที่เหมาะสมเพื่อแก้ไขปัญหา