MCP Tools Reference: Android Device Management MCP Server

Alat: list_enterprises

Mencantumkan perusahaan yang dapat diakses oleh pemanggil.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_enterprises.

Permintaan Curl 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_enterprises",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan untuk mencantumkan perusahaan yang dikelola EMM.

ListEnterprisesRequest

Representasi JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
Kolom
projectId

string

Wajib. ID project Cloud EMM yang mengelola perusahaan.
pageSize

integer

Ukuran halaman yang diminta. Ukuran halaman sebenarnya dapat ditetapkan ke nilai minimum atau maksimum.
pageToken

string

Token yang mengidentifikasi halaman hasil yang ditampilkan oleh server.
view

enum (EnterpriseView)

Menentukan kolom Enterprise yang akan ditampilkan. Metode ini hanya mendukung BASIC.

Skema Output

Respons terhadap permintaan untuk mencantumkan perusahaan.

ListEnterprisesResponse

Representasi JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Kolom
enterprises[]

object (Enterprise)

Daftar perusahaan.
nextPageToken

string

Jika ada lebih banyak hasil, token untuk mengambil halaman hasil berikutnya.

Enterprise

Representasi JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
Kolom
name

string

Nama perusahaan yang dibuat oleh server selama pembuatan, dalam bentuk enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Jenis notifikasi Google Pub/Sub yang diaktifkan untuk perusahaan.
pubsubTopic

string

Topik tempat notifikasi Pub/Sub dipublikasikan, dalam bentuk projects/{project}/topics/{topic}. Kolom ini hanya diperlukan jika notifikasi Pub/Sub diaktifkan.
primaryColor

integer

Warna dalam format RGB yang menunjukkan warna dominan untuk ditampilkan di UI aplikasi pengelolaan perangkat. Komponen warna disimpan sebagai berikut: (red << 16) | (green << 8) | blue, dengan nilai setiap komponen antara 0 dan 255, inklusif.
logo

object (ExternalData)

Gambar yang ditampilkan sebagai logo selama penyediaan perangkat. Jenis yang didukung adalah: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Nama perusahaan yang ditampilkan kepada pengguna. Kolom ini memiliki panjang maksimal 100 karakter.
termsAndConditions[]

object (TermsAndConditions)

Persyaratan dan ketentuan yang harus disetujui saat menyediakan perangkat untuk perusahaan ini. Halaman istilah dibuat untuk setiap nilai dalam daftar ini.
appAutoApprovalEnabled
(deprecated)

boolean

Tidak digunakan lagi dan tidak digunakan.
signinDetails[]

object (SigninDetail)

Detail login perusahaan.
contactInfo

object (ContactInfo)

Info kontak perusahaan yang dikelola EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Setelan untuk autentikasi pengguna yang disediakan Google.
enterpriseType

enum (EnterpriseType)

Hanya output. Jenis perusahaan.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Hanya output. Jenis akun Google Play perusahaan terkelola.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Hanya output. Jenis Managed Google Domains.

Int32Value

Representasi JSON 
{
  "value": integer
}
Kolom
value

integer

Nilai int32.

ExternalData

Representasi JSON 
{
  "url": string,
  "sha256Hash": string
}
Kolom
url

string

URL absolut ke data, yang harus menggunakan skema http atau https. Android Device Policy tidak memberikan kredensial apa pun dalam permintaan GET, sehingga URL harus dapat diakses secara publik. Menyertakan komponen acak yang panjang dalam URL dapat digunakan untuk mencegah penyerang menemukan URL.
sha256Hash

string

Hash SHA-256 berenkode base-64 dari konten yang dihosting di URL. Jika konten tidak cocok dengan hash ini, Android Device Policy tidak akan menggunakan data tersebut.

TermsAndConditions

Representasi JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Kolom
header

object (UserFacingMessage)

Header singkat yang muncul di atas konten HTML.
content

object (UserFacingMessage)

String HTML yang diformat dengan baik. String ini akan diuraikan di klien dengan android.text.Html#fromHtml.

UserFacingMessage

Representasi JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Kolom
localizedMessages

map (key: string, value: string)

Peta yang berisi pasangan <locale, message>, dengan locale adalah kode bahasa BCP 47 yang terbentuk dengan baik, seperti en-US, es-ES, atau fr.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Pesan default yang ditampilkan jika tidak ada pesan yang dilokalkan yang ditentukan atau lokalitas pengguna tidak cocok dengan pesan yang dilokalkan. Pesan default harus diberikan jika ada pesan yang dilokalkan.

LocalizedMessagesEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

SigninDetail

Representasi JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),

  // Union field _token_tag can be only one of the following:
  "tokenTag": string
  // End of list of possible types for union field _token_tag.
}
Kolom
signinUrl

string

URL login untuk autentikasi saat perangkat disediakan dengan token pendaftaran login. Endpoint login harus menyelesaikan alur autentikasi dengan URL dalam bentuk https://enterprise.google.com/android/enroll?et= untuk login yang berhasil, atau https://enterprise.google.com/android/enroll/invalid untuk login yang gagal.
signinEnrollmentToken

string

Token pendaftaran di seluruh perusahaan yang digunakan untuk memicu alur login kustom. Ini adalah kolom hanya baca yang dibuat oleh server.
qrCode

string

String JSON yang representasi UTF-8-nya dapat digunakan untuk membuat kode QR guna mendaftarkan perangkat dengan token pendaftaran ini. Untuk mendaftarkan perangkat menggunakan NFC, rekaman NFC harus berisi representasi java.util.Properties yang diserialisasi dari properti dalam JSON. Ini adalah kolom hanya baca yang dibuat oleh server.
allowPersonalUsage

enum (AllowPersonalUsage)

Mengontrol apakah penggunaan pribadi diizinkan di perangkat yang disediakan dengan token pendaftaran ini.

Untuk perangkat milik perusahaan:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna menyiapkan profil kerja di perangkat.
  • Untuk menonaktifkan penggunaan pribadi, pengguna harus menyediakan perangkat sebagai perangkat terkelola sepenuhnya.

Untuk perangkat milik pribadi:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna menyiapkan profil kerja di perangkat.
  • Menonaktifkan penggunaan pribadi akan mencegah perangkat disediakan. Penggunaan pribadi tidak dapat dinonaktifkan di perangkat milik pribadi.
defaultStatus

enum (SigninDetailDefaultStatus)

Opsional. Apakah URL login harus digunakan secara default untuk perusahaan. SigninDetail dengan defaultStatus yang ditetapkan ke SIGNIN_DETAIL_IS_DEFAULT digunakan untuk metode pendaftaran Akun Google. Hanya satu signinDetails perusahaan yang dapat memiliki defaultStatus yang ditetapkan ke SIGNIN_DETAIL_IS_DEFAULT. Jika Enterprise memiliki setidaknya satu signinDetails dan tidak ada yang memiliki defaultStatus yang disetel ke SIGNIN_DETAIL_IS_DEFAULT, maka signinDetails pertama dari daftar akan dipilih dan defaultStatus-nya disetel ke SIGNIN_DETAIL_IS_DEFAULT. Jika tidak ada signinDetails yang ditentukan untuk Enterprise, pendaftaran perangkat Akun Google akan gagal.

Kolom union _token_tag.

_token_tag hanya dapat berupa salah satu dari hal berikut:
tokenTag

string

Metadata yang ditentukan EMM untuk membedakan instance SigninDetail.

ContactInfo

Representasi JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Kolom
contactEmail

string

Alamat email untuk kontak, yang akan digunakan untuk mengirim pengumuman penting terkait Google Play terkelola.
dataProtectionOfficerName

string

Nama petugas perlindungan data.
dataProtectionOfficerEmail

string

Email petugas perlindungan data. Email divalidasi, tetapi tidak diverifikasi.
dataProtectionOfficerPhone

string

Nomor telepon petugas perlindungan data Nomor telepon divalidasi, tetapi tidak diverifikasi.
euRepresentativeName

string

Nama perwakilan Uni Eropa.
euRepresentativeEmail

string

Email perwakilan Uni Eropa. Email divalidasi, tetapi tidak diverifikasi.
euRepresentativePhone

string

Nomor telepon perwakilan Uni Eropa. Nomor telepon divalidasi, tetapi tidak diverifikasi.

GoogleAuthenticationSettings

Representasi JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Kolom
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Hanya output. Apakah pengguna perlu diautentikasi oleh Google selama proses pendaftaran. Admin IT dapat menentukan apakah autentikasi Google diaktifkan untuk perusahaan bagi perangkat pekerja intelektual. Nilai ini hanya dapat disetel melalui Konsol Admin Google. Autentikasi Google dapat digunakan dengan signin_url Jika autentikasi Google diperlukan dan signin_url ditentukan, autentikasi Google akan diluncurkan sebelum signin_url.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌