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 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, comme suit:

Pour les clients de domaines gérés par Google, le processus implique d'utiliser Enterprises.enroll et Enterprises.setAccount (ainsi que des artefacts obtenus à partir de la console d'administration et de la console Google APIs), puis de les transmettre à l'EMM selon un processus plus ou moins manuel.
Pour les clients disposant d'un compte Google Play d'entreprise, le processus implique d'utiliser Enterprises.generateSignupUrl et Enterprises.completeSignup conjointement avec l'interface utilisateur d'inscription à Google Play d'entreprise (mécanisme fourni par Google) afin de créer la liaison sans intervention manuelle.

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

Nom de propriété	Valeur	Description
`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.
`id`	`string`	ID unique de l'entreprise.
`kind`	`string`
`name`	`string`	Nom de l'entreprise, par exemple "Example, Inc".
`primaryDomain`	`string`	Domaine principal de l'entreprise, tel que "example.com".

Méthodes

acknowledgeNotificationSet: Accepte les notifications reçues de Enterprises.PullNotificationSet pour empêcher le retour des appels ultérieurs les mêmes notifications.
completeSignup: Finalise le processus d'inscription, en spécifiant le jeton d'achèvement et Jeton d'entreprise. Cette demande ne doit pas être appelée plusieurs fois pour une entreprise donnée. Jeton.
createWebToken: Renvoie un jeton unique permettant d'accéder à une UI intégrable. Pour générer une UI Web, transmettez le jeton généré au code JavaScript Google Play d'entreprise API. Chaque jeton ne peut être utilisé que pour démarrer une seule session d'interface utilisateur. Consultez le la documentation de l'API JavaScript.
enregistrer: Inscrire 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 liée à l'entreprise en appelant setAccount. Le compte de service est propre à cette entreprise et à cette solution EMM, et sera supprimée si l'entreprise est illimité. 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 Enterprises.Register ou Enterprises.CompleteSignup et avant Enterprises.SetAccount; d'autres fois, il renverra une erreur.
:
Les appels suivants après le premier génèrent un nouvel ensemble unique de les identifiants générés précédemment, et invalider ces derniers.
:
Une fois le compte de service associé à l'entreprise, vous pouvez le gérer à l'aide de la ressource serviceAccountKeys.
getStoreLayout: Renvoie la mise en page de la boutique pour l'entreprise. Si l'agencement du magasin n'a pas été définie, renvoie "basic" comme type d'agencement de la boutique, page d'accueil.
liste: Recherche une entreprise par nom de domaine. Cette option n'est disponible que pour les entreprises créées via le processus de création. La recherche de l'ID n'est pas nécessaire pour les entreprises créées via le flux initié par l'EMM, puisqu'il apprend l'ID de l'entreprise dans spécifié dans l'appel Enterprises.generateSignupUrl.
pullNotificationSet: Extrait et renvoie un ensemble de notifications pour les entreprises associées à le compte de service authentifié pour la requête. La notification définie peut sera 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.ConfirmNotificationSet, à moins que le l'ensemble de notifications est vide.
Les notifications qui ne sont pas confirmées dans les 20 secondes seront à nouveau inclus dans la réponse à un autre PullNotificationSet et celles qui ne sont jamais confirmées seront supprimées conformément à la règle système Pub/Sub de Google Cloud Platform.
Plusieurs requêtes peuvent être effectuées simultanément pour récupérer notifications, auquel cas les notifications en attente (le cas échéant) seront réparties entre chaque appelant, le cas échéant.
En l'absence de notifications, une liste de notifications vide est renvoyée. Les requêtes suivantes peuvent renvoyer plus de notifications une fois qu'elles sont disponibles.
sendTestPushNotification: Vous envoie une notification test pour valider l'intégration EMM avec le service Google Cloud Pub/Sub pour cette entreprise.
setAccount: Définit le compte à utiliser pour l'authentification auprès de l'API en tant que pour les entreprises.
setStoreLayout: Définit la mise en page du magasin pour l'entreprise. Par défaut, storeLayoutType est défini sur "de base" ; et la disposition de base du magasin est activée. Principes de base ne contient que les applications approuvées par l'administrateur et ayant a été ajouté à l'ensemble de produits disponible pour un utilisateur (à l'aide de la méthode setAvailableProductSet Les applications sur la page sont triées par ordre de leur valeur d'ID produit. Si vous créez une mise en page de magasin personnalisée (en définissant storeLayoutType = "custom" et la configuration d'une page d'accueil), la mise en page est désactivée.
se désinscrire: Désinscrit une entreprise de l'EMM appelant.