Admin SDK: Directory API

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Servicio: admin.googleapis.com

Para llamar a este servicio, te recomendamos usar las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información 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 una ASP emitida 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 las ASP que emite un usuario.

Recurso de REST: chromeosdevices

Métodos
action POST /admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Realiza una acción que afecta a un dispositivo con Sistema operativo Chrome.
get GET /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Recupera las propiedades de un dispositivo con Sistema operativo Chrome.
list GET /admin/directory/v1/customer/{customerId}/devices/chromeos
Recupera una lista paginada de dispositivos con Sistema operativo Chrome en una cuenta.
moveDevicesToOu POST /admin/directory/v1/customer/{customerId}/devices/chromeos/moveDevicesToOu
Mueve o inserta varios dispositivos Chrome OS a una unidad organizativa.
patch PATCH /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.
update PUT /admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}
Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

Recurso de REST: customer.devices.chromeos

Métodos
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 del comando como un comando específico emitido para el 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 del dominio del cliente.
insert POST /admin/directory/v1/customer/{customer}/domainaliases
Inserta un alias del dominio del cliente.
list GET /admin/directory/v1/customer/{customer}/domainaliases
Enumera los alias del 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 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 una lista de 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}
Comprueba 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 la 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 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: privilegeds

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 de 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 una función.
get GET /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Recupera una característica.
insert POST /admin/directory/v1/customer/{customer}/resources/features
Inserta un elemento.
list GET /admin/directory/v1/customer/{customer}/resources/features
Recupera una lista de funciones de una cuenta.
patch PATCH /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Aplica parches a un elemento.
rename POST /admin/directory/v1/customer/{customer}/resources/features/{oldName}/rename
Cambia el nombre de un elemento.
update PUT /admin/directory/v1/customer/{customer}/resources/features/{featureKey}
Actualiza una función.

Recurso de REST: roleAssignments

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

Recurso de REST: roles

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

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 para 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 emitidos por 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 especificó para las 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 al usuario en administrador avanzado.
patch PATCH /admin/directory/v1/users/{userKey}
Actualiza un usuario mediante la semántica de parches.
signOut POST /admin/directory/v1/users/{userKey}/signOut
Hace que el usuario salga de todas las sesiones web y de dispositivos y restablece sus cookies de acceso.
undelete POST /admin/directory/v1/users/{userKey}/undelete
Recupera un usuario borrado.
update PUT /admin/directory/v1/users/{userKey}
Actualiza a 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
Muestra una lista de 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 al usuario.
update PUT /admin/directory/v1/users/{userKey}/photos/thumbnail
Agrega una foto al 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 copias de seguridad actuales del usuario.
list GET /admin/directory/v1/users/{userKey}/verificationCodes
Muestra el conjunto actual de códigos de verificación válidos para el usuario especificado.