MCP Tools Reference: Android Device Management MCP Server

工具：`get_enterprise`

取得指定企業 ID 的企業。名稱欄位必須包含企業 ID (例如：enterprises/{enterpriseId})。

以下範例示範如何使用 curl 叫用 get_enterprise MCP 工具。

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": "get_enterprise", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

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": "get_enterprise",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

要求取得企業版。傳回所有可用欄位。

GetEnterpriseRequest

JSON 表示法
{ "name": string }

欄位

欄位
`name`	`string` 企業名稱，格式為 `enterprises/{enterpriseId}`。

name

string

企業名稱，格式為 enterprises/{enterpriseId}。

輸出內容的結構定義

套用至企業的設定。

Enterprise

JSON 表示法

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`) }

{
  "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)
}

欄位
`name`	`string` 企業名稱，由伺服器在建立時產生，格式為 `enterprises/{enterpriseId}`。
`enabledNotificationTypes[]`	`enum (NotificationType)` 為企業啟用的 Google Pub/Sub 通知類型。
`pubsubTopic`	`string` Pub/Sub 通知發布的主題，格式為 `projects/{project}/topics/{topic}`。只有在啟用 Pub/Sub 通知時，才需要填寫這個欄位。
`primaryColor`	`integer` RGB 格式的顏色，表示要在裝置管理應用程式 UI 中顯示的主要顏色。顏色元件的儲存方式如下：`(red << 16) \| (green << 8) \| blue`，其中每個元件的值介於 0 到 255 (含頭尾)。
`logo`	`object (ExternalData)` 裝置佈建期間顯示為標誌的圖片。支援的類型包括：image/bmp、image/gif、image/x-ico、image/jpeg、image/png、image/webp、image/vnd.wap.wbmp、image/x-adobe-dng。
`enterpriseDisplayName`	`string` 向使用者顯示的企業名稱。這個欄位的長度上限為 100 個字元。
`termsAndConditions[]`	`object (TermsAndConditions)` 為這個企業佈建裝置時必須接受的條款及細則。系統會為這份清單中的每個值產生一頁字詞。
`appAutoApprovalEnabled (deprecated)`	`boolean` 這個項目已淘汰！已淘汰且未使用。
`signinDetails[]`	`object (SigninDetail)` 企業的登入詳細資料。
`contactInfo`	`object (ContactInfo)` EMM 管理企業的企業聯絡資訊。
`googleAuthenticationSettings`	`object (GoogleAuthenticationSettings)` Google 提供的使用者驗證設定。
`enterpriseType`	`enum (EnterpriseType)` 僅供輸出。企業類型。
`managedGooglePlayAccountsEnterpriseType`	`enum (ManagedGooglePlayAccountsEnterpriseType)` 僅供輸出。Google Play 管理版帳戶企業的類型。
`managedGoogleDomainType`	`enum (ManagedGoogleDomainType)` 僅供輸出。受管理 Google 網域的類型。

Int32Value

JSON 表示法
{ "value": integer }

欄位

欄位
`value`	`integer` int32 值。

value

integer

int32 值。

ExternalData

JSON 表示法
{ "url": string, "sha256Hash": string }

欄位

欄位
`url`	`string` 資料的絕對網址，必須使用 http 或 https 通訊協定。Android Device Policy 不會在 GET 要求中提供任何憑證，因此網址必須可供公開存取。在網址中加入隨機的長字串，可防止攻擊者發現網址。
`sha256Hash`	`string` 以 Base64 編碼的 SHA-256 雜湊，代表網址中託管的內容。如果內容與這個雜湊值不符，Android Device Policy 就不會使用該資料。

url

string

資料的絕對網址，必須使用 http 或 https 通訊協定。Android Device Policy 不會在 GET 要求中提供任何憑證，因此網址必須可供公開存取。在網址中加入隨機的長字串，可防止攻擊者發現網址。

sha256Hash

string

以 Base64 編碼的 SHA-256 雜湊，代表網址中託管的內容。如果內容與這個雜湊值不符，Android Device Policy 就不會使用該資料。

TermsAndConditions

JSON 表示法
{ "header": { object (`UserFacingMessage`) }, "content": { object (`UserFacingMessage`) } }

欄位

欄位
`header`	`object (UserFacingMessage)` HTML 內容上方顯示的簡短標題。
`content`	`object (UserFacingMessage)` 格式正確的 HTML 字串。系統會在用戶端使用 android.text.Html#fromHtml 剖析這項資料。

header

object (UserFacingMessage)

HTML 內容上方顯示的簡短標題。

content

object (UserFacingMessage)

格式正確的 HTML 字串。系統會在用戶端使用 android.text.Html#fromHtml 剖析這項資料。

UserFacingMessage

JSON 表示法
{ "localizedMessages": { string: string, ... }, "defaultMessage": string }

欄位

欄位
`localizedMessages`	`map (key: string, value: string)` 包含 <語言代碼, 訊息> 配對的地圖，其中語言代碼是格式正確的 BCP 47 語言代碼，例如 en-US、es-ES 或 fr。這個物件中包含 `"key": value` 組合的清單，範例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`defaultMessage`	`string` 如果未指定任何本地化訊息，或使用者的語言代碼與任何本地化訊息都不相符，系統就會顯示預設訊息。如果提供任何本地化訊息，就必須提供預設訊息。

localizedMessages

map (key: string, value: string)

包含 <語言代碼, 訊息> 配對的地圖，其中語言代碼是格式正確的 BCP 47 語言代碼，例如 en-US、es-ES 或 fr。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

defaultMessage

string

如果未指定任何本地化訊息，或使用者的語言代碼與任何本地化訊息都不相符，系統就會顯示預設訊息。如果提供任何本地化訊息，就必須提供預設訊息。

LocalizedMessagesEntry

JSON 表示法
{ "key": string, "value": string }

欄位
`key`	`string`
`value`	`string`

SigninDetail

JSON 表示法

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`. }

{
  "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.
}

欄位
`signinUrl`	`string` 裝置使用登入註冊權杖佈建時，用於驗證的登入網址。登入端點應以 https://enterprise.google.com/android/enroll?et= 形式的網址完成驗證流程 (登入成功)，或以 https://enterprise.google.com/android/enroll/invalid 形式的網址完成驗證流程 (登入失敗)。
`signinEnrollmentToken`	`string` 用於觸發自訂登入流程的企業註冊權杖。這是伺服器產生的唯讀欄位。
`qrCode`	`string` JSON 字串，其 UTF-8 表示法可用於產生 QR code，以便使用這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置，NFC 記錄必須包含 JSON 中屬性的序列化 `java.util.Properties` 表示法。這是伺服器產生的唯讀欄位。
`allowPersonalUsage`	`enum (AllowPersonalUsage)` 控管是否允許在透過這組註冊權杖佈建的裝置上進行個人使用。公司擁有的裝置：啟用個人用途後，使用者就能在裝置上設定工作資料夾。如要停用個人用途，使用者必須將裝置佈建為全代管裝置。個人裝置：啟用個人用途後，使用者就能在裝置上設定工作資料夾。停用個人用途後，裝置就無法佈建。在個人裝置上無法停用個人用途。
`defaultStatus`	`enum (SigninDetailDefaultStatus)` (選用步驟) 是否應預設使用企業的登入網址。系統會使用 `SigninDetail`，並將 `defaultStatus` 設為 `SIGNIN_DETAIL_IS_DEFAULT`，做為 Google 帳戶註冊方法。企業的 `signinDetails` 只能有一個將 `defaultStatus` 設為 `SIGNIN_DETAIL_IS_DEFAULT`。如果 `Enterprise` 至少有一個 `signinDetails`，且沒有任何一個 `defaultStatus` 設為 `SIGNIN_DETAIL_IS_DEFAULT`，系統會選取清單中的第一個 `Enterprise`，並將 `defaultStatus` 設為 `SIGNIN_DETAIL_IS_DEFAULT`。如果未指定 `Enterprise` 的 `signinDetails`，Google 帳戶裝置註冊就會失敗。
聯集欄位 `_token_tag`。 `_token_tag` 只能是下列其中一項：
`tokenTag`	`string` EMM 指定的中繼資料，用於區分 `SigninDetail` 的執行個體。

ContactInfo

JSON 表示法
{ "contactEmail": string, "dataProtectionOfficerName": string, "dataProtectionOfficerEmail": string, "dataProtectionOfficerPhone": string, "euRepresentativeName": string, "euRepresentativeEmail": string, "euRepresentativePhone": string }

JSON 表示法

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

欄位
`contactEmail`	`string` 聯絡人的電子郵件地址，用於傳送與受管理 Google Play 相關的重要公告。
`dataProtectionOfficerName`	`string` 資料保護長姓名。
`dataProtectionOfficerEmail`	`string` 資料保護長的電子郵件地址。電子郵件地址已通過驗證，但尚未驗證。
`dataProtectionOfficerPhone`	`string` 資料保護官的電話號碼。電話號碼已通過驗證，但尚未完成驗證。
`euRepresentativeName`	`string` 歐盟代表的姓名。
`euRepresentativeEmail`	`string` 歐盟代表的電子郵件地址。電子郵件地址已通過驗證，但尚未驗證。
`euRepresentativePhone`	`string` 歐盟代表的電話號碼。電話號碼已通過驗證，但尚未經過驗證。

GoogleAuthenticationSettings

JSON 表示法
{ "googleAuthenticationRequired": enum (`GoogleAuthenticationRequired`) }

欄位

欄位
`googleAuthenticationRequired`	`enum (GoogleAuthenticationRequired)` 僅供輸出。使用者是否需要在註冊過程中通過 Google 驗證。IT 管理員可以指定是否為企業啟用 Google 驗證，以供知識工作者裝置使用。您只能透過 Google 管理控制台設定這個值，Google 驗證可搭配 `signin_url` 使用。如果需要 Google 驗證，且指定了 `signin_url`，系統會先啟動 Google 驗證，再啟動 `signin_url`。

googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

僅供輸出。使用者是否需要在註冊過程中通過 Google 驗證。IT 管理員可以指定是否為企業啟用 Google 驗證，以供知識工作者裝置使用。您只能透過 Google 管理控制台設定這個值，Google 驗證可搭配 signin_url 使用。如果需要 Google 驗證，且指定了 signin_url，系統會先啟動 Google 驗證，再啟動 signin_url。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌

MCP Tools Reference: Android Device Management MCP Server 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

工具：get_enterprise

輸入內容的結構定義

GetEnterpriseRequest

輸出內容的結構定義

Enterprise

Int32Value

ExternalData

TermsAndConditions

UserFacingMessage

LocalizedMessagesEntry

SigninDetail

ContactInfo

GoogleAuthenticationSettings

工具註解

MCP Tools Reference: Android Device Management MCP Server

工具：`get_enterprise`