Penting: Kami tidak lagi menerima pendaftaran baru untuk Play EMM API. Pelajari lebih lanjut.

Halaman ini diterjemahkan oleh Cloud Translation API.

Enterprises

Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

Resource Perusahaan mewakili binding antara EMM dan organisasi tertentu. Binding tersebut dapat dibuat instance-nya dengan salah satu dari dua cara berbeda menggunakan API ini sebagai berikut:

Untuk pelanggan domain yang dikelola Google, prosesnya melibatkan penggunaan Enterprises.enroll dan Enterprises.setAccount (bersama dengan artefak yang diperoleh dari konsol Admin dan Konsol API Google) dan dikirim ke EMM melalui proses manual yang kurang lebih.
Untuk pelanggan Akun Google Play terkelola, prosesnya melibatkan penggunaan Enterprises.generateSignupUrl dan Enterprises.completeSignup bersama dengan UI pendaftaran Google Play terkelola (mekanisme yang disediakan Google) untuk membuat binding tanpa langkah manual.

Sebagai EMM, Anda dapat mendukung salah satu atau kedua pendekatan tersebut di konsol EMM. Lihat Membuat Perusahaan untuk mengetahui detailnya.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

Nama properti	Nilai	Deskripsi
`administrator[]`	`list`	Admin perusahaan. Fitur ini hanya didukung untuk perusahaan yang dibuat melalui alur yang dimulai oleh EMM.
`administrator[].email`	`string`	Alamat email admin.
`id`	`string`	ID unik untuk perusahaan.
`kind`	`string`
`name`	`string`	Nama perusahaan, misalnya, "Example, Inc".
`primaryDomain`	`string`	Domain primer perusahaan, seperti "example.com".

Metode

acknowledgeNotificationSet: Mengonfirmasi notifikasi yang diterima dari Enterprises.PullNotificationSet untuk mencegah panggilan berikutnya menampilkan notifikasi yang sama.
completeSignup: Selesaikan alur pendaftaran, dengan menentukan Token penyelesaian dan token Enterprise. Permintaan ini tidak boleh dipanggil beberapa kali untuk Token Enterprise tertentu.
createWebToken: Menampilkan token unik untuk mengakses UI yang dapat disematkan. Untuk membuat UI web, teruskan token yang dihasilkan ke dalam javascript API Google Play terkelola. Setiap token hanya dapat digunakan untuk memulai satu sesi UI. Lihat dokumentasi JavaScript API untuk informasi selengkapnya.
daftarkan: Mendaftarkan perusahaan dengan EMM panggilan.
generateSignupUrl: Membuat URL pendaftaran.
dapatkan: Mengambil nama dan domain perusahaan.
getServiceAccount: Menampilkan akun layanan dan kredensial. Akun layanan dapat diikat ke perusahaan dengan memanggil setAccount. Akun layanan bersifat unik untuk perusahaan dan EMM ini, serta akan dihapus jika perusahaan tidak terikat. Kredensial berisi data kunci pribadi dan tidak disimpan di sisi server.

Metode ini hanya dapat dipanggil setelah memanggil Enterprises.Enroll atau Enterprises.CompleteSignup, dan sebelum Enterprises.SetAccount; pada lain waktu, akan muncul error.

Panggilan berikutnya setelah panggilan pertama akan menghasilkan kumpulan kredensial baru yang unik, serta membatalkan validasi kredensial yang dibuat sebelumnya.

Setelah akun layanan terikat ke perusahaan, akun tersebut dapat dikelola menggunakan resource serviceAccountKeys.
getStoreLayout: Menampilkan tata letak toko untuk perusahaan. Jika tata letak toko belum ditetapkan, tampilkan "basic" sebagai jenis tata letak toko dan tanpa halaman beranda.
list: Mencari perusahaan berdasarkan nama domain. Fitur ini hanya didukung untuk perusahaan yang dibuat melalui alur pembuatan yang dimulai oleh Google. Pencarian ID tidak diperlukan untuk perusahaan yang dibuat melalui alur yang dimulai EMM karena EMM mempelajari ID perusahaan di callback yang ditentukan dalam panggilan Enterprises.generateSignupUrl.
pullNotificationSet: Mengambil dan menampilkan kumpulan notifikasi untuk perusahaan yang terkait dengan akun layanan yang diautentikasi untuk permintaan tersebut. Kumpulan notifikasi mungkin kosong jika tidak ada notifikasi yang tertunda.
Kumpulan notifikasi yang ditampilkan harus dikonfirmasi dalam waktu 20 detik dengan memanggil Enterprises.AcknowledgeNotificationSet, kecuali kumpulan notifikasi tersebut kosong.
Notifikasi yang tidak dikonfirmasi dalam waktu 20 detik pada akhirnya akan disertakan lagi dalam respons terhadap permintaan PullNotificationSet lainnya, dan notifikasi yang tidak pernah dikonfirmasi pada akhirnya akan dihapus sesuai dengan kebijakan sistem Pub/Sub Google Cloud Platform.
Beberapa permintaan dapat dilakukan secara serentak untuk mengambil notifikasi, dalam hal ini notifikasi yang tertunda (jika ada) akan dipisahkan di antara setiap pemanggil, jika ada yang tertunda.
Jika tidak ada notifikasi, daftar notifikasi kosong akan ditampilkan. Permintaan berikutnya dapat menampilkan lebih banyak notifikasi setelah tersedia.
sendTestPushNotification: Mengirim notifikasi pengujian untuk memvalidasi integrasi EMM dengan layanan Google Cloud Pub/Sub untuk perusahaan ini.
setAccount: Menetapkan akun yang akan digunakan untuk mengautentikasi ke API sebagai perusahaan.
setStoreLayout: Menetapkan tata letak toko untuk perusahaan. Secara default, storeLayoutType disetel ke "dasar" dan tata letak penyimpanan dasar diaktifkan. Tata letak dasar hanya berisi aplikasi yang disetujui oleh admin, dan yang telah ditambahkan ke kumpulan produk yang tersedia untuk pengguna (menggunakan panggilan setAvailableProductSet). Aplikasi di halaman diurutkan sesuai dengan nilai ID produknya. Jika Anda membuat tata letak toko kustom (dengan menetapkan storeLayoutType = "custom" dan menetapkan halaman beranda), tata letak toko dasar akan dinonaktifkan.
batalkan pendaftaran: Membatalkan pendaftaran perusahaan dari EMM panggilan.