Untuk 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 terkelola Google, prosesnya melibatkan penggunaan
Enterprises.enroll
danEnterprises.setAccount
(bersama dengan artefak yang diperoleh dari konsol Admin dan Konsol API Google) dan dikirimkan ke EMM melalui proses manual yang kurang lebih. - Untuk pelanggan Akun Google Play terkelola, prosesnya melibatkan penggunaan
Enterprises.generateSignupUrl
danEnterprises.completeSignup
bersama dengan UI pendaftaran Google Play terkelola (mekanisme yang disediakan Google) untuk membuat binding tanpa langkah manual.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
administrator[] |
list |
Admin perusahaan. Opsi ini hanya didukung untuk perusahaan yang dibuat melalui alur yang dimulai 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 ditampilkan notifikasi yang sama.
- completeSignup
- Menyelesaikan alur pendaftaran, dengan menentukan token Penyelesaian dan Token perusahaan. Permintaan ini tidak boleh dipanggil beberapa kali untuk Perusahaan tertentu menggunakan Token Google.
- createWebToken
- Menampilkan token unik untuk mengakses UI yang dapat disematkan. Untuk membuat UI web, teruskan token yang dibuat ke JavaScript Google Play terkelola Compute Engine API. Setiap token hanya dapat digunakan untuk memulai satu sesi UI. Lihat Dokumentasi JavaScript API untuk informasi lebih lanjut.
- 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, dan akan dihapus jika perusahaan
tidak terikat. Kredensial berisi data kunci pribadi dan tidak disimpan
sisi server.
Metode ini hanya dapat dipanggil setelah memanggil Enterprises.Enroll atau Enterprises.CompleteSignup, dan sebelumnya Enterprises.SetAccount; pada lain waktu, itu akan menghasilkan {i>error<i}.
Panggilan berikutnya setelah panggilan pertama akan menghasilkan serangkaian kredensial, dan membatalkan kredensial yang dibuat sebelumnya.
Setelah akun layanan terikat dengan perusahaan, akun tersebut dapat dikelola menggunakan resource serviceAccountKeys. - getStoreLayout
- Menampilkan tata letak toko untuk perusahaan. Jika tata letak toko belum disetel, mengembalikan "dasar" seperti jenis tata letak toko dan {i>homepage<i}.
- list
- Mencari perusahaan berdasarkan nama domain. Ini hanya didukung untuk perusahaan yang dibuat melalui alur kreasi. 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
- Menarik dan menampilkan set notifikasi untuk perusahaan yang terkait dengan
akun layanan yang diotentikasi untuk permintaan. Kumpulan notifikasi mungkin
kosong jika tidak ada notifikasi yang tertunda.
Set notifikasi yang ditampilkan harus dikonfirmasi dalam waktu 20 detik dengan memanggil Enterprises.AcknowledgeNotificationSet, kecuali jika kumpulan notifikasi kosong.
Notifikasi yang tidak dikonfirmasi dalam 20 detik akan pada akhirnya akan disertakan lagi dalam respons terhadap PullNotificationSet lainnya dan permintaan 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 pemberitahuan yang tertunda (jika ada) akan dibagi 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 menjadi yang 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 melakukan autentikasi ke API sebagai perusahaan.
- setStoreLayout
- Menetapkan tata letak toko untuk perusahaan. Secara default, storeLayoutType disetel ke "dasar" dan tata letak toko dasar diaktifkan. Dasar-dasar hanya berisi aplikasi yang disetujui oleh admin, dan yang memiliki ditambahkan ke kumpulan produk yang tersedia untuk pengguna (menggunakan setAvailableProductSet). Aplikasi di halaman diurutkan dalam urutan nilai ID produk. Jika Anda membuat tata letak toko kustom (dengan menyetel storeLayoutType = "custom" dan mengatur beranda), toko dasar dinonaktifkan.
- batalkan pendaftaran
- Membatalkan pendaftaran perusahaan dari EMM panggilan.