Enterprises

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Une ressource "Enterprises" représente le lien entre un EMM et une organisation spécifique. Cette liaison peut être instanciée de deux manières différentes à l'aide de cette API :

• Pour les clients disposant d'un domaine géré par Google, le processus consiste à utiliser Enterprises.enroll et Enterprises.setAccount (en association avec les artefacts obtenus à partir de la console d'administration et de la console Google APIs) et à les envoyer à l'EMM via un processus plus ou moins manuel.
• Pour les clients disposant d'un compte Google Play géré, le processus consiste à utiliser Enterprises.generateSignupUrl et Enterprises.completeSignup en association avec l'UI d'inscription Google Play géré (mécanisme fourni par Google) pour créer l'association sans étapes manuelles.

 En tant qu'EMM, vous pouvez prendre en charge l'une ou l'autre de ces approches dans votre console EMM. Pour en savoir plus, consultez Créer une entreprise.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nom de propriété	Valeur	Description	Remarques
administrator[]	list	Administrateurs de l'entreprise Cette option n'est disponible que pour les entreprises créées via le flux initié par l'EMM.
administrator[].email	string	Adresse e-mail de l'administrateur.
enterpriseType	string	Type d'entreprise. Les valeurs acceptées sont les suivantes : "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings	nested object	Paramètres pour l'authentification des utilisateurs fournie par Google.
googleAuthenticationSettings.createdAt	nested object	Code temporel de la création ou de la modification des paramètres.
googleAuthenticationSettings.createdAt.nanos	integer	Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.
googleAuthenticationSettings.createdAt.seconds	long	Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z inclus.
googleAuthenticationSettings.dedicatedDevicesAllowed	string	Indique si les appareils dédiés sont autorisés. Les valeurs acceptées sont les suivantes : "allowed" "dedicatedDevicesAllowedUnspecified" "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired	string	Indique si l'authentification Google est requise. Les valeurs acceptées sont les suivantes : "googleAuthenticationRequiredUnspecified" "notRequired" "required"
googleAuthenticationSettings.updatedAt	nested object	Code temporel de la dernière modification des paramètres.
googleAuthenticationSettings.updatedAt.nanos	integer	Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.
googleAuthenticationSettings.updatedAt.seconds	long	Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z inclus.
id	string	Identifiant unique de l'entreprise.
id	string	Identifiant unique de l'entreprise.
kind	string
managedGoogleDomainType	string	Type de domaine Google géré Les valeurs acceptées sont les suivantes : "managedGoogleDomainTypeUnspecified" "typeDomain" "typeTeam"
name	string	Nom de l'entreprise, par exemple "Exemple, Inc".
primaryDomain	string	Domaine principal de l'entreprise, tel que "example.com".

Méthodes

acknowledgeNotificationSet

 Accuse réception des notifications reçues de Enterprises.PullNotificationSet pour empêcher les appels ultérieurs de renvoyer les mêmes notifications.

completeSignup

Finalise le processus d'inscription en spécifiant le jeton de finalisation et le jeton d'entreprise. Cette requête ne doit pas être appelée plusieurs fois pour un jeton Enterprise donné.

createWebToken

Renvoie un jeton unique permettant d'accéder à une UI intégrable. Pour générer une interface utilisateur Web, transmettez le jeton généré à l'API JavaScript Managed Google Play. Chaque jeton ne peut être utilisé que pour démarrer une seule session d'UI. Pour en savoir plus, consultez la documentation de l'API JavaScript.

enroll

Inscrit une entreprise auprès de l'EMM appelant.

generateEnterpriseUpgradeUrl

Génère une URL de mise à niveau d'entreprise pour mettre à niveau un compte d'entreprise Google Play Accounts existant vers un domaine Google géré. Pour en savoir plus, consultez le guide de mise à niveau d'une entreprise.

generateSignupUrl

Génère une URL d'inscription.

get

Récupère le nom et le domaine d'une entreprise.

getServiceAccount

Renvoie un compte de service et des identifiants. Le compte de service peut être associé à l'entreprise en appelant setAccount. Le compte de service est propre à cette entreprise et à cet EMM. Il sera supprimé si l'entreprise est dissociée. Les identifiants contiennent des données de clé privée et ne sont pas stockés côté serveur.

Cette méthode ne peut être appelée qu'après l'appel de Enterprises.Enroll ou Enterprises.CompleteSignup, et avant Enterprises.SetAccount. Dans le cas contraire, elle renvoie une erreur.

Les appels suivants génèrent un nouvel ensemble unique d'identifiants et invalident ceux générés précédemment.

Une fois le compte de service associé à l'entreprise, il peut être géré à l'aide de la ressource serviceAccountKeys.

Remarque : Après avoir créé une clé, vous devrez peut-être attendre au moins 60 secondes avant d'effectuer une autre opération avec la clé. Si vous tentez d'effectuer une opération avec la clé immédiatement après sa création et que vous recevez une erreur, vous pouvez relancer la requête avec un intervalle exponentiel entre les tentatives.

.

getStoreLayout

Renvoie la disposition du magasin pour l'entreprise. Si la mise en page du magasin n'a pas été définie, la fonction renvoie "basic" comme type de mise en page du magasin et aucune page d'accueil.

liste

Recherche une entreprise par nom de domaine. Cette option n'est disponible que pour les entreprises créées via le flux de création initié par Google. La recherche de l'ID n'est pas nécessaire pour les entreprises créées via le flux initié par l'EMM, car l'EMM apprend l'ID d'entreprise dans le rappel spécifié dans l'appel Enterprises.generateSignupUrl.

pullNotificationSet

Extrait et renvoie un ensemble de notifications pour les entreprises associées au compte de service authentifié pour la requête. L'ensemble de notifications peut être vide si aucune notification n'est en attente.
Un ensemble de notifications renvoyé doit être confirmé dans les 20 secondes en appelant Enterprises.AcknowledgeNotificationSet, sauf si l'ensemble de notifications est vide.
Les notifications qui ne sont pas confirmées dans les 20 secondes seront de nouveau incluses dans la réponse à une autre requête PullNotificationSet. Celles qui ne sont jamais confirmées seront finalement supprimées conformément au règlement du système Google Cloud Platform Pub/Sub.
Plusieurs requêtes peuvent être effectuées simultanément pour récupérer les notifications. Dans ce cas, les notifications en attente (le cas échéant) seront réparties entre chaque appelant, s'il y en a.
Si aucune notification n'est présente, une liste de notifications vide est renvoyée. Les demandes ultérieures peuvent renvoyer plus de notifications une fois qu'elles sont disponibles.

sendTestPushNotification

Envoie une notification de test pour valider l'intégration de l'EMM au service Google Cloud Pub/Sub pour cette entreprise.

setAccount

Définit le compte qui sera utilisé pour s'authentifier auprès de l'API en tant qu'entreprise.

setStoreLayout

Définit la mise en page du magasin pour l'entreprise. Par défaut, storeLayoutType est défini sur "basic" et la mise en page de base du magasin est activée. La mise en page de base ne contient que les applications approuvées par l'administrateur et qui ont été ajoutées à l'ensemble de produits disponibles pour un utilisateur (à l'aide de l'appel setAvailableProductSet). Les applications sur la page sont triées par ordre de valeur de leur ID de produit. Si vous créez une mise en page personnalisée pour votre magasin (en définissant storeLayoutType sur "custom" et en définissant une page d'accueil), la mise en page de base du magasin est désactivée.

se désinscrire

Désinscrit une entreprise de l'EMM appelant.