MCP Tools Reference: Android Device Management MCP Server

Ferramenta: get_enterprise

Recebe uma empresa para um determinado ID. Exige o ID da empresa no campo "name" (por exemplo, enterprises/{enterpriseId}).

O exemplo a seguir demonstra como usar curl para invocar a ferramenta get_enterprise MCP.

Solicitação 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
}'

Esquema de entrada

Solicitação para receber uma empresa. Retorna todos os campos disponíveis.

GetEnterpriseRequest

Representação JSON 
{
  "name": string
}
Campos
name

string

O nome da empresa no formato enterprises/{enterpriseId}.

Esquema de saída

A configuração aplicada a uma empresa.

Enterprise

Representação 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)
}
Campos
name

string

O nome da empresa gerado pelo servidor durante a criação, no formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Os tipos de notificações do Google Pub/Sub ativadas para a empresa.
pubsubTopic

string

O tópico em que as notificações do Pub/Sub são publicadas, no formato projects/{project}/topics/{topic}. Esse campo só é obrigatório se as notificações do Pub/Sub estiverem ativadas.
primaryColor

integer

Uma cor no formato RGB que indica a cor predominante a ser exibida na interface do app de gerenciamento de dispositivos. Os componentes de cor são armazenados da seguinte forma: (red << 16) | (green << 8) | blue, em que o valor de cada componente está entre 0 e 255, inclusive.
logo

object (ExternalData)

Uma imagem exibida como um logotipo durante o provisionamento do dispositivo. Os tipos aceitos são: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

O nome da empresa exibido aos usuários. Esse campo tem um comprimento máximo de 100 caracteres.
termsAndConditions[]

object (TermsAndConditions)

Termos e condições que precisam ser aceitos ao provisionar um dispositivo para essa empresa. Uma página de termos é gerada para cada valor nessa lista.
appAutoApprovalEnabled
(deprecated)

boolean

Descontinuado e não usado.
signinDetails[]

object (SigninDetail)

Detalhes de login da empresa.
contactInfo

object (ContactInfo)

As informações de contato corporativo de uma empresa gerenciada por EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Configurações para autenticação de usuários fornecida pelo Google.
enterpriseType

enum (EnterpriseType)

Apenas saída. O tipo da empresa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Apenas saída. O tipo de um pacote de contas do Google Play gerenciado.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Apenas saída. O tipo de Managed Google Domain.

Int32Value

Representação JSON 
{
  "value": integer
}
Campos
value

integer

O valor int32.

ExternalData

Representação JSON 
{
  "url": string,
  "sha256Hash": string
}
Campos
url

string

O URL absoluto dos dados, que precisa usar o esquema http ou https. A Política de dispositivo Android não fornece credenciais na solicitação GET. Portanto, o URL precisa ser acessível publicamente. Incluir um componente longo e aleatório no URL pode ser usado para impedir que invasores descubram o URL.
sha256Hash

string

O hash SHA-256 codificado em base-64 do conteúdo hospedado no URL. Se o conteúdo não corresponder a esse hash, o Android Device Policy não vai usar os dados.

TermsAndConditions

Representação JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campos
header

object (UserFacingMessage)

Um cabeçalho curto que aparece acima do conteúdo HTML.
content

object (UserFacingMessage)

Uma string HTML bem formatada. Ele será analisado no cliente com android.text.Html#fromHtml.

UserFacingMessage

Representação JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campos
localizedMessages

map (key: string, value: string)

Um mapa que contém pares <localidade, mensagem>, em que a localidade é um código de idioma BCP 47 bem formado, como en-US, es-ES ou fr.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

A mensagem padrão exibida se nenhuma mensagem localizada for especificada ou se a localidade do usuário não corresponder a nenhuma das mensagens localizadas. Uma mensagem padrão precisa ser fornecida se houver mensagens localizadas.

LocalizedMessagesEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

SigninDetail

Representação 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.
}
Campos
signinUrl

string

URL de login para autenticação quando o dispositivo é provisionado com um token de registro de login. O endpoint de login precisa concluir o fluxo de autenticação com um URL no formato https://enterprise.google.com/android/enroll?et= para um login bem-sucedido ou https://enterprise.google.com/android/enroll/invalid para um login sem sucesso.
signinEnrollmentToken

string

Um token de inscrição em toda a empresa usado para acionar o fluxo de login personalizado. Este é um campo somente leitura gerado pelo servidor.
qrCode

string

Uma string JSON cuja representação UTF-8 pode ser usada para gerar um QR code e registrar um dispositivo com esse token de inscrição. Para registrar um dispositivo usando NFC, o registro NFC precisa conter uma representação serializada java.util.Properties das propriedades no JSON. Este é um campo somente leitura gerado pelo servidor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla se o uso pessoal é permitido em um dispositivo provisionado com esse token de inscrição.

Para dispositivos da empresa:

  • Ao ativar o uso pessoal, o usuário pode configurar um perfil de trabalho no dispositivo.
  • Para desativar o uso pessoal, o usuário precisa provisionar o dispositivo como totalmente gerenciado.

Para dispositivos pessoais:

  • Ao ativar o uso pessoal, o usuário pode configurar um perfil de trabalho no dispositivo.
  • A desativação do uso pessoal impede o provisionamento do dispositivo. Não é possível desativar o uso pessoal em dispositivos de propriedade pessoal.
defaultStatus

enum (SigninDetailDefaultStatus)

Opcional. Indica se o URL de login deve ser usado por padrão para a empresa. O SigninDetail com defaultStatus definido como SIGNIN_DETAIL_IS_DEFAULT é usado para o método de inscrição na Conta do Google. Apenas um dos signinDetails de uma empresa pode ter defaultStatus definido como SIGNIN_DETAIL_IS_DEFAULT. Se um Enterprise tiver pelo menos um signinDetails e nenhum deles tiver defaultStatus definido como SIGNIN_DETAIL_IS_DEFAULT, o primeiro da lista será selecionado e terá defaultStatus definido como SIGNIN_DETAIL_IS_DEFAULT. Se nenhum signinDetails for especificado para o Enterprise, o registro do dispositivo na Conta do Google vai falhar.

Campo de união _token_tag.

_token_tag pode ser apenas de um dos tipos a seguir:
tokenTag

string

Metadados especificados pela EMM para distinguir entre instâncias de SigninDetail.

ContactInfo

Representação JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campos
contactEmail

string

Endereço de e-mail de um ponto de contato, que será usado para enviar avisos importantes relacionados ao Google Play gerenciado.
dataProtectionOfficerName

string

O nome do oficial de proteção de dados.
dataProtectionOfficerEmail

string

O e-mail do oficial de proteção de dados. O e-mail é validado, mas não verificado.
dataProtectionOfficerPhone

string

O número de telefone do oficial de proteção de dados. O número de telefone é validado, mas não verificado.
euRepresentativeName

string

O nome do representante da UE.
euRepresentativeEmail

string

O e-mail do representante da UE. O e-mail é validado, mas não verificado.
euRepresentativePhone

string

O número de telefone do representante na UE. O número de telefone é validado, mas não verificado.

GoogleAuthenticationSettings

Representação JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Campos
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Apenas saída. Indica se os usuários precisam ser autenticados pelo Google durante o processo de inscrição. O admin de TI pode especificar se a autenticação do Google está ativada para a empresa em dispositivos de profissionais intelectuais. Esse valor só pode ser definido pelo Google Admin Console. A autenticação do Google pode ser usada com signin_url. Se ela for obrigatória e um signin_url for especificado, a autenticação do Google será iniciada antes de signin_url.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌