Google Play Developer API

Ringkasan

Konsol Google Play menyediakan serangkaian API layanan web berbasis REST yang memungkinkan Anda menjalankan fungsi publikasi, pelaporan, dan fungsi pengelolaan aplikasi lainnya secara langsung untuk aplikasi Anda.

Tidak semua developer perlu menggunakan API developer ini. Pada sebagian besar kasus, Anda dapat terus mengelola aplikasi secara langsung menggunakan Konsol Google Play. Namun, jika Anda memiliki banyak APK untuk dikelola, atau harus melacak pembelian dan langganan pengguna, API ini mungkin bermanfaat bagi Anda.

Yang disertakan

Dengan Google Play Developer API, Anda dapat berfokus pada desain dan pengembangan aplikasi, sekaligus menghemat waktu dan tenaga untuk mengelola rilis Anda, bahkan saat Anda mengembangkan ke pasar baru.

Konsol Google Play menyertakan serangkaian API yang dapat Anda gunakan untuk mengelola aplikasi:

  • Publishing API memungkinkan Anda mengupload dan memublikasikan aplikasi, serta menjalankan tugas terkait publikasi lainnya.
  • Subscriptions and In-App Purchases API memungkinkan Anda mengelola langganan dan pembelian dalam aplikasi. (Sebelumnya dikenal sebagai "Purchase Status API".)
  • Reporting API memungkinkan Anda mengambil informasi tentang kualitas aplikasi dari Android vitals.
  • Reply to Reviews API memungkinkan Anda mengambil dan membalas ulasan aplikasi.
  • Permissions API memungkinkan Anda mengotomatiskan pengelolaan izin dalam Konsol Play.
  • Play Games Services Management API memungkinkan Anda melakukan panggilan REST untuk secara terprogram mengontrol metadata yang mendasari fitur Layanan game Google Play.
  • Voided Purchases API menyediakan daftar pesanan terkait pembelian yang telah dibatalkan pengguna.

Memulai

Untuk mulai menggunakan Google Play Developer API, lihat dokumentasi memulai.

Publishing API

Publishing API memungkinkan Anda mengotomatiskan tugas rutin yang berkaitan dengan distribusi aplikasi. Publishing API menyediakan fungsi yang mirip dengan yang tersedia untuk developer melalui Konsol Play, seperti:

  • Mengupload versi baru aplikasi
  • Merilis aplikasi, dengan memindahkan APK ke berbagai jalur (alfa, beta, peluncuran bertahap, atau produksi)
  • Membuat dan mengubah listingan Google Play Store, termasuk grafik dan tekst yang dilokalkan serta screenshot multiperangkat

Tugas tersebut dijalankan menggunakan fungsi edit, yang memakai pendekatan transaksional untuk membuat perubahan. Dengan begitu, Anda dapat menggabungkan beberapa perubahan menjadi satu pengeditan draf, lalu menerapkan perubahan secara bersamaan. (Tidak ada perubahan yang akan berpengaruh hingga hasil pengeditan diterapkan.)

Praktik terbaik

  • Batasi jumlah update aplikasi. Jangan memublikasikan update alfa atau beta lebih dari sekali sehari (aplikasi produksi harus diupdate bahkan lebih jarang dari itu). Setiap update akan menghabiskan waktu dan bahkan uang pengguna Anda. Jika Anda terlalu sering mengupdate, pengguna akan mulai mengabaikan update, atau bahkan meng-uninstal produk.

Subscriptions and In-App Purchases API

Subscriptions and In-App Purchases API memungkinkan Anda mengelola katalog langganan dan produk dalam aplikasi. Selain itu, dengan Subscriptions and In-App Purchases API, Anda dapat mengambil detail pembelian apa pun dengan cepat menggunakan permintaan GET standar.

Dalam permintaan tersebut, Anda harus memberikan informasi tentang pembelian, termasuk nama paket aplikasi, ID pembelian atau langganan, dan token pembelian. Server merespons dengan objek JSON yang mendeskripsikan detail pembelian terkait, status pesanan, payload developer, dan informasi lainnya.

Anda dapat menggunakan API ini dengan beberapa cara, seperti untuk melaporkan dan merekonsiliasi tiap pesanan serta untuk memverifikasi pembelian dan masa berlaku langganan. Anda juga dapat menggunakan API ini untuk mempelajari pesanan yang dibatalkan dan mengonfirmasi apakah produk dalam aplikasi telah digunakan, termasuk apakah produk telah digunakan sebelum dibatalkan.

Praktik terbaik

  • Simpan informasi langganan pada server Anda untuk menghindari panggilan API yang tidak perlu. Jika aplikasi perlu memverifikasi langganan, Anda harus mengandalkan informasi yang di-cache pada server Anda, bukan mengulangi panggilan API ke Google.
  • Ada dua skenario yang mengharuskan server aman Anda menggunakan Google Play Developer API untuk mendapatkan informasi langganan:
    • Server Anda menerima token pembelian baru yang belum pernah dilihat.
    • Server Anda menerima notifikasi developer real-time (RTDN), yang mengindikasikan bahwa Anda perlu menggunakan token pembelian untuk mendapatkan informasi langganan yang baru.
  • Jangan melakukan polling pada API untuk status langganan secara berkala. Misalnya, jangan memanggil API setiap hari untuk memeriksa setiap langganan.
  • Karena Anda menerima RTDN saat langganan berakhir atau diperpanjang, Anda tidak perlu menjadwalkan panggilan API berdasarkan expiry time yang dijadwalkan.

Reporting API

Reporting API adalah untuk developer yang ingin membuat alur kerja otomatis selain data Konsol Play, atau developer yang menggunakan data Konsol Play untuk pelaporan dan analisis bisnis internal, kemungkinan bersama set data lainnya. Hal ini memberi Anda akses terprogram ke metrik dan data tingkat aplikasi untuk pelaporan internal, analisis, dan otomatisasi.

Reporting API menawarkan akses ke data Android vitals, termasuk rasio error, rasio ANR, masalah pengaktifan layar dan penguncian layar saat aktif, serta pelacakan tumpukan yang error.

Praktik terbaik

  • Versi Reporting API ini memiliki batas default 10 kueri per detik. Anda dapat melihat kuota pada bagian Kuota di Google Cloud Console. Jika perlu melebihi batas ini, Anda dapat mengirimkan permintaan kuota menggunakan formulir ini.

Reply to Reviews API

Reply to Reviews API memungkinkan Anda melihat masukan pengguna untuk aplikasi dan membalas masukan ini. Anda dapat menggunakan API ini untuk berinteraksi langsung dengan pengguna di toolkit dukungan pelanggan yang sudah ada, seperti sistem CRM.

Reply to Reviews API memungkinkan Anda mengakses masukan untuk versi produksi aplikasi saja. Jika Anda ingin melihat masukan terkait versi alfa atau beta aplikasi, gunakan Konsol Google Play. Selain itu, perlu diperhatikan bahwa API ini hanya menampilkan ulasan yang menyertakan komentar. Jika pengguna memberi rating aplikasi tetapi tidak memberikan komentar, masukannya tidak akan dapat diakses melalui API ini.

Permissions API

Permissions API memungkinkan developer mengotomatiskan pengelolaan izin dalam Konsol Play. Hal ini dapat memungkinkan Anda mengontrol secara fleksibel siapa saja yang memiliki akses ke akun developer Anda, tanpa melibatkannya secara manual.

Dengan Permissions API, Anda dapat melakukan fungsi administratif seperti:

  • Menghapus akses pengguna saat mereka keluar dari perusahaan Anda.
  • Memberikan akses ke aplikasi saat pengguna bergabung dengan tim yang relevan.

Voided purchases API

Voided Purchases API menyediakan daftar pesanan terkait pembelian yang telah dibatalkan pengguna. Anda dapat menggunakan informasi dari daftar ini untuk menerapkan sistem pencabutan yang mencegah pengguna mengakses produk dari pesanan tersebut.

API ini berlaku untuk pesanan dalam aplikasi satu kali dan langganan aplikasi.

Pembelian dapat dibatalkan dengan cara berikut:

  • Pengguna meminta pengembalian dana atas pesanan.
  • Pengguna membatalkan pesanan.
  • Pesanan ditagih balik.
  • Developer membatalkan atau mengembalikan dana pesanan. Catatan: hanya pesanan yang dibatalkan yang akan ditampilkan di Voided Purchases API. Jika developer mengembalikan dana tanpa mengatur opsi pembatalan, pesanan tidak akan muncul di API.
  • Google membatalkan atau mengembalikan dana pesanan.

Dengan menggunakan API ini, berarti Anda membantu menghadirkan pengalaman yang lebih seimbang dan adil bagi semua pengguna aplikasi, terutama jika aplikasi Anda adalah game.