Admin SDK: Directory API

La API de Directory del SDK de Admin permite a los administradores de dominios empresariales ver y administrar 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
Muestra una lista de 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.
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 los 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
Muestra una lista de 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
Muestra una lista de 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 a partir de una userKey (paginada).
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
Muestra todos los alias de un grupo.

Recurso de REST: members

Métodos
delete DELETE /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Quita un miembro de un grupo.
get GET /admin/directory/v1/groups/{groupKey}/members/{memberKey}
Recupera las propiedades de un miembro de un 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 que pertenecen al usuario de 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 de 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 un parche 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 atributos de 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 roles.
insert POST /admin/directory/v1/customer/{customer}/roleassignments
Crea una asignación de roles.
list GET /admin/directory/v1/customer/{customer}/roleassignments
Recupera una lista paginada de todas las asignaciones de roles.

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 de 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
Muestra el conjunto de tokens que el usuario especificado emitió a 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 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
Devuelve a un usuario borrado.
update PUT /admin/directory/v1/users/{userKey}
Actualiza un usuario.
watch POST /admin/directory/v1/users/watch
Detecta 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
Detecta 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 copia de seguridad para el usuario.
invalidate POST /admin/directory/v1/users/{userKey}/verificationCodes/invalidate
Invalida los códigos de verificación de copia de seguridad actuales del usuario.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Muestra el conjunto actual de códigos de verificación de copia de seguridad válidos para el usuario especificado.