Persiapan lingkungan dan pendaftaran pengguna
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
SDK Android Management API (AMAPI) memainkan peran penting dalam alur pendaftaran DPC kustom baru. Aplikasi ini memfasilitasi komunikasi
antara aplikasi DPC kustom EMM dan Android Device Policy (ADP) serta menyederhanakan
pendaftaran perangkat dengan berinteraksi dengan Play EMM API untuk fungsi
pendaftaran kunci.
Fungsi utama AMAPI SDK:
- Memungkinkan komunikasi antara aplikasi DPC EMM dan Android Device Policy.
- Memfasilitasi eksekusi perintah secara lokal.
- Mendukung alur pendaftaran perangkat baru untuk menambahkan Akun Google terkelola.
- Mengelola penginstalan atau update Android Device Policy jika diperlukan.
SDK ini penting karena dua alasan utama dalam alur pendaftaran DPC kustom:
Aplikasi ini menyiapkan lingkungan dengan membantu menginstal dan mengupdate Android Device Policy dengan benar di perangkat.
Digunakan untuk memanggil Android Device Policy secara lokal, yang memulai urutan login pengguna di perangkat.
Fungsi dasar ini menyiapkan perangkat untuk pengelolaan dan memungkinkan langkah-langkah pendaftaran berikutnya.
Lingkungan
EnvironmentClient AMAPI SDK adalah antarmuka yang memungkinkan akses ke API terkait lingkungan. Anda dapat membuat instance menggunakan
EnvironmentClientFactory.
Fitur utama EnvironmentClient:
- Pastikan level API SDK memenuhi persyaratan minimum.
- Memeriksa dan memulai update untuk layanan Google Play jika diperlukan.
- Memverifikasi bahwa Android Device Policy telah diinstal dan diupdate. Perhatikan bahwa proses ini dapat memerlukan waktu karena mungkin melibatkan penginstalan atau update.
Untuk mengetahui detail selengkapnya tentang antarmuka EnvironmentClient, lihat dokumentasi
referensi.
AccountSetup
Class AccountSetup dalam AMAPI SDK bertanggung jawab untuk mengelola proses penyiapan Akun Google di perangkat Android terkelola.
Fitur utama AccountSetup:
- Memulai proses penyiapan akun menggunakan
AccountSetupClient dan token pendaftaran.
- Menangani token pendaftaran, yang dibuat oleh EMM dan diteruskan ke
AMAPI SDK. Token ini menentukan apakah autentikasi pengguna
diperlukan.
- Meluncurkan aktivitas autentikasi jika diperlukan, meminta pengguna untuk login dengan kredensial Google mereka.
- Menerima callback dengan email dan ID pengguna setelah login berhasil.
- EMM menggunakan ID pengguna yang diterima untuk menetapkan kebijakan perangkat dengan metode
Devices.update.
- EMM memanggil
Devices.setState
untuk menandai perangkat sebagai mematuhi kebijakan dan mengizinkan akses ke layanan Google.
Fungsi ini adalah bagian dari metode pendaftaran perangkat baru yang memanfaatkan
AMAPI SDK, bukan support library DPC. Untuk mengetahui detail selengkapnya tentang AccountSetup
lihat dokumentasi referensi AMAPI
dan Panduan penerapan akun pengguna.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-25 UTC."],[],[],null,["# Environment preparation and user enrollment\n\nThe Android Management API (AMAPI) SDK plays a important role in the new custom\nDevice Policy Controller (DPC) enrollment flow. It facilitates communication\nbetween EMM custom DPC apps and Android Device Policy (ADP) and streamlines\ndevice enrollment by interacting with the Play EMM API for key enrollment\nfunctions.\n\nKey functions of the AMAPI SDK:\n-------------------------------\n\n- Enables communication between EMM DPC apps and Android Device Policy.\n- Facilitates local execution of commands.\n- Supports the new device enrollment flow for adding managed Google Accounts.\n- Manages the installation or updates of Android Device Policy when needed.\n\nThe SDK is essential for two primary reasons in the custom DPC enrollment flow:\n\n1. It sets the environment by helping to install and update Android Device\n Policy correctly on the device.\n\n2. It is used to call Android Device Policy locally, which initiates the user\n login sequence on the device.\n\nThese foundational functions prepare the device for management and make the\nsubsequent enrollment steps possible.\n\n*** ** * ** ***\n\nEnvironment\n-----------\n\nThe AMAPI SDK's `EnvironmentClient` is an interface that allows access to\nenvironment-related APIs. You can create an instance using\n`EnvironmentClientFactory`.\n\n### Key features of the `EnvironmentClient`:\n\n- Makes sure the SDK API level meets the minimum requirement.\n- Checks for and initiates an update for Google Play services if needed.\n- Verifies that Android Device Policy is installed and updated. Be aware that this process can take some time as it may involve an installation or update.\n\nFor more details on the `EnvironmentClient` interface, see the [reference\ndocumentation](/android/management/reference/amapi/com/google/android/managementapi/environment/EnvironmentClient).\n\n*** ** * ** ***\n\nAccountSetup\n------------\n\nThe `AccountSetup` class within the AMAPI SDK is responsible for managing the\nprocess of setting up a Google Account on a managed Android device.\n\n### Key features of the AccountSetup:\n\n- Starts the account setup process using the `AccountSetupClient` and an enrollment token.\n- Handles the enrollment token, which is generated by the EMM and passed to the AMAPI SDK. This token determines whether user authentication is required.\n- Launches an authentication activity if needed, prompting the user to sign in with their Google credentials.\n- Receives a callback with the user's email and user ID upon successful sign-in.\n- The EMM uses the received user identifiers to set the device policy with the [`Devices.update`](/android/work/play/emm-api/v1/devices/update) method.\n- The EMM calls [`Devices.setState`](/android/work/play/emm-api/v1/devices/setState) to mark the device as compliant and allow access to Google services.\n\nThis functionality is part of a new device enrollment method that leverages the\nAMAPI SDK instead of the DPC support library. For more details on `AccountSetup`\nsee [AMAPI reference\ndocumentation](/android/management/reference/amapi/com/google/android/managementapi/accountsetup/package-summary)\nand [Implement the user accounts\nguide](/android/work/play/emm-api/implement-user-accounts)."]]
