การแก้ไข

เมธอดแก้ไขของ Publishing API สำหรับนักพัฒนาแอป Google Play ช่วยให้คุณเตรียมการเปลี่ยนแปลงหลายอย่าง ในแอป Google Play แล้วจึงนำไปใช้พร้อมกันได้ คุณทำได้โดยสร้างการแก้ไข ซึ่งจะเก็บการเปลี่ยนแปลงทั้งหมดที่คุณต้องการทำกับแอป การแก้ไขจะเก็บข้อมูลต่างๆ เช่น

• APK ใดที่เชื่อมโยงกับแอป และ "แทร็ก" สำหรับ APK แต่ละรายการ

  โดยแต่ละเวอร์ชันจะเชื่อมโยงกับ "แทร็ก" ซึ่งกำหนดว่าผู้ใช้รายใดจะเห็น เวอร์ชันนั้น ซึ่งจะช่วยให้คุณสามารถให้บริการแอปเวอร์ชันอัลฟ่าและเบต้า แก่ผู้ทดสอบได้ นอกจากนี้ คุณยังสามารถระบุแอปเวอร์ชัน "การเปิดตัวแบบทีละขั้น" ที่มีการเผยแพร่แบบจำกัดได้ ซึ่งระบบจะแสดงแอปนี้ต่อผู้ใช้แอปจำนวนจำกัดโดยอัตโนมัติ (กำหนดโดยเปอร์เซ็นต์การเปิดตัวที่คุณตั้งค่าไว้) ซึ่งจะช่วยให้คุณสามารถทยอยเปิดตัวแอปเวอร์ชันที่ใช้งานจริงเวอร์ชันใหม่ได้

• เวอร์ชันเฉพาะภาษาและเฉพาะภาษาของข้อมูลแอปใน Google Play Store

  ข้อมูลผลิตภัณฑ์ใน Store แต่ละเวอร์ชันที่เฉพาะเจาะจงตามภาษาอาจมี ภาพหน้าจอและกราฟิกโปรโมตอื่นๆ ข้อความอธิบายที่แปลแล้ว และอื่นๆ

หมายเหตุ: วิธีการบางอย่างที่ Google Play Developer API มีให้ไม่ได้ใช้ฟังก์ชันการทำงาน "การแก้ไข" แบบธุรกรรมใหม่ เมธอดสำหรับทรัพยากร inappproducts, products และ subscriptions จะมีผลทันทีไม่ว่าจะมีคำขอแก้ไขที่เปิดอยู่สำหรับแอปหรือไม่ก็ตาม หน้าข้อมูลอ้างอิง API ของแต่ละทรัพยากรจะระบุโดยเฉพาะว่าเมธอดสำหรับทรัพยากรนั้นใช้โมเดล "edits" หรือไม่

เมื่อสร้างการแก้ไขเป็นครั้งแรก การแก้ไขจะเป็นสำเนาของสถานะที่ใช้งานจริงปัจจุบันของแอป จากนั้นคุณจะแก้ไขได้โดยเรียกใช้เมธอด Edits เมื่อการแก้ไขพร้อมใช้งานแล้ว ให้คอมมิตการแก้ไขนั้น เพื่อให้การเปลี่ยนแปลงมีผล นอกจากนี้ คุณยังยกเลิกการแก้ไขได้ทุกเมื่อ โดยทิ้งการเปลี่ยนแปลงและปล่อยให้แอปเป็นเหมือนเดิม

คุณใช้ API นี้เพื่อทำการเปลี่ยนแปลงกับแอปที่มีอยู่เท่านั้น (แอปที่มี APK อัปโหลดอย่างน้อย 1 รายการ) ดังนั้นคุณจะต้องอัปโหลด APK อย่างน้อย 1 รายการผ่าน Play Console ก่อนจึงจะใช้ API นี้ได้ นอกจากนี้ คุณยังใช้ API นี้เพื่อเปลี่ยนสถานะของแอป จาก "เผยแพร่แล้ว" เป็น "ยังไม่ได้เผยแพร่" หรือเพื่อกรอกความยินยอมทางกฎหมาย ที่จำเป็นสำหรับการเผยแพร่ไม่ได้ หากต้องการเผยแพร่แอป คุณต้องใช้ Play Console

ข้อควรระวัง: หากมีผู้ทำการเปลี่ยนแปลงแอปผ่าน Google Play Console ขณะที่คุณกำลังแก้ไข ระบบจะทิ้งการแก้ไขของคุณและใช้การเปลี่ยนแปลงใน Play Console แทน

ขั้นตอนการทำงาน

ส่วนนี้แสดงวิธีทั่วไปในการใช้ Publishing API สำหรับนักพัฒนาแอป Google Play เมธอด Edits เพื่อทำการแก้ไขแอป

1. สร้างการแก้ไขใหม่โดยเรียกใช้ Edits: Insert และระบุแอปที่ต้องการ แก้ไข

   ซึ่งจะสร้างการแก้ไขแอปที่ระบุใหม่ การตั้งค่าเริ่มต้นของแอป เช่น APK, ข้อมูลใน Store, ไฟล์สำหรับขยาย และอื่นๆ จะคัดลอกจากแอปเวอร์ชันที่ใช้งานจริงทั้งหมด

2. แก้ไขการตัดต่อตามต้องการ

   คุณทำการเปลี่ยนแปลงส่วนใหญ่ที่ทำผ่าน Google Play Console ได้ โดยทำได้ด้วยการเรียกเมธอด Google Play Developer API ที่เหมาะสม และส่งรหัสของแอป และการแก้ไขที่คุณต้องการแก้ไข ดังนี้

   • คุณอัปโหลด APK ใหม่ได้โดยเรียกใช้ Edits.apks: upload การดำเนินการนี้จะวาง APK ไว้ในพื้นที่เก็บข้อมูล เพื่อให้กำหนดให้กับแทร็กในการแก้ไขนี้หรือการแก้ไขครั้งถัดไปได้
   • คุณกำหนด APK ให้กับแทร็กได้โดยเรียกใช้ Edits.tracks: update นอกจากนี้ คุณยังเปลี่ยนการกำหนดแทร็ก สำหรับ APK ที่มีอยู่ได้โดยเรียกใช้ Edits.tracks: patch
   • คุณสร้างข้อมูลผลิตภัณฑ์ใน Store ที่แปลแล้วใหม่ได้โดยเรียกใช้ Edits.listings: update คุณแก้ไขข้อมูล ใน Store ที่มีอยู่ได้โดยเรียกใช้ Edits.listings: patch
   • คุณเพิ่มหรือแก้ไขไฟล์เสริมได้โดยเรียกใช้เมธอดของแหล่งข้อมูล Edits.expansionfiles

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

   หมายเหตุ: ผู้ใช้แต่ละรายจะเปิดการแก้ไขได้ครั้งละ 1 รายการเท่านั้น หากคุณสร้างการแก้ไขใหม่ ระบบจะยกเลิกการแก้ไขที่มีอยู่ซึ่งคุณอาจเปิดไว้ นอกจากนี้ หากมีผู้แก้ไขหรือเปลี่ยนแปลงแอปผ่าน Play Console การแก้ไขอื่นๆ ทั้งหมดสำหรับแอป (ซึ่งผู้ใช้คนใดก็ได้เป็นเจ้าของ) จะถือว่าไม่ถูกต้อง หากคุณพยายามแก้ไขที่ไม่ถูกต้อง การดำเนินการจะทำให้เกิดข้อยกเว้น และไม่มีผล

3. คอมมิตการแก้ไข

   เมื่อเรียกใช้ Edits: commit หากไม่มีข้อผิดพลาดในการตรวจสอบ การเปลี่ยนแปลงทั้งหมดที่ระบุใน ทรัพยากรการแก้ไขจะ "ใช้งานจริง" แทนที่สถานะปัจจุบันของ แอป การเปลี่ยนแปลงเหล่านี้อาจใช้เวลาหลายชั่วโมงจึงจะมีผล เช่นเดียวกับ เมื่อคุณทำการเปลี่ยนแปลงผ่าน Play Console