Enterprises

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

Representasi resource

Resource Perusahaan mewakili pengikatan antara EMM dan organisasi tertentu. Binding tersebut dapat di-instansiasi 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 Play terkelola, prosesnya melibatkan penggunaan Enterprises.generateSignupUrl dan Enterprises.completeSignup bersama dengan UI pendaftaran Google Play terkelola (mekanisme yang disediakan Google) untuk membuat pengikatan tanpa langkah-langkah manual.

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nama properti	Nilai	Deskripsi	Catatan
administrator[]	list	Admin perusahaan. Tindakan ini hanya didukung untuk perusahaan yang dibuat melalui alur yang dimulai EMM.
administrator[].email	string	Alamat email admin.
enterpriseType	string	Jenis perusahaan. Nilai yang dapat diterima adalah: "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings	nested object	Setelan untuk autentikasi pengguna yang disediakan Google.
googleAuthenticationSettings.createdAt	nested object	Stempel waktu saat setelan pertama kali dibuat atau diubah.
googleAuthenticationSettings.createdAt.nanos	integer	Pecahan detik non-negatif pada resolusi nanodetik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus dari 0 hingga 999.999.999 inklusif.
googleAuthenticationSettings.createdAt.seconds	long	Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus dari 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z inklusif.
googleAuthenticationSettings.dedicatedDevicesAllowed	string	Apakah perangkat khusus diizinkan. Nilai yang dapat diterima adalah: "allowed" "dedicatedDevicesAllowedUnspecified" "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired	string	Apakah autentikasi Google diperlukan. Nilai yang dapat diterima adalah: "googleAuthenticationRequiredUnspecified" "notRequired" "required"
googleAuthenticationSettings.updatedAt	nested object	Stempel waktu saat setelan terakhir diubah.
googleAuthenticationSettings.updatedAt.nanos	integer	Pecahan detik non-negatif pada resolusi nanodetik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus dari 0 hingga 999.999.999 inklusif.
googleAuthenticationSettings.updatedAt.seconds	long	Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus dari 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z inklusif.
id	string	ID unik untuk perusahaan.
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 Perusahaan.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 Perusahaan tertentu.

createWebToken

Menampilkan token unik untuk mengakses UI yang dapat disematkan. Untuk membuat UI web, teruskan token yang dibuat ke Managed Google Play JavaScript API. Setiap token hanya dapat digunakan untuk memulai satu sesi UI. Lihat dokumentasi JavaScript API untuk mengetahui informasi lebih lanjut.

mendaftar

Mendaftarkan perusahaan dengan EMM yang memanggil.

generateEnterpriseUpgradeUrl

Membuat URL upgrade perusahaan untuk mengupgrade akun Google Play perusahaan terkelola yang sudah ada ke Managed Google Domains. Lihat panduan untuk mengupgrade perusahaan untuk mengetahui detail selengkapnya.

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 khusus untuk perusahaan dan EMM ini, dan 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 waktu lain, metode ini akan menampilkan error.

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

Setelah akun layanan terikat ke perusahaan, akun layanan tersebut dapat dikelola menggunakan resource serviceAccountKeys.

Catatan: Setelah membuat kunci, Anda mungkin perlu menunggu selama 60 detik atau lebih sebelum melakukan operasi lain dengan kunci tersebut. Jika Anda mencoba melakukan operasi dengan kunci tersebut segera setelah membuat kunci, dan Anda menerima error, Anda dapat mencoba kembali permintaan dengan backoff eksponensial

.

getStoreLayout

Menampilkan tata letak toko untuk perusahaan. Jika tata letak toko belum ditetapkan, akan menampilkan "basic" 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 bersamaan untuk mengambil notifikasi, dalam hal ini notifikasi 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 disetel ke "basic" dan tata letak toko dasar diaktifkan. Tata letak dasar hanya berisi aplikasi yang disetujui oleh admin, dan yang telah ditambahkan ke set produk yang tersedia untuk pengguna (menggunakan panggilan setAvailableProductSet). Aplikasi di halaman diurutkan berdasarkan nilai ID produknya. Jika Anda membuat tata letak toko kustom (dengan menyetel storeLayoutType = "custom" dan menyetel halaman beranda), tata letak toko dasar akan dinonaktifkan.

membatalkan pendaftaran

Membatalkan pendaftaran perusahaan dari EMM yang memanggil.