Admin SDK: Directory API

La API de Directory del SDK de Admin permite que los administradores de dominios empresariales vean y administren los usuarios, los grupos, los dispositivos y los recursos relacionados de su organización. Las APIs de Cloud Identity ofrecen formas adicionales de administrar algunos de los mismos recursos.

Servicio: admin.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la información siguiente cuando realices las solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el documento de descubrimiento siguiente:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://admin.googleapis.com

Recurso de REST: asps

Métodos
delete DELETE /admin/directory/v1/users/{userKey}/asps/{codeId}
Borra un ASP emitido por un usuario.
get GET /admin/directory/v1/users/{userKey}/asps/{codeId}
Obtiene información sobre un ASP emitido por un usuario.
list GET /admin/directory/v1/users/{userKey}/asps
Enumera los ASP que emitió un usuario.

Recurso de REST: chromeosdevices

Métodos
action
(deprecated)		 POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
En su lugar, usa BatchChangeChromeOsDeviceStatus.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Recupera las propiedades de un dispositivo ChromeOS.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Recupera una lista paginada de dispositivos ChromeOS dentro de una cuenta.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Mueve o inserta varios dispositivos ChromeOS en una unidad organizativa.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

Recurso de REST: customer.devices.chromeos

Métodos
batchChangeStatus POST /admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
Cambia el estado de un lote de dispositivos ChromeOS.
countChromeOsDevices GET /admin/directory/v1/customer/{customerId}/devices/chromeos:countChromeOsDevices
Cuenta los dispositivos ChromeOS que coinciden con la solicitud.
issueCommand POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand
Emite un comando para que el dispositivo lo ejecute.

Recurso de REST: customer.devices.chromeos.commands

Métodos
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}/commands/{commandId}
Obtiene datos de un comando específico que se emitió al dispositivo.

Recurso de REST: customers

Métodos
get GET /admin/directory/v1/customers/{customerKey}
Recupera un cliente.
patch PATCH /admin/directory/v1/customers/{customerKey}
Aplica parches a un cliente.
update PUT /admin/directory/v1/customers/{customerKey}
Actualiza un cliente.

Recurso de REST: domainAliases

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Borra un alias de dominio del cliente.
get GET /admin/directory/v1/customer/{customer}/domainaliases/{domainAliasName}
Recupera un alias de dominio del cliente.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
Inserta un alias de dominio del cliente.
list GET /admin/directory/v1/customer/{customer}/domainaliases
Enumera los alias de dominio del cliente.

Recurso de REST: domains

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/domains/{domainName}
Borra un dominio del cliente.
get GET /admin/directory/v1/customer/{customer}/domains/{domainName}
Recupera un dominio del cliente.
insert POST /admin/directory/v1/customer/{customer}/domains
Inserta un dominio del cliente.
list GET /admin/directory/v1/customer/{customer}/domains
Enumera los dominios del cliente.

Recurso de REST: groups

Métodos
delete DELETE /admin/directory/v1/groups/{groupKey}
Borra un grupo.
get GET /admin/directory/v1/groups/{groupKey}
Recupera las propiedades de un grupo.
insert POST /admin/directory/v1/groups
Crea un grupo.
list GET /admin/directory/v1/groups
Recupera todos los grupos de un dominio o de un usuario determinado por una userKey (paginado).
patch PATCH /admin/directory/v1/groups/{groupKey}
Actualiza las propiedades de un grupo.
update PUT /admin/directory/v1/groups/{groupKey}
Actualiza las propiedades de un grupo.

Recurso de REST: groups.aliases

Métodos
delete DELETE /admin/directory/v1/groups/{groupKey}/aliases/{alias}
Quita un alias.
insert POST /admin/directory/v1/groups/{groupKey}/aliases
Agrega un alias para el grupo.
list GET /admin/directory/v1/groups/{groupKey}/aliases
Enumera todos los alias de un grupo.

Recurso de REST: members

Métodos
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Quita a un miembro de un grupo.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Recupera las propiedades de un miembro del grupo.
hasMember GET /admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
Verifica si el usuario determinado es miembro del grupo.
insert POST /admin/directory/v1/groups/{groupKey}/members
Agrega un usuario al grupo especificado.
list GET /admin/directory/v1/groups/{groupKey}/members
Recupera una lista paginada de todos los miembros de un grupo.
patch PATCH /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Actualiza las propiedades de membresía de un usuario en el grupo especificado.
update PUT /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Actualiza la membresía de un usuario en el grupo especificado.

Recurso de REST: mobiledevices

Métodos
action POST /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
Realiza una acción que afecta a un dispositivo móvil.
delete DELETE /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Quita un dispositivo móvil.
get GET /admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}
Recupera las propiedades de un dispositivo móvil.
list GET /admin/directory/v1/customer/{customerId}/devices/mobile
Recupera una lista paginada de todos los dispositivos móviles propiedad del usuario para una cuenta.

Recurso de REST: orgunits

Métodos
delete DELETE /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Quita una unidad organizativa.
get GET /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Recupera una unidad organizativa.
insert POST /admin/directory/v1/customer/{customerId}/orgunits
Agrega una unidad organizativa.
list GET /admin/directory/v1/customer/{customerId}/orgunits
Recupera una lista de todas las unidades organizativas de una cuenta.
patch PATCH /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Actualiza una unidad organizativa.
update PUT /admin/directory/v1/customer/{customerId}/orgunits/{orgUnitPath=**}
Actualiza una unidad organizativa.

Recurso de REST: privileges

Métodos
list GET /admin/directory/v1/customer/{customer}/roles/ALL/privileges
Recupera una lista paginada de todos los privilegios de un cliente.

Recurso de REST: resources.buildings

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Borra un edificio.
get GET /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Recupera un edificio.
insert POST /admin/directory/v1/customer/{customer}/resources/buildings
Inserta un edificio.
list GET /admin/directory/v1/customer/{customer}/resources/buildings
Recupera una lista de edificios para una cuenta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Aplica parches a un edificio.
update PUT /admin/directory/v1/customer/{customer}/resources/buildings/{buildingId}
Actualiza un edificio.

Recurso de REST: resources.calendars

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Borra un recurso de calendario.
get GET /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Recupera un recurso de calendario.
insert POST /admin/directory/v1/customer/{customer}/resources/calendars
Inserta un recurso de calendario.
list GET /admin/directory/v1/customer/{customer}/resources/calendars
Recupera una lista de recursos de calendario para una cuenta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Aplica parches a un recurso de calendario.
update PUT /admin/directory/v1/customer/{customer}/resources/calendars/{calendarResourceId}
Actualiza un recurso de calendario.

Recurso de REST: resources.features

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Borra un atributo.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Recupera un atributo.
insert POST /admin/directory/v1/customer/{customer}/resources/features
Inserta un atributo.
list GET /admin/directory/v1/customer/{customer}/resources/features
Recupera una lista de funciones para una cuenta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Aplica parches a una función.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Cambia el nombre de un atributo.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Actualiza un atributo.

Recurso de REST: roleAssignments

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Borra una asignación de rol.
get GET /admin/directory/v1/customer/{customer}/roleassignments/{roleAssignmentId}
Recupera una asignación de rol.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
Crea una asignación de rol.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Recupera una lista paginada de todos los roleAssignments.

Recurso de REST: roles

Métodos
delete DELETE /admin/directory/v1/customer/{customer}/roles/{roleId}
Borra un rol.
get GET /admin/directory/v1/customer/{customer}/roles/{roleId}
Recupera un rol.
insert POST /admin/directory/v1/customer/{customer}/roles
Crea un rol.
list GET /admin/directory/v1/customer/{customer}/roles
Recupera una lista paginada de todos los roles en un dominio.
patch PATCH /admin/directory/v1/customer/{customer}/roles/{roleId}
Aplica parches a un rol.
update PUT /admin/directory/v1/customer/{customer}/roles/{roleId}
Actualiza un rol.

Recurso de REST: schemas

Métodos
delete DELETE /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Borra un esquema.
get GET /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Recupera un esquema.
insert POST /admin/directory/v1/customer/{customerId}/schemas
Crea un esquema.
list GET /admin/directory/v1/customer/{customerId}/schemas
Recupera todos los esquemas de un cliente.
patch PATCH /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Aplica parches a un esquema.
update PUT /admin/directory/v1/customer/{customerId}/schemas/{schemaKey}
Actualiza un esquema.

Recurso de REST: tokens

Métodos
delete DELETE /admin/directory/v1/users/{userKey}/tokens/{clientId}
Borra todos los tokens de acceso que emitió un usuario para una aplicación.
get GET /admin/directory/v1/users/{userKey}/tokens/{clientId}
Obtiene información sobre un token de acceso emitido por un usuario.
list GET /admin/directory/v1/users/{userKey}/tokens
Devuelve el conjunto de tokens que el usuario especificado emitió para aplicaciones de terceros.

Recurso de REST: twoStepVerification

Métodos
turnOff POST /admin/directory/v1/users/{userKey}/twoStepVerification/turnOff
Desactiva la verificación en 2 pasos para el usuario.

Recurso de REST: users

Métodos
delete DELETE /admin/directory/v1/users/{userKey}
Borra un usuario.
get GET /admin/directory/v1/users/{userKey}
Recupera un usuario.
insert POST /admin/directory/v1/users
Crea un usuario.
list GET /admin/directory/v1/users
Recupera una lista paginada de los usuarios borrados o de todos los usuarios de un dominio.
makeAdmin POST /admin/directory/v1/users/{userKey}/makeAdmin
Convierte a un usuario en administrador avanzado.
patch PATCH /admin/directory/v1/users/{userKey}
Actualiza un usuario con la semántica de parche.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Cierra la sesión de un usuario en todas las sesiones web y de dispositivos, y restablece sus cookies de acceso.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Deshace el borrado de un usuario.
update PUT /admin/directory/v1/users/{userKey}
Actualiza un usuario.
watch POST /admin/directory/v1/users/watch
Observa los cambios en la lista de usuarios.

Recurso de REST: users.aliases

Métodos
delete DELETE /admin/directory/v1/users/{userKey}/aliases/{alias}
Quita un alias.
insert POST /admin/directory/v1/users/{userKey}/aliases
Agrega un alias.
list GET /admin/directory/v1/users/{userKey}/aliases
Enumera todos los alias de un usuario.
watch POST /admin/directory/v1/users/{userKey}/aliases/watch
Observa los cambios en la lista de usuarios.

Recurso de REST: users.photos

Métodos
delete DELETE /admin/directory/v1/users/{userKey}/photos/thumbnail
Quita la foto del usuario.
get GET /admin/directory/v1/users/{userKey}/photos/thumbnail
Recupera la foto del usuario.
patch PATCH /admin/directory/v1/users/{userKey}/photos/thumbnail
Agrega una foto para el usuario.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Agrega una foto para el usuario.

Recurso de REST: verificationCodes

Métodos
generate POST /admin/directory/v1/users/{userKey}/verificationCodes/generate
Genera nuevos códigos de verificación de respaldo para el usuario.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
Invalida los códigos de verificación de seguridad actuales del usuario.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Devuelve el conjunto actual de códigos de verificación de respaldo válidos para el usuario especificado.