Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play. En savoir plus

Cette page a été traduite par l'API Cloud Translation.

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 Enterprise représente l'association 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, comme suit:

Pour les clients disposant d'un domaine géré par Google, le processus implique d'utiliser Enterprises.enroll et Enterprises.setAccount (en plus des artefacts obtenus à partir de la console d'administration et de la console Google API) et d'envoyer les informations à l'EMM via un processus plus ou moins manuel.
Pour les clients disposant de comptes Google Play gérés, le processus consiste à utiliser Enterprises.generateSignupUrl et Enterprises.completeSignup en conjonction avec l'interface utilisateur de connexion Google Play gérée (mécanisme fourni par Google) pour créer l'association sans étapes manuelles.

En tant qu'EMM, vous pouvez accepter l'une ou les deux 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
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

Nom de propriété	Valeur	Description
`administrator[]`	`list`	Administrateurs de l'entreprise Cette fonctionnalité n'est disponible que pour les entreprises créées via le flux lancé 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`"
`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, par exemple "example.com".

Méthodes

acknowledgeNotificationSet: Confirme les notifications reçues de Enterprise.PullNotificationSet pour empêcher les appels suivants de renvoyer les mêmes notifications.
completeSignup: Termine le parcours 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 d'entreprise donné.
createWebToken: Renvoie un jeton unique pour accéder à une UI intégrée. Pour générer une UI Web, transmettez le jeton généré à l'API JavaScript Google Play gérée. Chaque jeton ne peut être utilisé que pour démarrer une seule session d'interface utilisateur. Pour en savoir plus, consultez la Documentation de l'API JavaScript.
s'inscrire: Inscris une entreprise auprès de l'EMM appelant.
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 à l'EMM, et sera supprimé si l'entreprise n'est plus associé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 après le premier génèrent un nouvel ensemble d'identifiants uniques et invalident les identifiants précédemment générés.

Une fois le compte de service associé à l'entreprise, il peut être géré à l'aide de la ressource serviceAccountKeys.
getStoreLayout: Renvoie la mise en page du magasin pour l'entreprise. Si la mise en page du magasin n'a pas été définie, le type de mise en page du magasin est défini sur "standard" et aucune page d'accueil n'est renvoyée.
liste: Recherche une entreprise par nom de domaine. Cette fonctionnalité n'est disponible que pour les entreprises créées via le flux de création lancé 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 de l'entreprise dans le rappel spécifié dans l'appel Enterprises.generateSignupUrl.
pullNotificationSet: Récupère 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 un délai de 20 secondes en appelant Enterprises.AcknowledgeNotificationSet, sauf si l'ensemble de notifications est vide.
Les notifications qui ne sont pas confirmées dans un délai de 20 secondes seront finalement incluses à nouveau dans la réponse à une autre requête PullNotificationSet, et celles qui ne sont jamais confirmées seront finalement supprimées conformément au règlement du système Google Cloud Platform Pub/Sub.
Des requêtes multiples peuvent être effectuées simultanément pour récupérer des notifications. Dans ce cas, les notifications en attente (le cas échéant) seront réparties entre chaque appelant.
Si aucune notification n'est présente, une liste de notifications vide est renvoyée. Les requêtes ultérieures peuvent renvoyer d'autres notifications une fois qu'elles sont disponibles.
sendTestPushNotification: Envoi d'une notification de test pour valider l'intégration de l'EMM au service Google Cloud Pub/Sub de 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" (standard) et la mise en page de base 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 de la page sont triées par ordre de valeur de l'ID produit. Si vous créez une mise en page de magasin personnalisée (en définissant storeLayoutType = "custom" et en définissant une page d'accueil), la mise en page de magasin de base est désactivée.
désinscription: Désinscrit une entreprise de l'EMM appelant.