ขอแนะนำ Chrome เว็บสโตร์ API ใหม่

เผยแพร่: 15 ตุลาคม 2025

ตั้งแต่วันนี้เป็นต้นไป เราจะเปิดตัว 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 จะได้รับการเผยแพร่ทันทีหลังจากผ่านการตรวจสอบ ตอนนี้คุณสามารถใช้ฟิลด์ publishType กับ STAGED_PUBLISH ได้แล้ว เมื่อรายการผ่านการตรวจสอบ ระบบจะจัดเตรียมรายการและเผยแพร่ด้วยตนเองได้ในภายหลังโดยใช้การเรียก API อื่นหรือด้วยตนเองโดยใช้แดชบอร์ดนักพัฒนาแอป

การยศาสตร์ที่ปรับปรุงแล้ว

ตอนนี้ Chrome เว็บสโตร์ API เผยแพร่เอกสารการค้นพบแล้ว ซึ่งช่วยให้คุณโต้ตอบกับ API ผ่านเครื่องมือและไลบรารีต่างๆ ของ Google ได้ นอกจากนี้ เรายังได้กำหนดแนวคิดของการแก้ไขสินค้าให้ชัดเจนยิ่งขึ้นในฐานะแนวคิดหลักใน API ซึ่งจะช่วยให้ API ใช้งานได้ง่ายขึ้นและเพิ่มความยืดหยุ่นสำหรับวิธีการเพิ่มเติมในอนาคต

ปรับปรุงเอกสารประกอบ

เอกสารอ้างอิง API สำหรับ Chrome เว็บสโตร์ API
เอกสารอ้างอิง API สำหรับ Chrome เว็บสโตร์ API

เราได้เผยแพร่เอกสารอ้างอิง API ที่ครอบคลุมมากขึ้นโดยใช้เครื่องมือเดียวกันกับที่ใช้สำหรับ Google API อื่นๆ ซึ่งรวมถึง "ลองเลย!" ด้วย API Explorer ซึ่งช่วยให้คุณกำหนดค่าคำขอเดียวโดยใช้ข้อมูลเข้าสู่ระบบจากบัญชี Google ที่ได้รับการตรวจสอบสิทธิ์

สนามเด็กเล่น OAuth

ขอบเขตของ Chrome เว็บสโตร์ที่ไฮไลต์ใน OAuth 2.0 Playground
ขอบเขตของ Chrome เว็บสโตร์ที่ไฮไลต์ใน OAuth 2.0 Playground

ตอนนี้คุณเลือกขอบเขต API ของ Chrome เว็บสโตร์ได้แล้วใน OAuth 2.0 Playground ซึ่งจะช่วยให้คุณได้รับข้อมูลเข้าสู่ระบบที่ใช้ทดสอบและส่งคำขอ API ที่ใช้ทดสอบในเบราว์เซอร์ได้ แม้ว่าเครื่องมือนี้จะรองรับ Chrome เว็บสโตร์ API มาโดยตลอด แต่ระบบจะไม่แนะนำขอบเขตและเมธอด API โดยอัตโนมัติ

ไลบรารีของไคลเอ็นต์ Google

การอัปเดตเหล่านี้ยังหมายความว่า API จะพร้อมใช้งานในไลบรารีของไคลเอ็นต์ Google API รุ่นต่อๆ ไปด้วย ซึ่งจะช่วยให้เรียก API จากภาษาที่คุณเลือกได้ง่ายขึ้น รวมถึง JavaScript, Node.js, Python และ Java

วิธีย้ายข้อมูล

เมธอดส่วนใหญ่ใน API V1 มีเมธอดที่เทียบเท่าใน API V2 อัปเดตโค้ดเพื่อใช้ปลายทางและรูปแบบคำขอใหม่ รวมถึงจัดการการตอบกลับที่อัปเดตแล้ว

กรณีการใช้งาน ปลายทาง 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 อีกต่อไป เพื่อให้มั่นใจว่านักพัฒนาแอปได้ยืนยันการเปลี่ยนแปลงระดับการเข้าถึงในแดชบอร์ดนักพัฒนาแอปแล้ว

ไทม์ไลน์การย้ายข้อมูล

เราวางแผนที่จะรองรับ API เก่าจนถึงวันที่ 15 ตุลาคม 2026 จากนั้นคุณจะต้องเปลี่ยนไปใช้ V2 API เพื่อส่งคำขอต่อไป

สรุป

เราตื่นเต้นมากที่จะได้แชร์การเปลี่ยนแปลงเหล่านี้กับคุณ และเช่นเคย หากมีข้อเสนอแนะใดๆ โปรดแจ้งให้เราทราบในรายชื่ออีเมล chromium-extensions