REST Resource: enterprises

Ressource: Enterprise

Configuration appliquée à une entreprise.

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)
  }
}
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 dominante à afficher dans l'interface utilisateur 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.

enterpriseDisplayName

string

Nom de l'entreprise présenté aux 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 termes est générée pour chaque valeur de cette liste.

appAutoApprovalEnabled
(deprecated)

boolean

Obsolète et non utilisé.

signinDetails[]

object (SigninDetail)

Informations de connexion de l'entreprise.

contactInfo

object (ContactInfo)

Coordonnées d'une entreprise gérée par une solution EMM

googleAuthenticationSettings

object (GoogleAuthenticationSettings)

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

NotificationType

Types de notifications que le serveur de gestion des appareils peut envoyer via Google Pub/Sub.

Enums
NOTIFICATION_TYPE_UNSPECIFIED Cette valeur est ignorée.
ENROLLMENT Notification envoyée lorsqu'un appareil est enregistré.
COMPLIANCE_REPORT

Obsolète.

STATUS_REPORT Notification envoyée lorsqu'un appareil émet un rapport d'état.
COMMAND Notification envoyée lorsqu'une commande de l'appareil est terminée.
USAGE_LOGS Notification envoyée lorsque l'appareil envoie BatchUsageLogEvents.

ExternalData

Données hébergées sur un emplacement externe. Les données doivent être téléchargées par Android Device Policy et comparées au hachage.

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

string

URL absolue des données, qui doit utiliser le schéma http ou https. Android Device Policy ne fournit aucun identifiant dans la requête GET. L'URL doit donc être accessible publiquement. L'inclusion d'un long composant aléatoire dans l'URL peut permettre d'empêcher les pirates informatiques de la découvrir.

sha256Hash

string

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

TermsAndConditions

Page des conditions d'utilisation à accepter lors du provisionnement.

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

object (UserFacingMessage)

En-tête court qui s'affiche au-dessus du contenu HTML.

content

object (UserFacingMessage)

Chaîne HTML correctement mise en forme. Il est analysé sur le client avec android.text.HTML#fromHTML.

SigninDetail

Ressource contenant les informations de connexion d'une entreprise. Utilisez enterprises pour gérer les SigninDetail d'une entreprise donnée.

Pour une entreprise, nous pouvons avoir un nombre illimité de SigninDetail, identifiés de manière unique par la combinaison des trois champs suivants (signinUrl, allowPersonalUsage, tokenTag). Il n'est pas possible de créer deux SigninDetails avec le même (signinUrl, allowPersonalUsage, tokenTag). (Le champ tokenTag est facultatif.

Patch: l'opération met à jour la liste actuelle des SigninDetails avec la nouvelle liste de SigninDetails.

  • Si la configuration SigninDetail stockée est transmise, elle renvoie les mêmes valeurs signinEnrollmentToken et qrCode.
  • Si nous transmettons plusieurs configurations SigninDetail identiques qui ne sont pas stockées, la première des configurations SigninDetail sera stockée.
  • Si la configuration existe déjà, nous ne pouvons pas la demander plusieurs fois dans un appel particulier de l'API patch. Sinon, une erreur de clé en double sera renvoyée et l'ensemble de l'opération échouera.
  • Si nous supprimons certaines configurations SigninDetail de la requête, elles seront supprimées de l'espace de stockage. Nous pouvons ensuite demander d'autres signinEnrollmentToken et qrCode pour la même configuration SigninDetail.
Représentation JSON
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
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 processus d'authentification avec une URL au format https://enterprise.google.com/android/enroll?et= pour une connexion réussie, ou https://enterprise.google.com/android/enroll/invalid en cas d'échec de 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 dans le 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 fourni avec ce jeton d'enregistrement.

Pour les appareils détenus par l'entreprise:

  • Le fait d'autoriser 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:

  • Le fait d'autoriser l'utilisation personnelle permet à l'utilisateur de configurer un profil professionnel sur l'appareil.
  • La désactivation de l'utilisation personnelle empêchera le provisionnement de l'appareil. 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'enregistrement d'un compte Google. Vous ne pouvez définir defaultStatus sur SIGNIN_DETAIL_IS_DEFAULT que pour une seule signinDetails d'une entreprise. Si une Enterprise comporte au moins un élément signinDetails et qu'aucun d'entre eux n'a défini de defaultStatus sur SIGNIN_DETAIL_IS_DEFAULT, le premier élément de la liste est sélectionné et a défini defaultStatus sur SIGNIN_DETAIL_IS_DEFAULT. Si aucun signinDetails n'est spécifié pour Enterprise, l'enregistrement de l'appareil avec le compte Google échouera.

tokenTag

string

Métadonnées spécifiées par l'EMM pour distinguer les instances de SigninDetail.

SigninDetailDefaultStatus

Indique si l'URL de connexion doit être utilisée par défaut pour l'entreprise.

Enums
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Équivaut à SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT L'URL de connexion sera utilisée par défaut pour l'entreprise.
SIGNIN_DETAIL_IS_NOT_DEFAULT L'URL de connexion ne sera pas utilisée par défaut pour l'entreprise.

ContactInfo

Coordonnées des entreprises Google Play d'entreprise

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 contact, qui sera utilisée pour envoyer des annonces importantes concernant Google Play d'entreprise.

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 validé.

euRepresentativeName

string

Nom du représentant pour l'UE.

euRepresentativeEmail

string

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

euRepresentativePhone

string

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

GoogleAuthenticationSettings

Contient les paramètres d'authentification de l'utilisateur fournie par Google.

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

enum (GoogleAuthenticationRequired)

Uniquement en sortie. Indique si les utilisateurs doivent être authentifiés par Google pendant le processus d'enregistrement. 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 via la console d'administration Google. L'authentification Google peut être utilisée avec signinUrl. Si l'authentification Google est requise et qu'un signinUrl est spécifié, l'authentification Google sera lancée avant signinUrl.

GoogleAuthenticationRequired

Paramètre déterminant si l'authentification Google est requise pour cette entreprise.

Enums
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Cette valeur n'est pas utilisée.
NOT_REQUIRED L'authentification Google n'est pas requise.
REQUIRED L'utilisateur doit être authentifié par Google.

Méthodes

create

Crée une entreprise.

delete

Supprime définitivement une entreprise, ainsi que l'ensemble des comptes et des données qui lui sont associés.

get

Permet de créer une entreprise.

list

Liste les entreprises gérées par une solution EMM.

patch

Met à jour une entreprise.