MCP Tools Reference: Android Device Management MCP Server

Strumento: get_enterprise

Recupera un'azienda per un determinato ID azienda. Richiede l'ID enterprise nel campo del nome (ad es. enterprises/{enterpriseId}).

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_enterprise.

Curl Request 
                  
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
}'

Schema di input

Richiedi di ottenere un'organizzazione. Restituisce tutti i campi disponibili.

GetEnterpriseRequest

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Il nome dell'impresa nel modulo enterprises/{enterpriseId}.

Schema di output

La configurazione applicata a un'azienda.

Enterprise

Rappresentazione 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)
}
Campi
name

string

Il nome dell'impresa generato dal server durante la creazione, nel formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

I tipi di notifiche Google Pub/Sub abilitate per l'azienda.
pubsubTopic

string

L'argomento in cui vengono pubblicate le notifiche Pub/Sub, nel formato projects/{project}/topics/{topic}. Questo campo è obbligatorio solo se sono attivate le notifiche Pub/Sub.
primaryColor

integer

Un colore in formato RGB che indica il colore predominante da visualizzare nell'interfaccia utente dell'app di gestione dei dispositivi. I componenti del colore vengono memorizzati nel seguente modo: (red << 16) | (green << 8) | blue, dove il valore di ogni componente è compreso tra 0 e 255 inclusi.
logo

object (ExternalData)

Un'immagine visualizzata come logo durante il provisioning del dispositivo. I tipi supportati sono: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Il nome dell'azienda visualizzato dagli utenti. Questo campo ha una lunghezza massima di 100 caratteri.
termsAndConditions[]

object (TermsAndConditions)

Termini e condizioni che devono essere accettati durante il provisioning di un dispositivo per questa azienda. Viene generata una pagina di termini per ogni valore di questo elenco.
appAutoApprovalEnabled
(deprecated)

boolean

Deprecato e non utilizzato.
signinDetails[]

object (SigninDetail)

Dettagli di accesso dell'azienda.
contactInfo

object (ContactInfo)

I dati di contatto aziendali di un'azienda gestita da EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Impostazioni per l'autenticazione utente fornita da Google.
enterpriseType

enum (EnterpriseType)

Solo output. Il tipo di impresa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Solo output. Il tipo di account Google Play gestito per l'azienda.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Solo output. Il tipo di dominio Google gestito.

Int32Value

Rappresentazione JSON 
{
  "value": integer
}
Campi
value

integer

Il valore int32.

ExternalData

Rappresentazione JSON 
{
  "url": string,
  "sha256Hash": string
}
Campi
url

string

L'URL assoluto dei dati, che deve utilizzare lo schema http o https. Android Device Policy non fornisce credenziali nella richiesta GET, pertanto l'URL deve essere accessibile pubblicamente. L'inclusione di un componente lungo e casuale nell'URL può essere utilizzata per impedire agli aggressori di scoprire l'URL.
sha256Hash

string

L'hash SHA-256 con codifica base-64 dei contenuti ospitati all'URL. Se i contenuti non corrispondono a questo hash, Android Device Policy non utilizzerà i dati.

TermsAndConditions

Rappresentazione JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campi
header

object (UserFacingMessage)

Una breve intestazione che viene visualizzata sopra i contenuti HTML.
content

object (UserFacingMessage)

Una stringa HTML ben formattata. Verrà analizzato sul client con android.text.Html#fromHtml.

UserFacingMessage

Rappresentazione JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campi
localizedMessages

map (key: string, value: string)

Una mappa contenente coppie <locale, messaggio>, dove locale è un codice di lingua BCP 47 ben formato, ad esempio en-US, es-ES o fr.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Il messaggio predefinito visualizzato se non viene specificato alcun messaggio localizzato o se le impostazioni internazionali dell'utente non corrispondono a nessuno dei messaggi localizzati. Se vengono forniti messaggi localizzati, è necessario fornire un messaggio predefinito.

LocalizedMessagesEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

SigninDetail

Rappresentazione 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.
}
Campi
signinUrl

string

URL di accesso per l'autenticazione quando il dispositivo viene sottoposto al provisioning con un token di registrazione per l'accesso. L'endpoint di accesso deve terminare il flusso di autenticazione con un URL nel formato https://enterprise.google.com/android/enroll?et= per un accesso riuscito o https://enterprise.google.com/android/enroll/invalid per un accesso non riuscito.
signinEnrollmentToken

string

Un token di registrazione a livello aziendale utilizzato per attivare il flusso di accesso personalizzato. Questo è un campo di sola lettura generato dal server.
qrCode

string

Una stringa JSON la cui rappresentazione UTF-8 può essere utilizzata per generare un codice QR per registrare un dispositivo con questo token di registrazione. Per registrare un dispositivo utilizzando la tecnologia NFC, il record NFC deve contenere una rappresentazione java.util.Properties serializzata delle proprietà nel JSON. Questo è un campo di sola lettura generato dal server.
allowPersonalUsage

enum (AllowPersonalUsage)

Controlla se l'utilizzo personale è consentito su un dispositivo sottoposto a provisioning con questo token di registrazione.

Per i dispositivi di proprietà aziendale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale richiede che l'utente esegua il provisioning del dispositivo come dispositivo completamente gestito.

Per i dispositivi di proprietà personale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • Se disattivi l'utilizzo personale, il dispositivo non verrà sottoposto al provisioning. L'utilizzo personale non può essere disattivato su un dispositivo di proprietà personale.
defaultStatus

enum (SigninDetailDefaultStatus)

Facoltativo. Indica se l'URL di accesso deve essere utilizzato per impostazione predefinita per l'azienda. SigninDetail con defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT viene utilizzato per il metodo di registrazione dell'Account Google. Solo uno dei signinDetails di un'azienda può avere defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT. Se un Enterprise ha almeno un signinDetails e nessuno di questi ha defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT, viene selezionato il primo dall'elenco e defaultStatus viene impostato su SIGNIN_DETAIL_IS_DEFAULT. Se non viene specificato alcun signinDetails per Enterprise, la registrazione del dispositivo dell'Account Google non andrà a buon fine.

Campo unione _token_tag.

_token_tag può essere solo uno dei seguenti tipi:
tokenTag

string

Metadati specificati dall'EMM per distinguere tra le istanze di SigninDetail.

ContactInfo

Rappresentazione JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campi
contactEmail

string

Indirizzo email di un punto di contatto, che verrà utilizzato per inviare importanti annunci relativi a Google Play gestito.
dataProtectionOfficerName

string

Il nome del responsabile della protezione dei dati.
dataProtectionOfficerEmail

string

L'email del responsabile della protezione dei dati. L'email è stata convalidata, ma non verificata.
dataProtectionOfficerPhone

string

Il numero di telefono del responsabile della protezione dei dati. Il numero di telefono è convalidato, ma non verificato.
euRepresentativeName

string

Il nome del rappresentante UE.
euRepresentativeEmail

string

L'email del rappresentante UE. L'email è stata convalidata, ma non verificata.
euRepresentativePhone

string

Il numero di telefono del rappresentante UE. Il numero di telefono è convalidato, ma non verificato.

GoogleAuthenticationSettings

Rappresentazione JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Campi
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Solo output. Indica se gli utenti devono essere autenticati da Google durante la procedura di registrazione. L'amministratore IT può specificare se l'autenticazione Google è attivata per l'azienda per i dispositivi dei lavoratori della conoscenza. Questo valore può essere impostato solo tramite la Console di amministrazione Google. L'autenticazione Google può essere utilizzata con signin_url. Nel caso in cui sia richiesta l'autenticazione Google e venga specificato un signin_url, l'autenticazione Google verrà avviata prima di signin_url.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌