Google Play Developer API

ภาพรวม

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

นักพัฒนาแอปบางรายอาจไม่จำเป็นต้องใช้ Developer API เหล่านี้ โดยในกรณีส่วนใหญ่ คุณจะยังคงจัดการแอปได้โดยตรงโดยใช้ Google Play Console อย่างไรก็ตาม หากคุณมี APK จำนวนมากที่ต้องจัดการ หรือต้องติดตามการซื้อและการสมัครใช้บริการของผู้ใช้ คุณอาจพบว่า API เหล่านี้มีประโยชน์

มีอะไรให้บ้าง

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

Google Play Console มีชุด API ที่คุณใช้จัดการแอปได้ ดังนี้

  • Publishing API ช่วยให้คุณอัปโหลดและเผยแพร่แอป รวมถึงทำงานอื่นๆ ที่เกี่ยวข้องกับการเผยแพร่ได้
  • Subscriptions and In-App Purchases API ช่วยให้คุณจัดการการซื้อในแอปและการสมัครใช้บริการได้ (ก่อนหน้านี้เรียกว่า "Purchase Status API")
  • Reporting API ช่วยให้คุณดึงข้อมูลเกี่ยวกับคุณภาพของแอปจาก Android Vitals ได้
  • Reply to Reviews API ช่วยให้คุณดึงข้อมูลและตอบกลับรีวิวของแอปได้
  • Permissions API ช่วยให้คุณจัดการสิทธิ์ภายใน Play Console ได้โดยอัตโนมัติ
  • Play Games Services Management API ช่วยให้คุณออกการเรียก REST เพื่อควบคุมข้อมูลเมตาที่อยู่เบื้องหลังฟีเจอร์บริการเกมของ Google Play แบบเป็นโปรแกรมได้
  • Voided Purchases API จะแสดงรายการคำสั่งซื้อที่เชื่อมโยงกับการซื้อที่ผู้ใช้ได้ยกเลิกไป

เริ่มต้นใช้งาน

หากต้องการเริ่มต้นใช้งาน Google Play Developer API โปรดดูเอกสารประกอบการเริ่มต้นใช้งาน

Publishing API

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

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

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

แนวทางปฏิบัติแนะนำ

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

Subscriptions and In-App Purchases API

Subscriptions and In-App Purchases API ช่วยให้คุณจัดการแคตตาล็อกไอเทมที่ซื้อในแอปและการสมัครใช้บริการของแอปได้ นอกจากนี้ Subscriptions and In-App Purchases API ยังช่วยให้คุณดึงรายละเอียดการซื้อได้อย่างรวดเร็วโดยใช้คำขอ GET มาตรฐาน

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

คุณใช้ API นี้ได้หลายวิธี เช่น

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

แนวทางปฏิบัติแนะนำ

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

API การรายงาน

Reporting API มีไว้สำหรับนักพัฒนาแอปที่ต้องการสร้างเวิร์กโฟลว์อัตโนมัติโดยใช้ข้อมูลจาก Play Console หรือนักพัฒนาแอปที่ใช้ข้อมูลจาก Play Console เพื่อการรายงานและการวิเคราะห์ธุรกิจภายใน ซึ่งอาจใช้ร่วมกับชุดข้อมูลอื่นๆ ซึ่งจะให้สิทธิ์เข้าถึงข้อมูลและเมตริกระดับแอปแบบเป็นโปรแกรมสำหรับการรายงานภายใน การวิเคราะห์ และระบบอัตโนมัติ

Reporting API ให้สิทธิ์เข้าถึงข้อมูล Android Vitals ซึ่งรวมถึงอัตราการขัดข้อง, อัตรา ANR, ปัญหาการปลุกระบบและ Wake Lock ตลอดจนสแต็กเทรซของข้อผิดพลาด

แนวทางปฏิบัติแนะนำ

Reply to Reviews API

Reply to Reviews API ช่วยให้คุณดูความคิดเห็นของผู้ใช้เกี่ยวกับแอปและตอบกลับความคิดเห็นนี้ได้ คุณสามารถใช้ API นี้เพื่อโต้ตอบกับผู้ใช้โดยตรงภายในชุดเครื่องมือสนับสนุนลูกค้าที่มีอยู่ เช่น ระบบ CRM

Reply to Reviews API ช่วยให้คุณเข้าถึงความคิดเห็นสำหรับแอปเวอร์ชันที่ใช้งานจริงเท่านั้น หากต้องการดูความคิดเห็นเกี่ยวกับแอปเวอร์ชันอัลฟ่าหรือเบต้า ให้ใช้ Google Play Console แทน นอกจากนี้ โปรดทราบว่า API จะแสดงเฉพาะรีวิวที่มีความคิดเห็นเท่านั้น หากผู้ใช้ให้คะแนนแอปแต่ไม่ได้แสดงความคิดเห็น คุณจะเข้าถึงความคิดเห็นของผู้ใช้จาก API ไม่ได้

Permissions API

Permissions API ช่วยให้นักพัฒนาแอปจัดการสิทธิ์โดยอัตโนมัติภายใน Play Console ได้ ซึ่งจะช่วยให้คุณควบคุมได้อย่างยืดหยุ่นว่าใครมีสิทธิ์เข้าถึงบัญชีนักพัฒนาแอปของคุณโดยไม่ต้องดำเนินการด้วยตนเอง

Permissions API ช่วยให้คุณดำเนินการด้านการดูแลระบบได้ เช่น

  • นำสิทธิ์เข้าถึงของผู้ใช้ออกเมื่อออกจากบริษัท
  • การให้สิทธิ์เข้าถึงแอปเมื่อผู้ใช้เข้าร่วมทีมที่เกี่ยวข้อง

Voided Purchases API

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

API นี้ใช้ได้กับคำสั่งซื้อในแอปแบบครั้งเดียวและการสมัครใช้บริการแอป

การซื้อจะเป็นโมฆะได้ด้วยวิธีต่อไปนี้

  • ผู้ใช้ขอเงินคืนสำหรับคำสั่งซื้อ
  • ผู้ใช้ยกเลิกคำสั่งซื้อ
  • มีการปฏิเสธการชำระเงินสำหรับคำสั่งซื้อ
  • นักพัฒนาแอปยกเลิกหรือคืนเงินสำหรับคำสั่งซื้อ หมายเหตุ: ระบบจะแสดงเฉพาะคำสั่งซื้อที่เพิกถอนใน Voided Purchases API หากนักพัฒนาแอปคืนเงินโดยไม่ได้ตั้งค่าตัวเลือกเพิกถอน คำสั่งซื้อจะไม่ปรากฏใน API
  • Google ยกเลิกหรือคืนเงินสำหรับคำสั่งซื้อ

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