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 |
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. |