MCP Tools Reference: Android Device Management MCP Server

工具：list_enterprises

列出通話者可存取的企業。

以下範例示範如何使用 curl 叫用 list_enterprises 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": "list_enterprises",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

要求列出 EMM 管理的企業。

ListEnterprisesRequest

JSON 表示法 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
欄位
projectId

string

必填。管理企業的 EMM 雲端專案 ID。
pageSize

integer

要求的頁面大小。實際網頁大小可能會固定為最小值或最大值。
pageToken

string

這個符記可識別伺服器傳回的結果頁面。
view

enum (EnterpriseView)

指定要傳回哪些企業欄位。這個方法僅支援 BASIC。

輸出內容的結構定義

列出企業的要求的回應。

ListEnterprisesResponse

JSON 表示法 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
欄位
enterprises[]

object (Enterprise)

企業清單。
nextPageToken

string

如有更多結果，則為用來擷取下一頁結果的符記。

Enterprise

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

企業名稱，由伺服器在建立時產生，格式為 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 值。

ExternalData

JSON 表示法 
{
  "url": string,
  "sha256Hash": string
}
欄位
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 剖析這項資料。

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

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

LocalizedMessagesEntry

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

string
value

string

SigninDetail

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

裝置使用登入註冊權杖佈建時，用於驗證的登入網址。登入端點應以 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
}
欄位
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。

工具註解

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