OemSystemUpdateClient

public interface OemSystemUpdateClient


Klien untuk aplikasi OEM berinteraksi dengan Android Management API terkait update sistem Over-the-Air (OTA).

Memungkinkan klien OTA mengambil petunjuk yang ditentukan kebijakan dan melaporkan status terkait update sistem.

Panggilan menggunakan klien ini dilakukan dari klien OTA ke komponen di perangkat Android Management API.

Ringkasan

Metode publik

abstract @NonNull SystemUpdate

Menyediakan resource SystemUpdate baru untuk AMAPI.

abstract @NonNull ListenableFuture<@NonNull SystemUpdate>

Menyediakan resource SystemUpdate baru untuk AMAPI.

abstract @NonNull SystemUpdate

Mengambil resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

abstract @NonNull ListenableFuture<@NonNull SystemUpdate>

Mengambil resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

abstract @NonNull UpdateControlState

Mendapatkan status kontrol update sistem saat ini.

abstract @NonNull ListenableFuture<@NonNull UpdateControlState>

Mendapatkan status kontrol update sistem saat ini.

abstract @NonNull ListSystemUpdatesResponse

Mengambil daftar semua resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

abstract @NonNull ListenableFuture<@NonNull ListSystemUpdatesResponse>

Mengambil daftar semua resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

abstract @NonNull ReportSystemUpdateAbortedResponse

Melaporkan bahwa update sistem telah dibatalkan.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponse>

Melaporkan bahwa update sistem telah dibatalkan.

abstract @NonNull ReportSystemUpdateAppliedResponse

Melaporkan bahwa update sistem telah berhasil diterapkan.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponse>

Melaporkan bahwa update sistem telah berhasil diterapkan.

abstract @NonNull ReportSystemUpdateAppliedWithOverrideResponse

Melaporkan bahwa update sistem telah diterapkan, menggantikan petunjuk AMAPI.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponse>

Melaporkan bahwa update sistem telah diterapkan, menggantikan petunjuk AMAPI.

abstract @NonNull ReportSystemUpdateApplyPreventedResponse

Melaporkan bahwa penerapan update sistem dicegah.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponse>

Melaporkan bahwa penerapan update sistem dicegah.

abstract @NonNull ReportSystemUpdateDownloadPreventedResponse

Melaporkan bahwa download update sistem dicegah.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponse>

Melaporkan bahwa download update sistem dicegah.

abstract @NonNull ReportSystemUpdateDownloadedResponse

Melaporkan bahwa update sistem telah berhasil didownload.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponse>

Melaporkan bahwa update sistem telah berhasil didownload.

abstract @NonNull ReportSystemUpdateDownloadedWithOverrideResponse

Melaporkan bahwa update sistem telah didownload, sehingga menggantikan petunjuk AMAPI.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponse>

Melaporkan bahwa update sistem telah didownload, sehingga menggantikan petunjuk AMAPI.

abstract @NonNull ReportSystemUpdateDownloadingResponse

Melaporkan bahwa download update sistem telah dimulai.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponse>

Melaporkan bahwa download update sistem telah dimulai.

abstract @NonNull ReportSystemUpdateDownloadingWithOverrideResponse

Melaporkan bahwa download update sistem telah dimulai, menggantikan petunjuk AMAPI.

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponse>

Melaporkan bahwa download update sistem telah dimulai, menggantikan petunjuk AMAPI.

abstract @NonNull UpdateControlState

Memperbarui status kontrol update sistem.

abstract @NonNull ListenableFuture<@NonNull UpdateControlState>

Memperbarui status kontrol update sistem.

Metode publik

createSystemUpdate

abstract @NonNull SystemUpdate createSystemUpdate(@NonNull CreateSystemUpdateRequest request)

Menyediakan resource SystemUpdate baru untuk AMAPI.

Objek SystemUpdate di request hanya boleh berisi kolom yang dimiliki oleh klien OTA. Kolom yang ditandai sebagai hanya output dalam SystemUpdate (misalnya, instruction) diabaikan jika diberikan dalam permintaan.

Respons berisi objek SystemUpdate, yang dilengkapi dengan kolom hanya baca seperti instruction yang ditentukan oleh AMAPI berdasarkan kebijakan.

Parameter
@NonNull CreateSystemUpdateRequest request

CreateSystemUpdateRequest yang berisi objek SystemUpdate yang akan dibuat.

Hasil
@NonNull SystemUpdate

Objek SystemUpdate lengkap, termasuk kolom petunjuk hanya output.

Menampilkan
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException

jika UpdateControlState bukan UpdateControlState.ControlState.UNIFIED_UPDATE_CONTROL.

SystemUpdateAlreadyExistsException jika update sistem dengan nama yang sama sudah ada.

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

InvalidArgumentException jika format permintaan salah.

java.lang.SecurityException

java.lang.SecurityException jika klien OTA tidak diizinkan untuk memanggil API ini.

AndroidDevicePolicyAppNotUpdatedException jika aplikasi Android Device Policy perlu diupdate.

InternalException jika terjadi error internal.

TimeoutException

java.util.concurrent.TimeoutException jika terjadi waktu tunggu habis.

AmapiSdkException pengecualian dasar untuk semua error lainnya.

createSystemUpdateFuture

abstract @NonNull ListenableFuture<@NonNull SystemUpdatecreateSystemUpdateFuture(@NonNull CreateSystemUpdateRequest request)

Menyediakan resource SystemUpdate baru untuk AMAPI. Tindakan ini sama dengan createSystemUpdate, tetapi menampilkan ListenableFuture, bukan menangguhkan.

Parameter
@NonNull CreateSystemUpdateRequest request

CreateSystemUpdateRequest yang berisi objek SystemUpdate yang akan dibuat.

Hasil
@NonNull ListenableFuture<@NonNull SystemUpdate>

ListenableFuture dari objek SystemUpdate lengkap, yang dilengkapi dengan kolom hanya output seperti instruction yang ditentukan oleh AMAPI berdasarkan kebijakannya. Operasi masa depan mungkin gagal dengan:

getSystemUpdate

abstract @NonNull SystemUpdate getSystemUpdate(@NonNull GetSystemUpdateRequest request)

Mengambil resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

Metode ini memungkinkan klien OTA mengambil status update saat ini yang dibuat olehnya, termasuk petunjuk yang ditentukan AMAPI.

Parameter
@NonNull GetSystemUpdateRequest request

Permintaan yang berisi nama resource dan tampilan yang diinginkan untuk resource.

Hasil
@NonNull SystemUpdate

Objek SystemUpdate, diisi sesuai dengan tampilan yang diminta.

Menampilkan

SystemUpdateNotFoundException jika update sistem tidak ditemukan.

UpdateControlStateNotFoundException jika status kontrol update tidak ditemukan.

InvalidSystemUpdateStateException jika transisi status update sistem tidak valid.

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

InvalidArgumentException jika format permintaan salah.

java.lang.SecurityException

java.lang.SecurityException jika klien OTA tidak diizinkan untuk memanggil API ini.

AndroidDevicePolicyAppNotUpdatedException jika aplikasi Android Device Policy perlu diupdate.

InternalException jika terjadi error internal.

TimeoutException

java.util.concurrent.TimeoutException jika terjadi waktu tunggu habis.

AmapiSdkException pengecualian dasar untuk semua error lainnya.

getSystemUpdateFuture

abstract @NonNull ListenableFuture<@NonNull SystemUpdategetSystemUpdateFuture(@NonNull GetSystemUpdateRequest request)

Mengambil resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA. Tindakan ini sama dengan getSystemUpdate, tetapi menampilkan ListenableFuture, bukan menangguhkan.

Parameter
@NonNull GetSystemUpdateRequest request

Permintaan yang berisi nama resource dan tampilan yang diinginkan untuk resource.

Hasil
@NonNull ListenableFuture<@NonNull SystemUpdate>

ListenableFuture objek SystemUpdate, diisi sesuai dengan tampilan yang diminta. Operasi masa depan mungkin gagal dengan:

getUpdateControlState

abstract @NonNull UpdateControlState getUpdateControlState(@NonNull GetUpdateControlStateRequest request)

Mendapatkan status kontrol update sistem saat ini. Klien OTA OEM menggunakan metode ini untuk mengambil status saat ini dari solusi kontrol update yang diketahui AMAPI.

Hasil
@NonNull UpdateControlState

UpdateControlState saat ini untuk perangkat.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

getUpdateControlStateFuture

abstract @NonNull ListenableFuture<@NonNull UpdateControlStategetUpdateControlStateFuture(
    @NonNull GetUpdateControlStateRequest request
)

Mendapatkan status kontrol update sistem saat ini. Klien OTA OEM menggunakan metode ini untuk mengambil status saat ini dari solusi kontrol update yang diketahui AMAPI.

Hasil
@NonNull ListenableFuture<@NonNull UpdateControlState>

ListenableFuture yang di-resolve ke UpdateControlState saat ini untuk perangkat jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

listSystemUpdates

abstract @NonNull ListSystemUpdatesResponse listSystemUpdates(@NonNull ListSystemUpdatesRequest request)

Mengambil daftar semua resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA.

Metode ini memungkinkan klien OTA mengambil status update saat ini, termasuk petunjuk yang ditentukan AMAPI, untuk semua update yang dibuat olehnya yang diketahui AMAPI.

Parameter
@NonNull ListSystemUpdatesRequest request

Permintaan yang berisi tampilan yang diinginkan untuk resource.

Hasil
@NonNull ListSystemUpdatesResponse

ListSystemUpdatesResponse yang berisi daftar objek SystemUpdate, diisi sesuai dengan tampilan yang diminta.

Menampilkan
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException

jika UpdateControlState bukan UpdateControlState.ControlState.UNIFIED_UPDATE_CONTROL.

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

InvalidArgumentException jika format permintaan salah.

java.lang.SecurityException

java.lang.SecurityException jika klien OTA tidak diizinkan untuk memanggil API ini.

AndroidDevicePolicyAppNotUpdatedException jika aplikasi Android Device Policy perlu diupdate.

InternalException jika terjadi error internal.

TimeoutException

java.util.concurrent.TimeoutException jika terjadi waktu tunggu habis.

AmapiSdkException pengecualian dasar untuk semua error lainnya.

listSystemUpdatesFuture

abstract @NonNull ListenableFuture<@NonNull ListSystemUpdatesResponselistSystemUpdatesFuture(@NonNull ListSystemUpdatesRequest request)

Mengambil daftar semua resource SystemUpdate yang sebelumnya ditetapkan oleh klien OTA. Tindakan ini sama dengan listSystemUpdates, tetapi menampilkan ListenableFuture, bukan menangguhkan.

Parameter
@NonNull ListSystemUpdatesRequest request

Permintaan yang berisi tampilan yang diinginkan untuk resource.

Hasil
@NonNull ListenableFuture<@NonNull ListSystemUpdatesResponse>

ListenableFuture dari ListSystemUpdatesResponse yang berisi daftar objek SystemUpdate, diisi sesuai dengan tampilan yang diminta. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateAborted

abstract @NonNull ReportSystemUpdateAbortedResponse reportSystemUpdateAborted(
    @NonNull ReportSystemUpdateAbortedRequest request
)

Melaporkan bahwa update sistem telah dibatalkan.

Metode ini dipanggil saat klien OTA membatalkan proses update sistem. Permintaan harus menyertakan nama resource update sistem dan alasan untuk membatalkan. Ini adalah status akhir untuk update.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateAbortedFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponsereportSystemUpdateAbortedFuture(
    @NonNull ReportSystemUpdateAbortedRequest request
)

Melaporkan bahwa update sistem telah dibatalkan.

Metode ini dipanggil saat klien OTA membatalkan proses update sistem. Permintaan harus menyertakan nama resource update sistem dan alasan untuk membatalkan. Ini adalah status akhir untuk update.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateAbortedResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateApplied

abstract @NonNull ReportSystemUpdateAppliedResponse reportSystemUpdateApplied(
    @NonNull ReportSystemUpdateAppliedRequest request
)

Melaporkan bahwa update sistem telah berhasil diterapkan.

Metode ini harus dipanggil saat klien OTA berhasil menerapkan update sistem mengikuti petunjuk dari Android Management API. Jika memerlukan mulai ulang, fungsi ini harus dipanggil setelah mulai ulang. Permintaan harus menentukan nama resource update sistem yang diterapkan. Ini adalah status akhir untuk update.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateAppliedFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponsereportSystemUpdateAppliedFuture(
    @NonNull ReportSystemUpdateAppliedRequest request
)

Melaporkan bahwa update sistem telah berhasil diterapkan.

Metode ini harus dipanggil saat klien OTA berhasil menerapkan update sistem mengikuti petunjuk dari Android Management API. Jika memerlukan mulai ulang, fungsi ini harus dipanggil setelah mulai ulang. Permintaan harus menentukan nama resource update sistem yang diterapkan. Ini adalah status akhir untuk update.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateAppliedResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateAppliedWithOverride

abstract @NonNull ReportSystemUpdateAppliedWithOverrideResponse reportSystemUpdateAppliedWithOverride(
    @NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)

Melaporkan bahwa update sistem telah diterapkan, menggantikan petunjuk AMAPI.

Metode ini dipanggil saat klien OTA menerapkan update sistem yang bertentangan dengan petunjuk BLOCK dari Android Management API. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian. Ini adalah status akhir untuk update.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateAppliedWithOverrideFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponsereportSystemUpdateAppliedWithOverrideFuture(
    @NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)

Melaporkan bahwa update sistem telah diterapkan, menggantikan petunjuk AMAPI.

Metode ini dipanggil saat klien OTA menerapkan update sistem yang bertentangan dengan petunjuk BLOCK dari Android Management API. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian. Ini adalah status akhir untuk update.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateAppliedWithOverrideResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateApplyPrevented

abstract @NonNull ReportSystemUpdateApplyPreventedResponse reportSystemUpdateApplyPrevented(
    @NonNull ReportSystemUpdateApplyPreventedRequest request
)

Melaporkan bahwa penerapan update sistem dicegah.

Metode ini harus dipanggil saat klien OTA diinstruksikan untuk menerapkan update, tetapi dicegah melakukannya oleh kondisi lokal. Permintaan harus menyertakan nama resource update sistem dan alasan pencegahan.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateApplyPreventedFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponsereportSystemUpdateApplyPreventedFuture(
    @NonNull ReportSystemUpdateApplyPreventedRequest request
)

Melaporkan bahwa penerapan update sistem dicegah.

Metode ini harus dipanggil saat klien OTA diinstruksikan untuk menerapkan update, tetapi dicegah melakukannya oleh kondisi lokal. Permintaan harus menyertakan nama resource update sistem dan alasan pencegahan.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateApplyPreventedResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateDownloadPrevented

abstract @NonNull ReportSystemUpdateDownloadPreventedResponse reportSystemUpdateDownloadPrevented(
    @NonNull ReportSystemUpdateDownloadPreventedRequest request
)

Melaporkan bahwa download update sistem dicegah.

Metode ini harus dipanggil saat klien OTA diinstruksikan untuk mendownload update, tetapi tidak dapat melakukannya karena kondisi lokal (misalnya, baterai tidak cukup, tidak ada jaringan). Permintaan harus menyertakan nama resource update sistem dan alasan pencegahan.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateDownloadPreventedFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponsereportSystemUpdateDownloadPreventedFuture(
    @NonNull ReportSystemUpdateDownloadPreventedRequest request
)

Melaporkan bahwa download update sistem dicegah.

Metode ini harus dipanggil saat klien OTA diinstruksikan untuk mendownload update, tetapi tidak dapat melakukannya karena kondisi lokal (misalnya, baterai tidak cukup, tidak ada jaringan). Permintaan harus menyertakan nama resource update sistem dan alasan pencegahan.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateDownloadPreventedResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateDownloaded

abstract @NonNull ReportSystemUpdateDownloadedResponse reportSystemUpdateDownloaded(
    @NonNull ReportSystemUpdateDownloadedRequest request
)

Melaporkan bahwa update sistem telah berhasil didownload.

Metode ini harus dipanggil saat klien OTA menyelesaikan download update sistem seperti yang diinstruksikan oleh Android Management API. Permintaan harus menyertakan nama resource update sistem yang didownload.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateDownloadedFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponsereportSystemUpdateDownloadedFuture(
    @NonNull ReportSystemUpdateDownloadedRequest request
)

Melaporkan bahwa update sistem telah berhasil didownload.

Metode ini harus dipanggil saat klien OTA menyelesaikan download update sistem seperti yang diinstruksikan oleh Android Management API. Permintaan harus menyertakan nama resource update sistem yang didownload.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateDownloadedResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateDownloadedWithOverride

abstract @NonNull ReportSystemUpdateDownloadedWithOverrideResponse reportSystemUpdateDownloadedWithOverride(
    @NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)

Melaporkan bahwa update sistem telah didownload, sehingga menggantikan petunjuk AMAPI.

Metode ini dipanggil saat klien OTA menyelesaikan download update sistem, setelah menggantikan petunjuk BLOCK dari Android Management API. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateDownloadedWithOverrideFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponsereportSystemUpdateDownloadedWithOverrideFuture(
    @NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)

Melaporkan bahwa update sistem telah didownload, sehingga menggantikan petunjuk AMAPI.

Metode ini dipanggil saat klien OTA menyelesaikan download update sistem, setelah menggantikan petunjuk BLOCK dari Android Management API. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateDownloadedWithOverrideResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateDownloading

abstract @NonNull ReportSystemUpdateDownloadingResponse reportSystemUpdateDownloading(
    @NonNull ReportSystemUpdateDownloadingRequest request
)

Melaporkan bahwa download update sistem telah dimulai.

Metode ini harus dipanggil saat klien OTA memulai atau melanjutkan mendownload update sistem sesuai dengan petunjuk yang diterima dari Android Management API. Permintaan harus berisi nama resource update sistem yang sedang didownload.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateDownloadingFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponsereportSystemUpdateDownloadingFuture(
    @NonNull ReportSystemUpdateDownloadingRequest request
)

Melaporkan bahwa download update sistem telah dimulai.

Metode ini harus dipanggil saat klien OTA memulai atau melanjutkan mendownload update sistem sesuai dengan petunjuk yang diterima dari Android Management API. Permintaan harus berisi nama resource update sistem yang sedang didownload.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateDownloadingResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

reportSystemUpdateDownloadingWithOverride

abstract @NonNull ReportSystemUpdateDownloadingWithOverrideResponse reportSystemUpdateDownloadingWithOverride(
    @NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)

Melaporkan bahwa download update sistem telah dimulai, menggantikan petunjuk AMAPI.

Metode ini harus dipanggil saat klien OTA mulai mendownload update sistem meskipun petunjuk dari Android Management API adalah memblokir download. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

reportSystemUpdateDownloadingWithOverrideFuture

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponsereportSystemUpdateDownloadingWithOverrideFuture(
    @NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)

Melaporkan bahwa download update sistem telah dimulai, menggantikan petunjuk AMAPI.

Metode ini harus dipanggil saat klien OTA mulai mendownload update sistem meskipun petunjuk dari Android Management API adalah memblokir download. Permintaan harus menyertakan nama resource update sistem dan alasan untuk penggantian.

Hasil
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponse>

ListenableFuture yang di-resolve ke ReportSystemUpdateDownloadingWithOverrideResponse jika panggilan berhasil. Operasi masa depan mungkin gagal dengan:

updateUpdateControlState

abstract @NonNull UpdateControlState updateUpdateControlState(
    @NonNull UpdateUpdateControlStateRequest request
)

Memperbarui status kontrol update sistem. Klien OTA OEM menggunakan metode ini untuk melaporkan perubahan pada status kontrol update. Klien OEM HARUS memanggil metode ini setiap kali status kontrol berubah.

Parameter
@NonNull UpdateUpdateControlStateRequest request

Permintaan yang berisi UpdateControlState baru.

Menampilkan

ApiLevelException jika level API perangkat lebih rendah dari Tiramisu (level API 33).

AndroidDevicePolicyAppNotInstalledException jika aplikasi Android Device Policy tidak diinstal.

AndroidDevicePolicyAppDisabledException jika aplikasi Android Device Policy dinonaktifkan.

DeviceNotManagedException jika perangkat tidak dikelola perusahaan.

updateUpdateControlStateFuture

abstract @NonNull ListenableFuture<@NonNull UpdateControlStateupdateUpdateControlStateFuture(
    @NonNull UpdateUpdateControlStateRequest request
)

Memperbarui status kontrol update sistem. Klien OTA OEM menggunakan metode ini untuk melaporkan perubahan pada status kontrol update. Klien OEM HARUS memanggil metode ini setiap kali status kontrol berubah.

Parameter
@NonNull UpdateUpdateControlStateRequest request

Permintaan yang berisi UpdateControlState baru.

Hasil
@NonNull ListenableFuture<@NonNull UpdateControlState>

ListenableFuture yang di-resolve ke UpdateControlState yang diperbarui jika panggilan berhasil. Operasi masa depan mungkin gagal dengan: