Admin SDK: Directory API

L'API Directory du SDK Admin permet aux administrateurs des domaines de l'entreprise d'afficher et de gérer les utilisateurs, les groupes, les appareils et les ressources associées de leur organisation. Les API Cloud Identity offrent des moyens supplémentaires de gérer certaines de ces ressources.

Service: admin.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison du service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut disposer de plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://admin.googleapis.com

Ressource REST: asps

Méthodes
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
Supprime un ASP émis par un utilisateur.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Récupère des informations sur un ASP émis par un utilisateur.
list GET /admin/directory/v1/users/{userKey}/asps
Répertorie les ASP émis par un utilisateur.

Ressource REST: chromeosdevices

Méthodes
action
(deprecated)
POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Utilisez plutôt BatchChangeChromeOsDeviceStatus.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Récupère les propriétés d'un appareil Chrome OS.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Récupère une liste paginée des appareils Chrome OS d'un compte.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Déplace ou insère plusieurs appareils Chrome OS dans une unité organisationnelle.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Met à jour les propriétés pouvant être mises à jour d'un appareil, telles que annotatedUser, annotatedLocation, notes, orgUnitPath ou annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Met à jour les propriétés pouvant être mises à jour d'un appareil, telles que annotatedUser, annotatedLocation, notes, orgUnitPath ou annotatedAssetId.

Ressource REST: customer.devices.chromeos

Méthodes
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
Modifie l'état d'un lot d'appareils ChromeOS.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Émet une commande à exécuter par l'appareil.

Ressource REST: customer.devices.chromeos.commands

Méthodes
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Récupère les données de commande par une commande spécifique envoyée à l'appareil.

Ressource REST: customers

Méthodes
get GET /admin/directory/v1/customers/{customerKey}
Récupère un client.
patch PATCH /admin/directory/v1/customers/{customerKey}
Apporte des correctifs à un client.
update PUT /admin/directory/v1/customers/{customerKey}
Met à jour un client.

Ressource REST: domainAliases

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Supprime un alias de domaine du client.
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Récupère un alias de domaine du client.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
Insère un alias de domaine du client.
list GET /admin/directory/v1/customer/{customer}/domainaliases
Répertorie les alias de domaine du client.

Ressource REST: domains

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
Supprime un domaine du client.
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
Récupère un domaine du client.
insert POST /admin/directory/v1/customer/{customer}/domains
Insère un domaine du client.
list GET /admin/directory/v1/customer/{customer}/domains
Répertorie les domaines du client.

Ressource REST: groups

Méthodes
delete DELETE /admin/directory/v1/groups/{groupKey}
Supprime un groupe.
get GET /admin/directory/v1/groups/{groupKey}
Récupère les propriétés d'un groupe.
insert POST /admin/directory/v1/groups
Crée un groupe.
list GET /admin/directory/v1/groups
Récupère tous les groupes d'un domaine ou d'un utilisateur à partir d'une clé "userKey" (paginée).
patch PATCH /admin/directory/v1/groups/{groupKey}
Met à jour les propriétés d'un groupe.
update PUT /admin/directory/v1/groups/{groupKey}
Met à jour les propriétés d'un groupe.

Ressource REST: groups.aliases

Méthodes
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
Supprime un alias.
insert POST /admin/directory/v1/groups/{groupKey}/aliases
Ajoute un alias pour le groupe.
list GET /admin/directory/v1/groups/{groupKey}/aliases
Répertorie tous les alias d'un groupe.

Ressource REST: members

Méthodes
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Supprime un membre d'un groupe.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Récupère les propriétés d'un membre de groupe.
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
Vérifie si l'utilisateur donné est membre du groupe.
insert POST /admin/directory/v1/groups/{groupKey}/members
Ajoute un utilisateur au groupe spécifié.
list GET /admin/directory/v1/groups/{groupKey}/members
Récupère une liste paginée de tous les membres d'un groupe.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Met à jour les propriétés d'adhésion d'un utilisateur du groupe spécifié.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Met à jour l'appartenance d'un utilisateur au groupe spécifié.

Ressource REST: mobiledevices

Méthodes
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
Effectue une action qui affecte un appareil mobile.
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Supprime un appareil mobile.
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Récupère les propriétés d'un appareil mobile.
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
Récupère la liste paginée de tous les appareils mobiles détenus par l'utilisateur pour un compte.

Ressource REST: orgunits

Méthodes
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Supprime une unité organisationnelle.
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Récupère une unité organisationnelle.
insert POST /admin/directory/v1/customer/{customerId}/orgunits
Ajoute une unité organisationnelle.
list GET /admin/directory/v1/customer/{customerId}/orgunits
Récupère la liste de toutes les unités organisationnelles d'un compte.
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Met à jour une unité organisationnelle.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Met à jour une unité organisationnelle.

Ressource REST: privileges

Méthodes
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Récupère la liste paginée de tous les droits d'un client.

Ressource REST: resources.buildings

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Supprime un bâtiment.
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Récupère un bâtiment.
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
Insère un bâtiment.
list GET /admin/directory/v1/customer/{customer}/resources/buildings
Récupère la liste des bâtiments d'un compte.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Apporte des correctifs à un bâtiment.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Met à jour un bâtiment.

Ressource REST: resources.calendars

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Supprime une ressource d'agenda.
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Récupère une ressource d'agenda.
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
Insère une ressource d'agenda.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
Récupère la liste des ressources d'agenda d'un compte.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Apporte des correctifs à une ressource d'agenda.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Met à jour une ressource d'agenda.

Ressource REST: resources.features

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Supprime un élément géographique.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Récupère un élément géographique.
insert POST /admin/directory/v1/customer/{customer}/resources/features
Insère une caractéristique.
list GET /admin/directory/v1/customer/{customer}/resources/features
Récupère la liste des fonctionnalités d'un compte.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Apporte un correctif à une fonctionnalité.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Renomme un élément géographique.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Met à jour une fonctionnalité.

Ressource REST: roleAssignments

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Supprime une attribution de rôle.
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Récupère l'attribution d'un rôle.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
Crée une attribution de rôle.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Récupère la liste paginée de toutes les attributions de rôles.

Ressource REST: roles

Méthodes
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
Supprime un rôle.
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
Récupère un rôle.
insert POST /admin/directory/v1/customer/{customer}/roles
Crée un rôle.
list GET /admin/directory/v1/customer/{customer}/roles
Récupère la liste paginée de tous les rôles d'un domaine.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
Apporte un correctif à un rôle.
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
Met à jour un rôle.

Ressource REST: schemas

Méthodes
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Supprime un schéma.
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Récupère un schéma.
insert POST /admin/directory/v1/customer/{customerId}/schemas
Crée un schéma.
list GET /admin/directory/v1/customer/{customerId}/schemas
Récupère tous les schémas d'un client.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Apporte un correctif à un schéma.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Met à jour un schéma.

Ressource REST: tokens

Méthodes
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
Supprime tous les jetons d'accès émis par un utilisateur pour une application.
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
Obtient des informations sur un jeton d'accès émis par un utilisateur.
list GET /admin/directory/v1/users/{userKey}/tokens
Renvoie l'ensemble de jetons que l'utilisateur spécifié a émis pour des applications tierces.

Ressource REST: twoStepVerification

Méthodes
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
Désactive la validation en deux étapes pour l'utilisateur.

Ressource REST: users

Méthodes
delete DELETE /admin/directory/v1/users/{userKey}
Supprime un utilisateur.
get GET /admin/directory/v1/users/{userKey}
Récupère un utilisateur.
insert POST /admin/directory/v1/users
Crée un utilisateur.
list GET /admin/directory/v1/users
Récupère la liste paginée des utilisateurs supprimés ou de tous les utilisateurs d'un domaine.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
Affecte un utilisateur au rôle de super-administrateur.
patch PATCH /admin/directory/v1/users/{userKey}
Met à jour un utilisateur à l'aide de la sémantique patch.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Déconnexion de l'utilisateur de toutes les sessions sur le Web et sur un appareil, et réinitialisation de ses cookies de connexion.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Annule la suppression d'un compte utilisateur.
update PUT /admin/directory/v1/users/{userKey}
Met à jour un utilisateur.
watch POST /admin/directory/v1/users/watch
Surveillez les modifications apportées à la liste d'utilisateurs.

Ressource REST: users.aliases

Méthodes
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
Supprime un alias.
insert POST /admin/directory/v1/users/{userKey}/aliases
Ajoute un alias.
list GET /admin/directory/v1/users/{userKey}/aliases
Répertorie tous les alias d'un utilisateur.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Surveillez les modifications apportées à la liste d'utilisateurs.

Ressource REST: users.photos

Méthodes
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
Supprime la photo de l'utilisateur.
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
Récupère la photo de l'utilisateur.
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
Ajoute une photo de l'utilisateur.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Ajoute une photo de l'utilisateur.

Ressource REST: verificationCodes

Méthodes
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
Génère de nouveaux codes de validation de secours pour l'utilisateur.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
Invalide les codes de validation de secours actuels pour l'utilisateur.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Renvoie l'ensemble actuel de codes de validation de secours valides pour l'utilisateur spécifié.