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 の Cloud プロジェクト 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)

出力専用。managed 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 でホストされているコンテンツの 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)

<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 のうち 1 つのみ、defaultStatus を SIGNIN_DETAIL_IS_DEFAULT に設定できます。Enterprise に 1 つ以上の signinDetails があり、そのいずれにも defaultStatus が SIGNIN_DETAIL_IS_DEFAULT に設定されていない場合、リストの最初の 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 が指定されている場合、signin_url の前に Google 認証が起動します。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌