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 Entreprises représente la liaison entre un fournisseur 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 l'utilisation de Enterprises.enroll et de Enterprises.setAccount (ainsi que les artefacts obtenus dans la console d'administration et la console Google APIs) et envoyés à l'EMM par le biais d'un processus plus ou moins manuel.
• Pour les clients de comptes Google Play d'entreprise, le processus implique d'utiliser Enterprises.generateSignupUrl et Enterprises.completeSignup avec l'interface utilisateur d'inscription à Google Play d'entreprise (mécanisme fourni par Google) pour créer la liaison sans étapes manuelles.

En tant qu'EMM, vous pouvez utiliser l'une ou l'autre des 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	Notes
administrator[]	list	Administrateurs de l'entreprise. Cette option n'est disponible que pour les entreprises créées via le flux initié par EMM.
administrator[].email	string	Adresse e-mail de l'administrateur.
id	string	Identifiant 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 les appels suivants de renvoyer les mêmes notifications.

completeSignup

Achèvement le processus d'inscription en spécifiant le jeton de réussite 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égrable. Pour générer une interface utilisateur Web, transmettez le jeton généré à l'API JavaScript Google Play d'entreprise. Chaque jeton ne peut être utilisé que pour démarrer une session d'UI. Pour en savoir plus, consultez la documentation de l'API JavaScript.

s'inscrire

Inscri une entreprise auprès de l'EMM à l'origine de l'appel.

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é à l'entreprise en appelant setAccount. Le compte de service est propre à cette entreprise et à cette EMM. Il sera supprimé si l'entreprise n'est pas 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 avoir appelé Enterprises.enroll ou Enterprises.CompleteSignup, et avant Enterprises.SetAccount. Dans les autres cas, elle renvoie une erreur.

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

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

getStoreLayout

Renvoie la mise en page du magasin de l'entreprise. Si l'agencement du magasin n'a pas été défini, renvoie "standard" comme type d'agencement du magasin et aucune page d'accueil n'est définie.

liste

Recherche une entreprise en fonction de son 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 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 non confirmées dans les 20 secondes sont à nouveau incluses dans la réponse à une autre requête PullNotificationSet, et celles qui n'ont jamais été 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 les notifications. Dans ce cas, les notifications en attente (le cas échéant) seront réparties entre chaque appelant, le cas échéant.
Si aucune notification n'est présente, une liste de notifications vide est renvoyée. Les requêtes suivantes peuvent renvoyer davantage de notifications une fois qu'elles sont disponibles.

sendTestPushNotification

Envoie une notification de test pour valider l'intégration 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 l'agencement du magasin de 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 disponible pour un utilisateur (à l'aide de l'appel setAvailableProductSet). Les applications sur la page sont triées par ordre de valeur d'ID produit. Si vous créez une mise en page personnalisée du magasin (en définissant storeLayoutType = "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 à l'origine de l'appel.