Enterprises

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 dan Enterprises.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 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 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.