- Recurso: Person
- Representación JSON
- PersonMetadata
- Fuente
- SourceType
- ProfileMetadata
- ObjectType
- UserType
- Dirección
- FieldMetadata
- AgeRange
- AgeRangeType
- Biografía
- ContentType
- Fecha de nacimiento
- Fecha
- BraggingRights
- CalendarUrl
- ClientData
- CoverPhoto
- EmailAddress
- Evento
- ExternalId
- FileAs
- Género
- ImClient
- Interés
- Configuración regional
- Ubicación
- Membresía
- ContactGroupMembership
- DomainMembership
- MiscKeyword
- KeywordType
- Nombre
- Sobrenombre
- NicknameType
- Ocupación
- Organización
- PhoneNumber
- Foto
- Relación
- RelationshipInterest
- RelationshipStatus
- Residencia
- SipAddress
- Destreza
- Eslogan
- URL
- UserDefined
- Métodos
Recurso: Person
Es la información sobre una persona combinada a partir de varias fuentes de datos, como los contactos y los datos del perfil del usuario autenticado.
La mayoría de los campos pueden tener varios elementos. Los elementos de un campo no tienen un orden garantizado, pero se garantiza que cada campo que no esté vacío tendrá exactamente un campo con metadata.primary
establecido como verdadero.
Representación JSON |
---|
{ "resourceName": string, "etag": string, "metadata": { object ( |
Campos | |
---|---|
resourceName |
El nombre de recurso de la persona, asignado por el servidor. Una cadena ASCII con el formato |
etag |
La etiqueta de entidad HTTP del recurso. Se usa para la validación de la caché web. |
metadata |
Solo salida. Metadatos sobre la persona. |
addresses[] |
Las direcciones de la persona. |
ageRange |
Solo salida. OBSOLETO (en su lugar, usa El rango de edad de la persona. |
ageRanges[] |
Solo salida. Los rangos de edad de la persona. |
biographies[] |
Las biografías de la persona. Este campo es un singleton para fuentes de contactos. |
birthdays[] |
Los cumpleaños de la persona. Este campo es un singleton para fuentes de contactos. |
braggingRights[] |
OBSOLETO: No se mostrarán datos sobre el derecho a presumir de la persona. |
calendarUrls[] |
Las URLs del calendario de la persona. |
clientData[] |
Los datos del cliente de la persona. |
coverPhotos[] |
Solo salida. Las fotos de portada de la persona |
emailAddresses[] |
Las direcciones de correo electrónico de la persona. En |
events[] |
Los eventos de la persona. |
externalIds[] |
Los IDs externos de la persona. |
fileAses[] |
El archivo file-ases de la persona. |
genders[] |
El género de la persona. Este campo es un singleton para fuentes de contactos. |
imClients[] |
Los clientes de mensajería instantánea de la persona. |
interests[] |
Los intereses de la persona. |
locales[] |
Las preferencias de configuración regional de la persona. |
locations[] |
Las ubicaciones de la persona. |
memberships[] |
Las membresías del grupo de la persona. |
miscKeywords[] |
Las palabras clave varias de la persona. |
names[] |
Los nombres de las personas. Este campo es un singleton para fuentes de contactos. |
nicknames[] |
Los sobrenombres de la persona. |
occupations[] |
Las ocupaciones de la persona. |
organizations[] |
Las organizaciones anteriores o actuales de la persona. |
phoneNumbers[] |
Los números de teléfono de la persona. En el caso de |
photos[] |
Solo salida. Las fotos de la persona. |
relations[] |
Las relaciones de la persona. |
relationshipInterests[] |
Solo salida. OBSOLETO: No se mostrarán datos respecto de los intereses de la relación de la persona. |
relationshipStatuses[] |
Solo salida. OBSOLETO: No se mostrarán datos sobre los estados de relación de la persona. |
residences[] |
OBSOLETO: (En su lugar, usa |
sipAddresses[] |
Las direcciones SIP de la persona. |
skills[] |
Las habilidades de la persona. |
taglines[] |
Solo salida. OBSOLETO: No se mostrarán datos los eslóganes de la persona. |
urls[] |
Las URLs asociadas con la persona. |
userDefined[] |
Son los datos definidos por el usuario de la persona. |
PersonMetadata
Los metadatos sobre una persona.
Representación JSON |
---|
{ "sources": [ { object ( |
Campos | |
---|---|
sources[] |
Las fuentes de datos de la persona. |
previousResourceNames[] |
Solo salida. Cualquier nombre anterior de recursos que haya tenido esta persona. Se propaga solo para las solicitudes El nombre del recurso puede cambiar cuando se agregan o quitan campos que vinculan un contacto y un perfil, como un correo electrónico verificado, un número de teléfono verificado o la URL de perfil. |
linkedPeopleResourceNames[] |
Solo salida. Nombres de recursos de personas vinculadas a este recurso. |
deleted |
Solo salida. Es verdadero si se borró el recurso de persona. Se propaga solo para las solicitudes de sincronización de |
objectType |
Solo salida. OBSOLETO (en su lugar, usa Es el tipo de objeto persona. |
Fuente
La fuente de un campo.
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Es el tipo de fuente. |
id |
El identificador único dentro del tipo de fuente que genera el servidor. |
etag |
Solo se propaga en La etiqueta de entidad HTTP de la fuente. Se usa para la validación de la caché web. |
updateTime |
Solo salida. Solo se propaga en Marca de tiempo de la última actualización de esta fuente. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Campo de unión Metadatos sobre la fuente |
|
profileMetadata |
Solo salida. Solo se propaga en Metadatos sobre una fuente del tipo PROFILE. |
SourceType
Es el tipo de una fuente.
Enumeradores | |
---|---|
SOURCE_TYPE_UNSPECIFIED |
No se especifica. |
ACCOUNT |
Cuenta de Google |
PROFILE |
Perfil de Google. Puedes ver el perfil en https://profiles.google.com/{id}, donde {id} es el ID de la fuente. |
DOMAIN_PROFILE |
Perfil de dominio de Google Workspace. |
CONTACT |
Contacto de Google. Puedes ver el contacto en https://contact.google.com/{id}, donde {id} es el ID de la fuente. |
OTHER_CONTACT |
"Otro contacto" de Google. |
DOMAIN_CONTACT |
Contacto compartido en el dominio de Google Workspace. |
ProfileMetadata
Los metadatos sobre un perfil.
Representación JSON |
---|
{ "objectType": enum ( |
Campos | |
---|---|
objectType |
Solo salida. El tipo de objeto de perfil. |
userTypes[] |
Solo salida. El usuario escribe. |
ObjectType
Es el tipo de un objeto persona.
Enumeradores | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
No se especifica. |
PERSON |
Persona. |
PAGE |
Página de Currents. |
UserType
Es el tipo de usuario.
Enumeradores | |
---|---|
USER_TYPE_UNKNOWN |
Se desconoce el tipo de usuario. |
GOOGLE_USER |
El usuario es un usuario de Google. |
GPLUS_USER |
El usuario es de Currents. |
GOOGLE_APPS_USER |
El usuario es un usuario de Google Workspace. |
Dirección
La dirección física de una persona. Puede ser un apartado postal o una dirección. Todos los campos son opcionales.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la dirección. |
formattedValue |
El valor no estructurado de la dirección. Si el usuario no establece esto, se creará automáticamente a partir de valores estructurados. |
type |
Es el tipo de la dirección. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo de dirección traducida y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
poBox |
El apartado postal de la dirección |
streetAddress |
Indica la dirección, |
extendedAddress |
La dirección extendida de la dirección; por ejemplo, el número de departamento. |
city |
La ciudad de la dirección. |
region |
Indica la región de la dirección; por ejemplo, el estado o la provincia. |
postalCode |
El código postal de la dirección. |
country |
El país de la dirección. |
countryCode |
Es el código de país ISO 3166-1 alpha-2 de la dirección. |
FieldMetadata
Metadatos sobre un campo.
Representación JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
Campos | |
---|---|
primary |
Solo salida. Es verdadero si el campo es el campo principal para todas las fuentes de la persona. Cada persona tendrá, como máximo, un campo con |
sourcePrimary |
Es verdadero si el campo es el campo principal de |
verified |
Solo salida. Es verdadero si el campo está verificado y falso si el campo no está verificado. Un campo verificado suele ser un nombre, una dirección de correo electrónico, un número de teléfono o un sitio web cuya propiedad se confirmó como propiedad de la persona. |
source |
La fuente del campo. |
AgeRange
OBSOLETO (en su lugar, usa person.ageRanges
)
El rango de edad de una persona.
Enumeradores | |
---|---|
AGE_RANGE_UNSPECIFIED |
No se especifica. |
LESS_THAN_EIGHTEEN |
Menor de dieciocho años. |
EIGHTEEN_TO_TWENTY |
Entre los dieciocho y veinte. |
TWENTY_ONE_OR_OLDER |
Veintiún y más. |
AgeRangeType
El rango de edad de una persona.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el rango de edad |
ageRange |
El rango de edad. |
Biografía
Biografía breve de una persona.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la biografía. |
value |
Biografía corta. |
contentType |
Es el tipo de contenido de la biografía. |
ContentType
Es el tipo de contenido.
Enumeradores | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
No se especifica. |
TEXT_PLAIN |
Texto sin formato |
TEXT_HTML |
Texto HTML. |
Fecha de nacimiento
Es el cumpleaños de una persona. Se especificó al menos uno de los campos date
y text
. Por lo general, los campos date
y text
representan la misma fecha, pero no se garantiza que lo hagan. Los clientes siempre deben configurar el campo date
cuando mutan cumpleaños.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el cumpleaños. |
date |
Es la fecha estructurada de la fecha de nacimiento. |
text |
Prefiere usar el campo Es una cadena de formato libre que representa la fecha de nacimiento del usuario. Este valor no está validado. |
Fecha
Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o no son significativas. La fecha está relacionada con el calendario gregoriano. Esto puede representar uno de los siguientes elementos:
- Una fecha completa, con valores de año, mes y día que no sean cero
- Es un mes y un día con un año en cero (por ejemplo, un aniversario).
- Un año solo, con un mes cero y un día cero.
- Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).
Tipos relacionados:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe encontrarse entre 1 y 9999, o 0 para especificar una fecha sin año. |
month |
Mes del año. Debe encontrarse entre 1 y 12, o bien 0 para especificar un año sin mes ni día. |
day |
Día del mes Debe encontrarse entre 1 y 31 y ser válido para el año y el mes, o 0 para especificar un año por sí mismo o un año y un mes cuando el día no sea importante. |
BraggingRights
OBSOLETO: No se mostrarán datos sobre el derecho a presumir de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el derecho a presumir |
value |
Los derechos a presumir, por ejemplo, |
CalendarUrl
La URL del calendario de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la URL del calendario. |
url |
La URL del calendario. |
type |
Es el tipo de URL del calendario. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo de URL del calendario traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
ClientData
Datos del cliente arbitrarios que los clientes completan. Se permiten claves y valores duplicados.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre los datos del cliente |
key |
La clave de los datos del cliente que especificó el cliente. |
value |
El valor que especifica el cliente de los datos del cliente. |
CoverPhoto
La foto de portada de una persona Una imagen grande que se muestra en la página de perfil de una persona y que representa quién es o qué le interesa.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la foto de portada |
url |
La URL de la foto de portada |
default |
Verdadero si la foto de portada es la foto de portada predeterminada; falso si es una foto de portada proporcionada por el usuario. |
EmailAddress
Es la dirección de correo electrónico de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la dirección de correo electrónico |
value |
La dirección de correo electrónico. |
type |
El tipo de dirección de correo electrónico. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo de dirección de correo electrónico traducida y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
displayName |
El nombre visible del correo electrónico. |
Evento
Es un evento relacionado con la persona.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el evento. |
date |
La fecha del evento. |
type |
El tipo de evento. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Indica el tipo del evento traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
ExternalId
Es un identificador de una entidad externa relacionada con la persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el ID externo. |
value |
El valor del ID externo. |
type |
Es el tipo de ID externo. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Indica el tipo del evento traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
FileAs
Es el nombre que se debe usar para ordenar a la persona en una lista.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el archivo como |
value |
El valor de archivo como |
Género
El género de la persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el género. |
value |
Es el género de la persona. El género puede ser personalizado o uno de estos valores predefinidos:
|
formattedValue |
Solo salida. Indica el valor del género traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
addressMeAs |
Campo de texto en formato libre para los pronombres que deben usarse para dirigirse a la persona. Los valores comunes son los siguientes:
|
ImClient
El cliente de mensajería instantánea de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el cliente de IM |
username |
El nombre de usuario utilizado en el cliente de IM. |
type |
El tipo de cliente de IM. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. El tipo de cliente de IM traducido y formateado según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
protocol |
El protocolo del cliente de IM. El protocolo puede ser personalizado o uno de estos valores predefinidos:
|
formattedProtocol |
Solo salida. El protocolo del cliente de IM con el formato de la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
Interés
Uno de los intereses de la persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el interés. |
value |
El interés; por ejemplo, |
Configuración regional
La preferencia de idioma de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la configuración regional |
value |
Es la etiqueta de idioma IETF BCP 47 con el formato correcto que representa la configuración regional. |
Ubicación
La ubicación de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la ubicación. |
value |
Es el valor de formato libre de la ubicación. |
type |
Es el tipo de ubicación. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
current |
Si la ubicación es la ubicación actual. |
buildingId |
Es el identificador del edificio. |
floor |
El nombre o número del piso |
floorSection |
La sección del piso en |
deskCode |
La ubicación del escritorio individual. |
Membresía
La membresía de una persona en un grupo. Solo se pueden modificar las membresías del grupo de contactos.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la membresía |
Campo de unión membership . La membresía. Las direcciones (membership ) solo pueden ser una de las siguientes opciones: |
|
contactGroupMembership |
Pertenencia al grupo de contactos. |
domainMembership |
Solo salida. La membresía del dominio. |
ContactGroupMembership
Pertenencia a un grupo de contactos de Google.
Representación JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
Campos | |
---|---|
contactGroupId |
Solo salida. El ID del grupo de contactos correspondiente a la pertenencia al grupo de contactos. |
contactGroupResourceName |
El nombre de recurso del grupo de contactos, asignado por el servidor. Una cadena ASCII, con el formato de |
DomainMembership
Una membresía de un dominio de Google Workspace
Representación JSON |
---|
{ "inViewerDomain": boolean } |
Campos | |
---|---|
inViewerDomain |
Verdadero si la persona está en el dominio de Google Workspace del usuario. |
MiscKeyword
La palabra clave miscelánea de un usuario.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la palabra clave miscelánea. |
value |
El valor de la palabra clave miscelánea. |
type |
El tipo de palabra clave misceláneo. |
formattedType |
Solo salida. El tipo de palabra clave miscelánea traducida y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
KeywordType
Tipo de palabra clave miscelánea.
Enumeradores | |
---|---|
TYPE_UNSPECIFIED |
No se especifica. |
OUTLOOK_BILLING_INFORMATION |
Campo de Outlook para los datos de facturación. |
OUTLOOK_DIRECTORY_SERVER |
Campo de Outlook para el servidor del directorio. |
OUTLOOK_KEYWORD |
Campo de Outlook para la palabra clave. |
OUTLOOK_MILEAGE |
Campo de Outlook para el kilometraje. |
OUTLOOK_PRIORITY |
Campo de Outlook para la prioridad. |
OUTLOOK_SENSITIVITY |
Campo de Outlook para la sensibilidad. |
OUTLOOK_SUBJECT |
Campo de Outlook para el asunto. |
OUTLOOK_USER |
Campo de Outlook para el usuario. |
HOME |
Pantalla principal |
WORK |
Trabajo. |
OTHER |
Otro rol |
Nombre
El nombre de una persona. Si el nombre es un monoónimo, el nombre de la familia estará vacío.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el nombre. |
displayName |
Solo salida. El nombre visible con un formato que depende de la configuración regional especificada por la cuenta del usuario o del encabezado HTTP |
displayNameLastFirst |
Solo salida. El nombre visible con el apellido primero tiene el formato correspondiente según la configuración regional especificada por la cuenta del usuario o el encabezado HTTP |
unstructuredName |
Es el valor del nombre de formato libre. |
familyName |
El apellido. |
givenName |
Es el nombre dado. |
middleName |
Los segundos nombres |
honorificPrefix |
Los prefijos honoríficos, como |
honorificSuffix |
Los sufijos honoríficos, como |
phoneticFullName |
El nombre completo se deletrea como suena. |
phoneticFamilyName |
Nombre de familia deletreado como suena. |
phoneticGivenName |
El nombre específico se deletrea como suena. |
phoneticMiddleName |
Segundo nombre escrito |
phoneticHonorificPrefix |
Prefijos honoríficos que se deletrean como suenan. |
phoneticHonorificSuffix |
Son sufijos honoríficos que se deletrean como suenan. |
Apodo
El sobrenombre de una persona.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el sobrenombre |
value |
El sobrenombre |
type |
Es el tipo de sobrenombre. |
NicknameType
Es el tipo de un sobrenombre.
Enumeradores | |
---|---|
DEFAULT |
Sobrenombre genérico. |
MAIDEN_NAME |
Apellido de soltera o apellido natural. Se usa cuando el apellido de la persona cambió como resultado del matrimonio |
INITIALS |
Iniciales. |
GPLUS |
Sobrenombre del perfil de Google+ |
OTHER_NAME |
Una afiliación profesional u otro nombre; por ejemplo, |
ALTERNATE_NAME |
Nombre alternativo por el que se conoce a la persona. |
SHORT_NAME |
Una versión más corta del nombre de la persona. |
Occupation
La ocupación de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la profesión. |
value |
Indica la ocupación; por ejemplo, |
Organización
Es la organización anterior o actual de una persona. Se permiten períodos superpuestos.
Representación JSON |
---|
{ "metadata": { object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la organización. |
type |
Es el tipo de organización. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Indica el tipo de organización que se tradujo y se le dio formato en la configuración regional de la cuenta del usuario o en la configuración regional del encabezado HTTP |
startDate |
La fecha de inicio en la que la persona se unió a la organización. |
endDate |
La fecha de finalización en la que la persona abandonó la organización. |
current |
Verdadero si la organización es la organización actual de la persona. Falso si la organización es una organización anterior. |
name |
Es el nombre de la organización. |
phoneticName |
Es el nombre fonético de la organización. |
department |
El departamento de la persona en la organización. |
title |
Es el cargo de la persona en la organización. |
jobDescription |
Es la descripción del trabajo de la persona en la organización. |
symbol |
El símbolo asociado con la organización; por ejemplo, un símbolo de cotización bursátil, una abreviatura o un acrónimo. |
domain |
Es el nombre de dominio asociado con la organización; por ejemplo, |
location |
La ubicación de la oficina de la organización en la que trabaja la persona. |
costCenter |
Es el centro de costos de la persona en la organización. |
fullTimeEquivalentMillipercent |
Milipor ciento equivalente de tiempo completo de la persona dentro de la organización (100000 = 100%). |
PhoneNumber
El número de teléfono de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el número de teléfono. |
value |
Es el número de teléfono. |
canonicalForm |
Solo salida. Es la forma canónica ITU-T E.164 del número de teléfono. |
type |
Indica el tipo de número de teléfono. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo del número de teléfono traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
Foto
La foto de una persona. Una foto que se muestra junto al nombre de la persona para que los demás la reconozcan.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la foto. |
url |
La URL de la foto. Puedes cambiar el tamaño deseado si agregas un parámetro de consulta |
default |
Verdadero si la foto es una foto predeterminada; falso si es una foto proporcionada por el usuario. |
Relación
Relación de una persona con otra.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la relación. |
person |
El nombre de la otra persona a la que se refiere esta relación. |
type |
Relación entre la persona y la otra persona. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. El tipo de relación traducida y formateado en la configuración regional de la cuenta del usuario o en la configuración regional especificada en el encabezado HTTP Accept-Language. |
RelationshipInterest
OBSOLETO: No se mostrarán datos sobre el interés en la relación de una persona .
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el interés en la relación. |
value |
El tipo de relación que la persona busca. El valor puede ser personalizado o uno de los siguientes:
|
formattedValue |
Solo salida. El valor del interés de la relación traducido y con formato en la configuración regional de la cuenta del usuario o en la configuración regional especificada en el encabezado HTTP Accept-Language. |
RelationshipStatus
OBSOLETO: No se mostrarán datos sobre el estado civil de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre el estado de la relación |
value |
Estado de la relación. El valor puede ser personalizado o uno de los siguientes:
|
formattedValue |
Solo salida. El valor del estado de relación traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
Residencia
OBSOLETO: En su lugar, usa person.locations
. La residencia actual o pasada de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la residencia. |
value |
Es la dirección de la residencia. |
current |
Verdadero si la residencia es la residencia actual de la persona; falso si la residencia es una residencia anterior. |
SipAddress
La dirección SIP de una persona. Las direcciones del Protocolo inicial de la sesión se utilizan para las comunicaciones VoIP para realizar llamadas de voz o videollamadas por Internet.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la dirección SIP. |
value |
La dirección SIP en formato de URI de SIP RFC 3261 19.1. |
type |
Es el tipo de dirección SIP. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo de dirección SIP traducida y formateada en la configuración regional de la cuenta del usuario o en la configuración regional del encabezado HTTP |
Skill
Una habilidad que tiene la persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la destreza. |
value |
La habilidad, por ejemplo, |
Eslogan
OBSOLETO: No se mostrarán datos. Una descripción breve de una línea de la persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la descripción breve. |
value |
El eslogan. |
URL
Las URLs asociadas de una persona.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Metadatos sobre la URL. |
value |
Es la URL. |
type |
Es el tipo de la URL. El tipo puede ser personalizado o uno de los siguientes valores predefinidos:
|
formattedType |
Solo salida. Es el tipo de URL traducido y con formato según la configuración regional de la cuenta del usuario o la configuración regional del encabezado HTTP |
UserDefined
Son datos arbitrarios del usuario que propagan los usuarios finales.
Representación JSON |
---|
{
"metadata": {
object ( |
Campos | |
---|---|
metadata |
Son los metadatos sobre los datos definidos por el usuario. |
key |
Es la clave especificada por el usuario final de los datos definidos por el usuario. |
value |
Es el valor que especifica el usuario final de los datos que define el usuario. |
Métodos |
|
---|---|
|
Crea un lote de contactos nuevos y devuelve las PersonResponses para el nuevo Las solicitudes de modificación para el mismo usuario deben enviarse de forma secuencial para evitar aumentos de latencia y fallas. |
|
Borra un lote de contactos. |
|
Actualiza un lote de contactos y muestra un mapa de nombres de recursos a PersonResponses para los contactos actualizados. |
|
Crea un contacto nuevo y muestra el recurso de persona correspondiente a ese contacto. |
|
Borra una persona de contacto. |
|
Borra la foto de un contacto. |
|
Proporciona información sobre una persona mediante la especificación de un nombre de recurso. |
|
Proporciona información sobre una lista de personas específicas mediante la especificación de una lista de nombres de recursos solicitados. |
|
Proporciona una lista de perfiles y contactos de dominio en el directorio de dominio del usuario autenticado. |
|
Proporciona una lista de contactos en los contactos agrupados del usuario autenticado que coincide con la búsqueda. |
|
Proporciona una lista de perfiles y contactos de dominio en el directorio del dominio del usuario autenticado que coinciden con la búsqueda. |
|
Actualiza los datos de contacto de una persona de contacto existente. |
|
Actualiza la foto de un contacto. |