MCP Tools Reference: Android Device Management MCP Server

Công cụ: list_enterprises

Liệt kê các doanh nghiệp mà người gọi có thể truy cập.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ list_enterprises MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu liệt kê các doanh nghiệp do EMM quản lý.

ListEnterprisesRequest

Biểu diễn dưới dạng JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
Trường
projectId

string

Bắt buộc. Mã dự án trên đám mây của EMM quản lý các doanh nghiệp.
pageSize

integer

Kích thước trang được yêu cầu. Kích thước trang thực tế có thể được cố định ở một giá trị tối thiểu hoặc tối đa.
pageToken

string

Mã thông báo xác định một trang kết quả do máy chủ trả về.
view

enum (EnterpriseView)

Chỉ định những trường Doanh nghiệp cần trả về. Phương thức này chỉ hỗ trợ BASIC.

Giản đồ đầu ra

Phản hồi cho yêu cầu liệt kê các doanh nghiệp.

ListEnterprisesResponse

Biểu diễn dưới dạng JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Trường
enterprises[]

object (Enterprise)

Danh sách doanh nghiệp.
nextPageToken

string

Nếu có thêm kết quả, thì đây là mã thông báo để truy xuất trang kết quả tiếp theo.

Doanh nghiệp

Biểu diễn dưới dạng 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)
}
Trường
name

string

Tên của doanh nghiệp do máy chủ tạo trong quá trình tạo, ở dạng enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Các loại thông báo Google Pub/Sub được bật cho doanh nghiệp.
pubsubTopic

string

Chủ đề mà thông báo Pub/Sub được xuất bản, ở dạng projects/{project}/topics/{topic}. Bạn chỉ cần điền trường này nếu bật thông báo Pub/Sub.
primaryColor

integer

Màu ở định dạng RGB cho biết màu chủ đạo cần hiển thị trong giao diện người dùng của ứng dụng quản lý thiết bị. Các thành phần màu được lưu trữ như sau: (red << 16) | (green << 8) | blue, trong đó giá trị của mỗi thành phần nằm trong khoảng từ 0 đến 255.
logo

object (ExternalData)

Hình ảnh xuất hiện dưới dạng biểu trưng trong quá trình cấp phép thiết bị. Các loại được hỗ trợ là: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Tên của doanh nghiệp mà người dùng nhìn thấy. Trường này có độ dài tối đa là 100 ký tự.
termsAndConditions[]

object (TermsAndConditions)

Điều khoản và điều kiện mà bạn phải chấp nhận khi cung cấp thiết bị cho doanh nghiệp này. Một trang điều khoản sẽ được tạo cho mỗi giá trị trong danh sách này.
appAutoApprovalEnabled
(deprecated)

boolean

Ngừng hoạt động và không dùng đến.
signinDetails[]

object (SigninDetail)

Thông tin đăng nhập của doanh nghiệp.
contactInfo

object (ContactInfo)

Thông tin liên hệ của doanh nghiệp do EMM quản lý.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Chế độ cài đặt để xác thực người dùng do Google cung cấp.
enterpriseType

enum (EnterpriseType)

Chỉ có đầu ra. Loại hình doanh nghiệp.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Chỉ có đầu ra. Loại tập hợp Tài khoản Google Play có quản lý.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Chỉ có đầu ra. Loại miền được quản lý trên Google.

Int32Value

Biểu diễn dưới dạng JSON 
{
  "value": integer
}
Trường
value

integer

Giá trị int32.

ExternalData

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "sha256Hash": string
}
Trường
url

string

URL tuyệt đối đến dữ liệu, phải sử dụng giao thức http hoặc https. Android Device Policy không cung cấp thông tin đăng nhập nào trong yêu cầu GET, vì vậy, URL phải có thể truy cập công khai. Việc thêm một thành phần ngẫu nhiên, dài vào URL có thể giúp ngăn chặn kẻ tấn công phát hiện ra URL.
sha256Hash

string

Hàm băm SHA-256 được mã hoá theo cơ số 64 của nội dung được lưu trữ tại url. Nếu nội dung không khớp với hàm băm này, Android Device Policy sẽ không sử dụng dữ liệu.

TermsAndConditions

Biểu diễn dưới dạng JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Trường
header

object (UserFacingMessage)

Một tiêu đề ngắn xuất hiện phía trên nội dung HTML.
content

object (UserFacingMessage)

Một chuỗi HTML được định dạng đúng cách. Nội dung này sẽ được phân tích cú pháp trên ứng dụng bằng android.text.Html#fromHtml.

UserFacingMessage

Biểu diễn dưới dạng JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Trường
localizedMessages

map (key: string, value: string)

Một bản đồ chứa các cặp <ngôn ngữ, thông báo>, trong đó ngôn ngữ là mã ngôn ngữ BCP 47 có cấu trúc tốt, chẳng hạn như en-US, es-ES hoặc fr.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Thông báo mặc định sẽ xuất hiện nếu bạn không chỉ định thông báo được bản địa hoá hoặc ngôn ngữ của người dùng không khớp với bất kỳ thông báo được bản địa hoá nào. Bạn phải cung cấp một thông báo mặc định nếu cung cấp bất kỳ thông báo nào đã bản địa hoá.

LocalizedMessagesEntry

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "value": string
}
Trường
key

string
value

string

SigninDetail

Biểu diễn dưới dạng 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.
}
Trường
signinUrl

string

URL đăng nhập để xác thực khi thiết bị được cung cấp bằng mã thông báo đăng ký đăng nhập. Điểm cuối đăng nhập phải hoàn tất quy trình xác thực bằng một URL có dạng https://enterprise.google.com/android/enroll?et= để đăng nhập thành công hoặc https://enterprise.google.com/android/enroll/invalid để đăng nhập không thành công.
signinEnrollmentToken

string

Mã thông báo đăng ký trên toàn doanh nghiệp dùng để kích hoạt quy trình đăng nhập tuỳ chỉnh. Đây là một trường chỉ đọc do máy chủ tạo.
qrCode

string

Một chuỗi JSON mà bạn có thể dùng biểu thị UTF-8 để tạo mã QR nhằm đăng ký một thiết bị bằng mã thông báo đăng ký này. Để đăng ký thiết bị bằng NFC, bản ghi NFC phải chứa một biểu thị java.util.Properties được chuyển đổi tuần tự của các thuộc tính trong JSON. Đây là một trường chỉ đọc do máy chủ tạo.
allowPersonalUsage

enum (AllowPersonalUsage)

Kiểm soát việc người dùng có được phép sử dụng thiết bị được cấp phép bằng mã thông báo đăng ký này cho mục đích cá nhân hay không.

Đối với thiết bị do công ty sở hữu:

  • Khi cho phép sử dụng cho mục đích cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Để tắt chế độ sử dụng cá nhân, người dùng phải cung cấp thiết bị dưới dạng thiết bị được quản lý hoàn toàn.

Đối với thiết bị thuộc sở hữu cá nhân:

  • Khi cho phép sử dụng cho mục đích cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Nếu bạn tắt chế độ sử dụng cá nhân, thiết bị sẽ không được cấp phép. Bạn không thể tắt chế độ sử dụng cá nhân trên thiết bị thuộc sở hữu cá nhân.
defaultStatus

enum (SigninDetailDefaultStatus)

Không bắt buộc. Có nên sử dụng URL đăng nhập theo mặc định cho doanh nghiệp hay không. SigninDetail có defaultStatus được đặt thành SIGNIN_DETAIL_IS_DEFAULT được dùng cho phương thức đăng ký Tài khoản Google. Chỉ một trong số các signinDetails của doanh nghiệp mới có thể đặt defaultStatus thành SIGNIN_DETAIL_IS_DEFAULT. Nếu một Enterprise có ít nhất một signinDetails và không có signinDetails nào đặt defaultStatus thành SIGNIN_DETAIL_IS_DEFAULT thì signinDetails đầu tiên trong danh sách sẽ được chọn và đặt defaultStatus thành SIGNIN_DETAIL_IS_DEFAULT. Nếu không có signinDetails nào được chỉ định cho Enterprise, thì quá trình đăng ký thiết bị bằng Tài khoản Google sẽ không thành công.

Trường nhóm _token_tag.

_token_tag chỉ có thể là một trong những trạng thái sau:
tokenTag

string

Siêu dữ liệu do EMM chỉ định để phân biệt giữa các thực thể của SigninDetail.

ContactInfo

Biểu diễn dưới dạng JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Trường
contactEmail

string

Địa chỉ email của người liên hệ. Địa chỉ này sẽ được dùng để gửi các thông báo quan trọng liên quan đến Google Play được quản lý.
dataProtectionOfficerName

string

Tên của chuyên viên bảo vệ dữ liệu.
dataProtectionOfficerEmail

string

Email của chuyên viên bảo vệ dữ liệu. Email đã được xác thực nhưng chưa được xác minh.
dataProtectionOfficerPhone

string

Số điện thoại của nhân viên bảo vệ dữ liệu Số điện thoại được xác thực nhưng chưa được xác minh.
euRepresentativeName

string

Tên của người đại diện tại Liên minh Châu Âu.
euRepresentativeEmail

string

Email của người đại diện tại Liên minh Châu Âu. Email đã được xác thực nhưng chưa được xác minh.
euRepresentativePhone

string

Số điện thoại của người đại diện tại Liên minh Châu Âu. Số điện thoại được xác thực nhưng chưa được xác minh.

GoogleAuthenticationSettings

Biểu diễn dưới dạng JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Trường
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Chỉ có đầu ra. Người dùng có cần được Google xác thực trong quá trình đăng ký hay không. Quản trị viên CNTT có thể chỉ định xem doanh nghiệp có bật tính năng xác thực bằng Google cho các thiết bị của nhân viên tri thức hay không. Bạn chỉ có thể đặt giá trị này thông qua Bảng điều khiển dành cho quản trị viên của Google. Bạn có thể sử dụng quy trình xác thực của Google với signin_url Trong trường hợp quy trình xác thực của Google là bắt buộc và bạn chỉ định một signin_url, quy trình xác thực của Google sẽ được khởi chạy trước signin_url.

Chú giải công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌