Method: otherContacts.list

Enumera todos los "Otros contactos", es decir, los que no están en un grupo de contactos. "Otros contactos" suelen ser contactos creados automáticamente a partir de interacciones.

Los tokens de sincronización vencen 7 días después de la sincronización completa. Una solicitud con un token de sincronización vencido recibirá un error con el mensaje google.rpc.ErrorInfo relacionado con el motivo "EXPIRED_SYNC_TOKEN". En caso de que se produzca un error de este tipo, los clientes deben realizar una solicitud de sincronización completa sin un syncToken.

La primera página de una solicitud de sincronización completa tiene una cuota adicional. Si se supera la cuota, se mostrará un error 429. Esta cuota es fija y no se puede aumentar.

Cuando se especifica el syncToken, los recursos borrados desde la última sincronización se mostrarán como una persona con PersonMetadata.deleted establecido como verdadero.

Cuando se especifican los valores de pageToken o syncToken, todos los demás parámetros de solicitud deben coincidir con la primera llamada.

Las escrituras pueden tener un retraso de propagación de varios minutos para las solicitudes de sincronización. Las sincronizaciones incrementales no están diseñadas para casos de uso de lectura después de escritura.

Consulta un ejemplo de uso en Enumera los otros contactos del usuario que cambiaron.

Solicitud HTTP

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

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

Parámetros de consulta

Parámetros
pageToken

string

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

Durante la paginación, todos los demás parámetros proporcionados a otherContacts.list deben coincidir con la primera llamada que proporcionó el token de la página.
pageSize

integer

Opcional. La cantidad de "Otros contactos" para incluir en la respuesta. Los valores válidos deben estar entre 1 y 1,000, inclusive. El valor predeterminado es 100 si no se establece o si se establece en 0.
requestSyncToken

boolean

Opcional. Indica si la respuesta debe mostrar nextSyncToken en la última página de resultados. Se puede usar para obtener cambios incrementales desde la última solicitud configurándola en la solicitud syncToken.

Obtén más información sobre el comportamiento de sincronización en otherContacts.list.
syncToken

string

Opcional. Un token de sincronización, recibido de una respuesta anterior nextSyncToken Proporciona esto para recuperar solo los recursos modificados desde la última solicitud.

Durante la sincronización, todos los demás parámetros proporcionados a otherContacts.list deben coincidir con la primera llamada que proporcionó el token de sincronización.

Obtén más información sobre el comportamiento de sincronización en otherContacts.list.
readMask

string (FieldMask format)

Obligatorio. Una máscara de campo para restringir qué campos de cada persona se muestran. Se pueden especificar varios campos separándolos con comas. Los valores válidos dependen de qué se use ReadSourceType.

Si se usa READ_SOURCE_TYPE_CONTACT, los valores válidos son los siguientes:

  • emailAddresses
  • metadatos
  • names
  • phoneNumbers
  • fotos

Si se usa READ_SOURCE_TYPE_PROFILE, los valores válidos son los siguientes:

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

enum (ReadSourceType)

Opcional. Es una máscara de los tipos de fuentes que se mostrarán. Si no está configurado, el valor predeterminado es READ_SOURCE_TYPE_CONTACT.

Los valores posibles para este campo son los siguientes:

No se permite especificar READ_SOURCE_TYPE_PROFILE sin especificar READ_SOURCE_TYPE_CONTACT.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta a una solicitud para los “Otros contactos” del usuario autenticado.

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

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

object (Person)

La lista de “Otros contactos” se muestran como recursos Person. "Otros contactos" admiten un subconjunto limitado de campos. Consulta ListOtherContactsRequest.request_mask para obtener información más detallada.
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.
nextSyncToken

string

Un token, que se puede enviar como syncToken para recuperar los cambios desde la última solicitud. La solicitud debe establecer requestSyncToken para mostrar el token de sincronización.
totalSize

integer

La cantidad total de otros contactos de la lista sin paginación.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/contacts.other.readonly

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