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.

  Tiap-tiap 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 menyediakan aplikasi dalam versi terbatas untuk peluncuran bertahap; aplikasi ini otomatis disajikan kepada sejumlah terbatas pengguna aplikasi saja (sesuai dengan persentase peluncuran yang Anda tentukan), sehingga memungkinkan Anda men-deploy versi produksi baru aplikasi secara bertahap.

• Versi khusus bahasa dan lokalitas dari listingan aplikasi di Google Play Store

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

Catatan: Tidak semua metode yang disediakan oleh Google Play Developer API menggunakan fungsi "edit" transaksional yang baru. Metode untuk resource inappproducts, products, dan subscriptions langsung berlaku seketika, tanpa mempertimbangkan apakah ada edit yang terbuka untuk aplikasi atau tidak. Setiap halaman referensi API resource mencatat secara khusus apakah metode untuk resource tersebut menggunakan model "edit" atau tidak.

Saat Anda pertama kali membuat sebuah edit, edit tersebut adalah salinan dari aplikasi yang telah di-deploy saat ini. Anda kemudian dapat mengubah edit itu dengan memanggil metode Edit. Jika edit sudah siap, Anda harus meng-commit edit tersebut untuk menerapkan perubahannya. Anda juga dapat membatalkan edit ini kapan saja, sehingga menghapus perubahannya dan membiarkan aplikasi seperti sebelumnya.

Anda hanya dapat menggunakan API ini untuk membuat perubahan pada aplikasi yang sudah ada (yang memiliki setidaknya satu upload APK). Oleh karena itu, Anda harus mengupload setidaknya satu APK melalui Konsol Google 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 Google Play.

Perhatian: Jika ada perubahan yang dilakukan pada aplikasi melalui Konsol Google Play selagi ada edit yang berlangsung, edit Anda akan dihapus, dan perubahan yang dilakukan melalui Konsol Google Play akan diterapkan.

Alur Kerja

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

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

   Tindakan ini akan membuat edit baru dari aplikasi yang ditentukan. Semua setelan awal aplikasi--APK, listingan Google Play Store, file ekspansi, dan lain-lain--disalin dari versi aplikasi yang telah 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 Google Play Store baru yang dilokalkan dengan memanggil Edits.listings: update. Anda dapat mengubah listingan Google 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.

   Catatan: Setiap pengguna hanya dapat membuka satu edit dalam satu waktu. Jika Anda membuat edit baru, semua edit yang sudah ada yang dibuka menjadi tidak valid. Selain itu, jika ada yang memg-commit edit atau melakukan perubahan pada aplikasi melalui Konsol Google Play, semua edit lain untuk aplikasi (yang dimiliki pengguna mana pun) menjadi tidak valid. Jika Anda mencoba melakukan commit untuk edit yang tidak valid, operasinya akan menampilkan pengecualian dan tidak berpengaruh.

3. Commit edit.

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