Edit

Metode edit Google Play Developer Publishing API memungkinkan Anda menyiapkan beberapa perubahan terhadap aplikasi Google Play, kemudian men-deploy-nya sekaligus. Anda melakukannya dengan membuat edit, yang menyimpan semua perubahan yang ingin dilakukan pada aplikasi. Edit menyimpan informasi seperti:

  • APK mana yang terkait dengan aplikasi, dan "jalur" untuk setiap APK.

    Masing-masing APK akan dikaitkan dengan satu "jalur" untuk menentukan pengguna mana yang dapat melihatnya. Dengan begitu, Anda dapat menyediakan aplikasi versi alfa dan beta untuk penguji. Selain itu, Anda dapat memberikan versi "peluncuran bertahap" rilis terbatas aplikasi; aplikasi ini otomatis ditayangkan ke pengguna aplikasi dalam jumlah terbatas (ditentukan oleh persentase peluncuran yang Anda setel), sehingga memungkinkan Anda men-deploy versi produksi baru aplikasi secara bertahap.

  • Bahasa dan versi khusus lokalitas dari listingan Google Play Store aplikasi

    Setiap versi khusus lokalitas dari listingan Play Store dapat berisi screenshot dan gambar promosi lainnya, teks deskriptif yang dilokalkan, dan sebagainya.

Saat Anda pertama kali membuat edit, edit tersebut adalah salinan status aplikasi yang di-deploy saat ini. Anda kemudian dapat mengubah edit dengan memanggil metode Edit. Jika edit sudah siap, Anda harus melakukan commit untuk edit tersebut, lalu mengaktifkan perubahan tersebut. Anda juga dapat meninggalkan hasil edit kapan saja, menghapus perubahan, dan membiarkan aplikasi seperti apa adanya.

Anda hanya dapat menggunakan API ini untuk membuat perubahan pada aplikasi yang sudah ada (yang memiliki setidaknya satu APK yang diupload). Oleh karena itu, Anda harus mengupload setidaknya satu APK melalui Konsol Play sebelum dapat menggunakan API ini. Selain itu, Anda tidak dapat menggunakan API ini untuk mengubah status aplikasi dari "dipublikasikan" menjadi "tidak dipublikasikan", atau untuk mengisi persetujuan hukum yang diperlukan untuk melakukan publikasi. Untuk memublikasikan aplikasi, Anda harus menggunakan Konsol Play.

Alur Kerja

Bagian ini menunjukkan cara umum penggunaan Metode edit Google Play Developer Publishing API untuk melakukan perubahan pada aplikasi.

  1. Buat pengeditan baru, dengan memanggil Edits: Insert dan menentukan aplikasi yang ingin diubah.

    Tindakan ini akan membuat edit baru dari aplikasi yang ditentukan. Setelan awal aplikasi--APK, listingan Play Store, file ekspansi, dan lain-lain--semuanya disalin dari versi aplikasi yang di-deploy.

  2. Ubah edit sesuai keinginan.

    Anda dapat melakukan sebagian besar perubahan yang dapat dilakukan melalui Konsol Google Play. Anda dapat melakukannya dengan memanggil metode Google Play Developer API yang sesuai, serta meneruskan ID aplikasi dan mengedit yang ingin diubah. Khususnya:

    • Anda dapat mengupload APK baru dengan memanggil Edits.apks: upload. Tindakan ini akan menempatkan APK di area penyimpanan, sehingga dapat ditetapkan ke jalur di edit ini atau edit selanjutnya.
    • Anda dapat menetapkan APK ke jalur dengan memanggil Edits.tracks: update. Anda juga dapat mengubah penetapan jalur untuk APK yang sudah ada dengan memanggil Edits.tracks: patch.
    • Anda dapat membuat listingan Play Store baru yang dilokalkan dengan memanggil Edits.listings: update. Anda dapat mengubah listingan Play Store yang sudah ada dengan memanggil Edits.listings: patch.
    • Anda dapat menambahkan atau mengubah file ekspansi dengan memanggil metode Edits.expansionfiles resource.

    Metode ini membuat perubahan pada edit yang sedang berlangsung, tetapi metode tersebut tidak mengubah versi aktif aplikasi. Anda dapat membuat perubahan lebih lanjut atau menghapus edit yang sedang berlangsung tanpa memengaruhi pengalaman pengguna.

  3. Commit edit.

    Saat Anda memanggil Edits: commit, jika tidak ada error validasi, maka semua perubahan yang ditentukan dalam resource edit akan menjadi "aktif", menggantikan status aplikasi saat ini. Perubahan ini dapat memerlukan waktu beberapa jam untuk diterapkan, sama seperti saat Anda melakukan perubahan melalui Konsol Play.