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)
  }
}
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 indiquant la couleur principale à 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 devant être acceptées 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 inutilisé.
signinDetails[]

object (SigninDetail)

les informations de connexion de l'entreprise ;
contactInfo

object (ContactInfo)

Coordonnées d'une entreprise gérée par un fournisseur EMM.

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 lors de l'enregistrement d'un appareil.
COMPLIANCE_REPORT

Obsolète.
STATUS_REPORT Notification envoyée lorsqu'un appareil émet un rapport d'état.
COMMAND Notification envoyée lorsque la commande d'un 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 via Android Device Policy et comparées au hachage.

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

string

URL absolue vers les 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)

Un en-tête court qui apparaît au-dessus du contenu HTML.
content

object (UserFacingMessage)

Chaîne HTML au format correct. Elle sera analysée 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.

Dans une entreprise, nous pouvons avoir un nombre illimité de SigninDetails 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 SigninDetail avec le même champ (signinUrl, allowPersonalUsage, tokenTag). tokenTag est un champ 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 signinEnrollmentToken et qrCode.
  • Si nous transmettons plusieurs configurations SigninDetail identiques qui ne sont pas stockées, la première configuration parmi ces configurations SigninDetail est stockée.
  • Si la configuration existe déjà, nous ne pouvons pas la demander plusieurs fois dans un appel d'API patch particulier. Dans le cas contraire, une erreur de clé en double sera générée, et toute 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),
  "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 flux 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.
signinEnrollmentToken

string

Jeton d'enregistrement à l'échelle de l'entreprise utilisé pour déclencher le 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 afin 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 provisionné avec ce jeton d'enregistrement.

Pour les appareils détenus par l'entreprise:

  • Si vous activez l'utilisation personnelle, l'utilisateur peut configurer un profil professionnel sur l'appareil.
  • Désactiver l'utilisation personnelle nécessite que l'utilisateur provisionne l'appareil en tant qu'appareil entièrement géré.

Pour les appareils personnels:

  • Si vous activez l'utilisation personnelle, l'utilisateur peut configurer un profil professionnel sur l'appareil.
  • La désactivation de l'utilisation personnelle empêche le provisionnement de l'appareil. L'utilisation personnelle ne peut pas être désactivée sur les appareils personnels.
tokenTag

string

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

ContactInfo

Coordonnées pour les 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 du 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 validé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 dans l'UE.
euRepresentativeEmail

string

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

string

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

Méthodes

create

 Crée une entreprise.

delete

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

get

 Récupère une entreprise.

list

 Liste des entreprises gérées par EMM.

patch

 Met à jour une entreprise.