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

Halaman ini diterjemahkan oleh Cloud Translation API.

Enterprises

Pada halaman ini
Representasi resource
Metode

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 dikirimkan ke EMM melalui proses yang kurang lebih manual.
Untuk pelanggan Akun Google 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
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nama properti	Nilai	Deskripsi
`administrator[]`	`list`	Admin perusahaan. Hal ini hanya didukung untuk perusahaan yang dibuat melalui alur yang dimulai oleh EMM.
`administrator[].email`	`string`	Alamat email admin.
`enterpriseType`	`string`	Jenis perusahaan. Nilai yang dapat diterima adalah: "`enterpriseTypeUnspecified`" "`managedGoogleDomain`" "`managedGooglePlayAccountsEnterprise`"
`id`	`string`	ID unik untuk perusahaan.
`kind`	`string`
`managedGoogleDomainType`	`string`	Jenis Managed Google Domains Nilai yang dapat diterima adalah: "`managedGoogleDomainTypeUnspecified`" "`typeDomain`" "`typeTeam`"
`name`	`string`	Nama perusahaan, misalnya, "Contoh, Inc".
`primaryDomain`	`string`	Domain utama perusahaan, seperti "example.com".

Metode

acknowledgeNotificationSet: Mengonfirmasi notifikasi yang diterima dari Enterprises.PullNotificationSet untuk mencegah panggilan berikutnya menampilkan notifikasi yang sama.
completeSignup: Menyelesaikan alur pendaftaran, dengan menentukan Token penyelesaian dan Token perusahaan. 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 API JavaScript Google Play terkelola. Setiap token hanya dapat digunakan untuk memulai satu sesi UI. Lihat dokumentasi JavaScript API untuk informasi lebih lanjut.
daftar: Mendaftarkan perusahaan dengan EMM panggilan.
generateSignupUrl: Membuat URL pendaftaran.
get: Mengambil nama dan domain perusahaan.
getServiceAccount: Menampilkan akun layanan dan kredensial. Akun layanan dapat terikat ke perusahaan dengan memanggil setAccount. Akun layanan 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 sebelum Enterprises.SetAccount; pada waktu lain, metode ini akan menampilkan error.

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

Setelah terikat ke perusahaan, akun layanan dapat dikelola menggunakan resource serviceAccountKeys.
getStoreLayout: Menampilkan tata letak toko untuk perusahaan. Jika tata letak toko belum ditetapkan, menampilkan "dasar" sebagai jenis tata letak toko dan tidak ada halaman beranda.
list: Mencari perusahaan berdasarkan nama domain. Hal ini hanya didukung untuk perusahaan yang dibuat melalui alur pembuatan yang dimulai Google. Pencarian ID tidak diperlukan untuk perusahaan yang dibuat melalui alur yang dimulai EMM karena EMM mempelajari ID perusahaan dalam callback yang ditentukan dalam panggilan Enterprises.generateSignupUrl.
pullNotificationSet: Mengambil dan menampilkan kumpulan notifikasi untuk perusahaan yang terkait dengan akun layanan yang diautentikasi untuk permintaan. Set 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 set notifikasi kosong.
Notifikasi yang tidak dikonfirmasi dalam waktu 20 detik pada akhirnya akan disertakan lagi dalam respons terhadap permintaan PullNotificationSet lain, 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 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 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 ditetapkan ke "basic" dan tata letak toko 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 berdasarkan nilai ID produknya. Jika Anda membuat tata letak toko kustom (dengan menetapkan storeLayoutType = "custom" dan menetapkan halaman beranda), tata letak toko dasar akan dinonaktifkan.
unenroll: Membatalkan pendaftaran perusahaan dari EMM yang melakukan panggilan.