MCP Tools Reference: Android Device Management MCP Server

Outil : list_enterprises

Liste les entreprises accessibles à l'appelant.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_enterprises.

Requête 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
}'

Schéma d'entrée

Requête permettant de lister les entreprises gérées par un EMM.

ListEnterprisesRequest

Représentation JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
Champs
projectId

string

Obligatoire. ID du projet Cloud de l'EMM qui gère les entreprises.
pageSize

integer

La taille de page demandée. La taille réelle de la page peut être fixée à une valeur minimale ou maximale.
pageToken

string

Jeton identifiant une page de résultats renvoyée par le serveur.
view

enum (EnterpriseView)

Spécifie les champs Enterprise à renvoyer. Cette méthode n'accepte que BASIC.

Schéma de sortie

Réponse à une demande de liste des entreprises.

ListEnterprisesResponse

Représentation JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Champs
enterprises[]

object (Enterprise)

Liste des entreprises.
nextPageToken

string

Si d'autres résultats sont disponibles, un jeton permettant de récupérer la page de résultats suivante.

Enterprise

Représentation 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)
}
Champs
name

string

Nom de l'entreprise généré par le serveur lors de la création, au format enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Types de notifications Google Pub/Sub activées pour l'entreprise.
pubsubTopic

string

Sujet dans lequel les notifications Pub/Sub sont publiées, au format projects/{project}/topics/{topic}. Ce champ n'est obligatoire que si les notifications Pub/Sub sont activées.
primaryColor

integer

Couleur au format RVB qui indique la couleur prédominante à afficher dans l'UI de l'application de gestion des appareils. Les composants de couleur sont stockés comme suit : (red << 16) | (green << 8) | blue, où la valeur de chaque composant est comprise entre 0 et 255, inclus.
logo

object (ExternalData)

Image affichée en tant que logo lors du provisionnement de l'appareil. Les types acceptés sont les suivants : image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Nom de l'entreprise affiché pour les utilisateurs. Ce champ ne doit pas comporter plus de 100 caractères.
termsAndConditions[]

object (TermsAndConditions)

Conditions d'utilisation à accepter lors du provisionnement d'un appareil pour cette entreprise. Une page de conditions d'utilisation est générée pour chaque valeur de cette liste.
appAutoApprovalEnabled
(deprecated)

boolean

Obsolète et inutilisé.
signinDetails[]

object (SigninDetail)

Informations de connexion de l'entreprise.
contactInfo

object (ContactInfo)

Coordonnées de l'entreprise gérée par EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Paramètres pour l'authentification des utilisateurs fournie par Google.
enterpriseType

enum (EnterpriseType)

Uniquement en sortie. Type d'entreprise.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Uniquement en sortie. Type de compte d'entreprise Google Play Accounts.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Uniquement en sortie. Type de domaine Google géré.

Int32Value

Représentation JSON 
{
  "value": integer
}
Champs
value

integer

Valeur int32.

ExternalData

Représentation JSON 
{
  "url": string,
  "sha256Hash": string
}
Champs
url

string

URL absolue des données, qui doit utiliser le schéma http ou https. La règle relative aux appareils Android ne fournit aucun identifiant dans la requête GET. L'URL doit donc être accessible au public. L'inclusion d'un composant long et aléatoire dans l'URL peut être utilisée pour empêcher les pirates informatiques de la découvrir.
sha256Hash

string

Hachage SHA-256 encodé en base64 du contenu hébergé à l'URL. Si le contenu ne correspond pas à ce hachage, Android Device Policy n'utilisera pas les données.

TermsAndConditions

Représentation JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Champs
header

object (UserFacingMessage)

Bref en-tête qui s'affiche au-dessus du contenu HTML.
content

object (UserFacingMessage)

Chaîne HTML bien mise en forme. Il sera analysé sur le client avec android.text.Html#fromHtml.

UserFacingMessage

Représentation JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Champs
localizedMessages

map (key: string, value: string)

Map contenant des paires <locale, message>, où "locale" est un code de langue BCP 47 bien formé, tel que en-US, es-ES ou fr.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Message par défaut affiché si aucun message localisé n'est spécifié ou si le code de langue de l'utilisateur ne correspond à aucun des messages localisés. Un message par défaut doit être fourni si des messages localisés sont fournis.

LocalizedMessagesEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

SigninDetail

Représentation 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.
}
Champs
signinUrl

string

URL de connexion pour l'authentification lorsque l'appareil est provisionné avec un jeton d'enregistrement de connexion. Le point de terminaison de connexion doit terminer le flux d'authentification avec une URL au format https://enterprise.google.com/android/enroll?et= en cas de connexion réussie ou https://enterprise.google.com/android/enroll/invalid en cas d'échec de la connexion.
signinEnrollmentToken

string

Jeton d'enregistrement à l'échelle de l'entreprise utilisé pour déclencher un flux de connexion personnalisé. Il s'agit d'un champ en lecture seule généré par le serveur.
qrCode

string

Chaîne JSON dont la représentation UTF-8 peut être utilisée pour générer un code QR permettant d'enregistrer un appareil avec ce jeton d'enregistrement. Pour enregistrer un appareil à l'aide de la technologie NFC, l'enregistrement NFC doit contenir une représentation java.util.Properties sérialisée des propriétés du fichier JSON. Il s'agit d'un champ en lecture seule généré par le serveur.
allowPersonalUsage

enum (AllowPersonalUsage)

Détermine si l'utilisation personnelle est autorisée sur un appareil provisionné avec ce jeton d'enregistrement.

Pour les appareils détenus par l'entreprise :

  • L'activation de l'utilisation personnelle permet à l'utilisateur de configurer un profil professionnel sur l'appareil.
  • Pour désactiver l'utilisation personnelle, l'utilisateur doit provisionner l'appareil en tant qu'appareil entièrement géré.

Pour les appareils personnels :

  • L'activation de l'utilisation personnelle permet à l'utilisateur de configurer un profil professionnel sur l'appareil.
  • Si vous désactivez l'utilisation personnelle, l'appareil ne pourra pas être provisionné. L'utilisation personnelle ne peut pas être désactivée sur un appareil personnel.
defaultStatus

enum (SigninDetailDefaultStatus)

Facultatif. Indique si l'URL de connexion doit être utilisée par défaut pour l'entreprise. Le SigninDetail avec defaultStatus défini sur SIGNIN_DETAIL_IS_DEFAULT est utilisé pour la méthode d'inscription au compte Google. Seul l'un des signinDetails d'une entreprise peut avoir defaultStatus défini sur SIGNIN_DETAIL_IS_DEFAULT. Si un Enterprise comporte au moins un signinDetails et qu'aucun d'eux n'a la valeur SIGNIN_DETAIL_IS_DEFAULT pour defaultStatus, le premier de la liste est sélectionné et la valeur SIGNIN_DETAIL_IS_DEFAULT est attribuée à defaultStatus. Si aucun signinDetails n'est spécifié pour le Enterprise, l'enregistrement de l'appareil dans le compte Google échouera.

Champ d'union _token_tag.

_token_tag ne peut être qu'un des éléments suivants :
tokenTag

string

Métadonnées spécifiées par l'EMM pour faire la distinction entre les instances de SigninDetail.

ContactInfo

Représentation JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Champs
contactEmail

string

Adresse e-mail d'un point de contact, qui sera utilisée pour envoyer des annonces importantes concernant Google Play géré.
dataProtectionOfficerName

string

Nom du délégué à la protection des données.
dataProtectionOfficerEmail

string

Adresse e-mail du délégué à la protection des données. L'adresse e-mail est validée, mais pas vérifiée.
dataProtectionOfficerPhone

string

Numéro de téléphone du délégué à la protection des données Le numéro de téléphone est validé, mais pas vérifié.
euRepresentativeName

string

Nom du représentant dans l'UE.
euRepresentativeEmail

string

Adresse e-mail du représentant dans l'UE. L'adresse e-mail est validée, mais pas vérifiée.
euRepresentativePhone

string

Numéro de téléphone du représentant dans l'UE. Le numéro de téléphone est validé, mais pas vérifié.

GoogleAuthenticationSettings

Représentation JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Champs
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Uniquement en sortie. Indique si les utilisateurs doivent être authentifiés par Google lors du processus d'inscription. L'administrateur informatique peut spécifier si l'authentification Google est activée pour l'entreprise sur les appareils des travailleurs du savoir. Cette valeur ne peut être définie que dans la console d'administration Google. L'authentification Google peut être utilisée avec signin_url. Si l'authentification Google est requise et qu'un signin_url est spécifié, l'authentification Google sera lancée avant signin_url.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌