Method: people.searchDirectoryPeople

Proporciona una lista de perfiles de dominio y contactos de dominio en el directorio de dominio del usuario autenticado que coinciden con la búsqueda.

Solicitud HTTP

GET https://people.googleapis.com/v1/people:searchDirectoryPeople

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
query

string

Obligatorio. Es una consulta de prefijo que coincide con los campos de la persona. NO usa la readMask para determinar los campos que deben coincidir.
readMask

string (FieldMask format)

Obligatorio. Una máscara de campo para restringir qué campos de cada persona se muestran. Para especificar varios campos, sepáralos con comas. Estos son los valores válidos:

  • direcciones
  • ageRanges
  • biografías
  • cumpleaños
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventos
  • externalIds
  • Sexos
  • imClients
  • Intereses
  • locales
  • ubicaciones
  • memberships
  • metadatos
  • miscKeywords
  • names
  • sobrenombres
  • ocupaciones
  • organizaciones
  • phoneNumbers
  • fotos
  • relaciones
  • sipAddresses
  • skills
  • url
  • userDefined
sources[]

enum (DirectorySourceType)

Obligatorio. Son las fuentes de directorio que se mostrarán.
mergeSources[]

enum (DirectoryMergeSourceType)

Opcional. Datos adicionales que se deben combinar en las fuentes del directorio si están conectadas a través de claves de unión verificadas, como direcciones de correo electrónico o números de teléfono.
pageSize

integer

Opcional. Es la cantidad de personas que se deben incluir en la respuesta. Los valores válidos están entre 1 y 500 inclusive. El valor predeterminado es 100 si no se establece o si se establece en 0.
pageToken

string

Opcional. Es un token de página, recibido desde una respuesta nextPageToken anterior. Proporciona esto para recuperar la página siguiente.

Durante la paginación, todos los demás parámetros proporcionados a [people.searchDirectoryPeople][google.people.v1.SearchDirectoryPeople] deben coincidir con la primera llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

La respuesta a una solicitud de personas en el directorio del dominio del usuario autenticado que coinciden con la consulta especificada.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "people": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
people[]

object (Person)

Es la lista de personas en el directorio del dominio que coinciden con la búsqueda.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.
totalSize

integer

La cantidad total de elementos en la lista sin paginación.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/directory.readonly

Para obtener más información, consulta la Guía de autorización.