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)

반환할 Enterprise 필드를 지정합니다. 이 메서드는 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

기기 관리 앱 UI에 표시할 지배적인 색상을 나타내는 RGB 형식의 색상입니다. 색상 구성요소는 (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

데이터의 절대 URL입니다. http 또는 https 스키마를 사용해야 합니다. Android Device Policy는 GET 요청에 사용자 인증 정보를 제공하지 않으므로 URL에 공개적으로 액세스할 수 있어야 합니다. URL에 길고 임의적인 구성요소를 포함하면 공격자가 URL을 발견하지 못하도록 방지할 수 있습니다.
sha256Hash

string

URL에서 호스팅되는 콘텐츠의 base-64 인코딩 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)

<locale, message> 쌍이 포함된 맵입니다. 여기서 locale은 en-US, es-ES, fr과 같은 형식이 올바른 BCP 47 언어 코드입니다.

"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

로그인 등록 토큰으로 기기가 프로비저닝될 때 인증을 위한 로그인 URL입니다. 로그인 엔드포인트는 로그인 성공 시 https://enterprise.google.com/android/enroll?et= 형식의 URL로, 로그인 실패 시 https://enterprise.google.com/android/enroll/invalid 형식의 URL로 인증 흐름을 완료해야 합니다.
signinEnrollmentToken

string

맞춤 로그인 흐름을 트리거하는 데 사용되는 전사 등록 토큰입니다. 서버에서 생성된 읽기 전용 필드입니다.
qrCode

string

이 등록 토큰으로 기기를 등록하는 QR 코드를 생성하는 데 사용할 수 있는 UTF-8 표현이 있는 JSON 문자열입니다. NFC를 사용하여 기기를 등록하려면 NFC 레코드에 JSON의 속성에 관한 직렬화된 java.util.Properties 표현이 포함되어야 합니다. 서버에서 생성된 읽기 전용 필드입니다.
allowPersonalUsage

enum (AllowPersonalUsage)

이 등록 토큰으로 프로비저닝된 기기에서 개인 사용이 허용되는지 여부를 제어합니다.

회사 소유 기기의 경우:

  • 개인 사용을 사용 설정하면 사용자가 기기에서 직장 프로필을 설정할 수 있습니다.
  • 개인 사용을 사용 중지하려면 사용자가 기기를 완전 관리형 기기로 프로비저닝해야 합니다.

개인 소유 기기의 경우:

  • 개인 사용을 사용 설정하면 사용자가 기기에서 직장 프로필을 설정할 수 있습니다.
  • 개인 사용을 사용 중지하면 기기가 프로비저닝되지 않습니다. 개인 소유 기기에서는 개인 사용을 사용 중지할 수 없습니다.
defaultStatus

enum (SigninDetailDefaultStatus)

선택사항입니다. 로그인 URL이 엔터프라이즈에 기본적으로 사용되어야 하는지 여부입니다. defaultStatus이 SIGNIN_DETAIL_IS_DEFAULT로 설정된 SigninDetail은 Google 계정 등록 방법에 사용됩니다. 기업의 signinDetails 중 하나만 defaultStatus이 SIGNIN_DETAIL_IS_DEFAULT로 설정될 수 있습니다. Enterprise에 하나 이상의 signinDetails이 있고 defaultStatus이 SIGNIN_DETAIL_IS_DEFAULT로 설정된 signinDetails이 없으면 목록에서 첫 번째 signinDetails이 선택되고 defaultStatus이 SIGNIN_DETAIL_IS_DEFAULT로 설정됩니다. Enterprise에 지정된 signinDetails이 없으면 Google 계정 기기 등록이 실패합니다.

통합 필드 _token_tag.

_token_tag는 다음 중 하나여야 합니다.
tokenTag

string

SigninDetail 인스턴스를 구분하기 위해 EMM에서 지정한 메타데이터입니다.

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

EU 담당자 이름입니다.
euRepresentativeEmail

string

EU 담당자의 이메일입니다. 이메일이 유효성 검사는 되었지만 인증되지는 않았습니다.
euRepresentativePhone

string

EU 담당자의 전화번호입니다. 전화번호가 유효하지만 인증되지 않았습니다.

GoogleAuthenticationSettings

JSON 표현 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
필드
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

출력 전용입니다. 등록 과정에서 사용자가 Google에 의해 인증되어야 하는지 여부입니다. IT 관리자는 지식 노동자 기기에 대해 Google 인증이 사용 설정되어 있는지 지정할 수 있습니다. 이 값은 Google 관리 콘솔을 통해서만 설정할 수 있습니다. Google 인증은 signin_url와 함께 사용할 수 있습니다. Google 인증이 필요하고 signin_url이 지정된 경우 Google 인증이 signin_url 전에 실행됩니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌