MCP Tools Reference: Android Device Management MCP Server

Инструмент: get_enterprise

Получает информацию о предприятии по заданному идентификатору предприятия. Требуется указать идентификатор предприятия в поле имени (например, 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
}'

Схема ввода

Запрос на получение информации о предприятии. Возвращает все доступные поля.

GetEnterpriseRequest

JSON-представление 
{
  "name": string
}
Поля
name

string

Название предприятия в формате enterprises/{enterpriseId} .

Схема вывода

Конфигурация, применяемая к предприятию.

Предприятие

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, указывающий преобладающий цвет для отображения в пользовательском интерфейсе приложения управления устройством. Компоненты цвета хранятся следующим образом: (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.

Внешние данные

JSON-представление 
{
  "url": string,
  "sha256Hash": string
}
Поля
url

string

Абсолютный URL-адрес данных, который должен использовать либо схему http, либо https. Политика устройств Android не предоставляет никаких учетных данных в запросе GET, поэтому URL-адрес должен быть общедоступным. Включение длинного случайного компонента в URL-адрес может использоваться для предотвращения обнаружения URL-адреса злоумышленниками.

sha256Hash

string

Хэш SHA-256 в кодировке Base-64 содержимого, размещенного по указанному URL-адресу. Если содержимое не соответствует этому хешу, политика устройств Android не будет использовать данные.

Условия и положения

JSON-представление 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Поля
header

object ( UserFacingMessage )

Короткий заголовок, который отображается над HTML-контентом.

content

object ( UserFacingMessage )

Правильно отформатированная HTML-строка. Она будет обработана на стороне клиента с помощью метода android.text.Html#fromHtml.

Пользовательское сообщение

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

Сообщение по умолчанию отображается, если локализованное сообщение не указано или язык пользователя не совпадает ни с одним из локализованных сообщений. Если локализованные сообщения указаны, необходимо указать сообщение по умолчанию.

ЛокализованныеСообщенияВвод

JSON-представление 
{
  "key": string,
  "value": string
}
Поля
key

string

value

string

Подробная информация о входе

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-адрес для аутентификации при наличии на устройстве токена регистрации. Конечная точка входа должна завершить процесс аутентификации, передав URL-адрес в формате https://enterprise.google.com/android/enroll?et= Для успешного входа в систему используйте ссылку https://enterprise.google.com/android/enroll/invalid , а для неудачного — https://enterprise.google.com/android/enroll/invalid.

signinEnrollmentToken

string

Токен регистрации, используемый в масштабах всего предприятия для запуска пользовательского процесса входа в систему. Это поле только для чтения, генерируемое сервером.

qrCode

string

Строка JSON, представление которой в кодировке UTF-8 может быть использовано для генерации QR-кода для регистрации устройства с помощью этого токена регистрации. Для регистрации устройства с использованием NFC запись NFC должна содержать сериализованное представление свойств из JSON в формате java.util.Properties . Это поле только для чтения, генерируемое сервером.

allowPersonalUsage

enum ( AllowPersonalUsage )

Определяет, разрешено ли личное использование на устройстве, которому присвоен этот регистрационный токен.

Для устройств, принадлежащих компании:

  • Включение персонального использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Для отключения персонального использования пользователю необходимо настроить устройство как полностью управляемое.

Для личных устройств:

  • Включение персонального использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Отключение персонального использования не позволит устройству выполнить инициализацию. Отключение персонального использования на личном устройстве невозможно.
defaultStatus

enum ( SigninDetailDefaultStatus )

Необязательный параметр. Указывает, следует ли использовать URL-адрес входа по умолчанию для предприятия. Для метода регистрации учетной записи Google используется объект SigninDetail с defaultStatus , установленным в SIGNIN_DETAIL_IS_DEFAULT . Только один из signinDetails предприятия может иметь defaultStatus установленный в SIGNIN_DETAIL_IS_DEFAULT . Если у Enterprise есть хотя бы один signinDetails , и ни у одного из них нет defaultStatus установленного в SIGNIN_DETAIL_IS_DEFAULT , то выбирается первый из списка, у которого defaultStatus установлен в SIGNIN_DETAIL_IS_DEFAULT . Если для Enterprise не указан signinDetails , регистрация устройства с учетной записью Google завершится неудачей.

Поле объединения _token_tag .

_token_tag может принимать только одно из следующих значений:

tokenTag

string

Метаданные, заданные EMM, для различения экземпляров SigninDetail .

Контактная информация

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

Номер телефона представителя ЕС. Номер телефона подтвержден, но не проверен.

Настройки аутентификации Google

JSON-представление 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Поля
googleAuthenticationRequired

enum ( GoogleAuthenticationRequired )

Только вывод. Требуется ли аутентификация пользователей через Google в процессе регистрации. ИТ-администратор может указать, включена ли аутентификация Google для корпоративных устройств сотрудников, работающих с информацией. Это значение можно установить только через консоль администратора Google. Аутентификация Google может использоваться с signin_url В случае, если требуется аутентификация Google и указан signin_url , аутентификация Google будет запущена до signin_url .

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌