REST Resource: people.connections
Ресурс: Человек
Информация о человеке, объединенная из различных источников данных, таких как контакты аутентифицированного пользователя и данные профиля.
Большинство полей могут содержать несколько элементов. Элементы в поле не имеют гарантированного порядка, но каждое непустое поле гарантированно содержит ровно одно поле с metadata.primary
, установленным в значение true.
JSON-представление |
---|
{
"resourceName": string,
"etag": string,
"metadata": {
object (PersonMetadata )
},
"addresses": [
{
object (Address )
}
],
"ageRange": enum (AgeRange ),
"ageRanges": [
{
object (AgeRangeType )
}
],
"biographies": [
{
object (Biography )
}
],
"birthdays": [
{
object (Birthday )
}
],
"braggingRights": [
{
object (BraggingRights )
}
],
"calendarUrls": [
{
object (CalendarUrl )
}
],
"clientData": [
{
object (ClientData )
}
],
"coverPhotos": [
{
object (CoverPhoto )
}
],
"emailAddresses": [
{
object (EmailAddress )
}
],
"events": [
{
object (Event )
}
],
"externalIds": [
{
object (ExternalId )
}
],
"fileAses": [
{
object (FileAs )
}
],
"genders": [
{
object (Gender )
}
],
"imClients": [
{
object (ImClient )
}
],
"interests": [
{
object (Interest )
}
],
"locales": [
{
object (Locale )
}
],
"locations": [
{
object (Location )
}
],
"memberships": [
{
object (Membership )
}
],
"miscKeywords": [
{
object (MiscKeyword )
}
],
"names": [
{
object (Name )
}
],
"nicknames": [
{
object (Nickname )
}
],
"occupations": [
{
object (Occupation )
}
],
"organizations": [
{
object (Organization )
}
],
"phoneNumbers": [
{
object (PhoneNumber )
}
],
"photos": [
{
object (Photo )
}
],
"relations": [
{
object (Relation )
}
],
"relationshipInterests": [
{
object (RelationshipInterest )
}
],
"relationshipStatuses": [
{
object (RelationshipStatus )
}
],
"residences": [
{
object (Residence )
}
],
"sipAddresses": [
{
object (SipAddress )
}
],
"skills": [
{
object (Skill )
}
],
"taglines": [
{
object (Tagline )
}
],
"urls": [
{
object (Url )
}
],
"userDefined": [
{
object (UserDefined )
}
]
} |
Поля |
---|
resourceName | string Имя ресурса для человека, назначенное сервером. Строка ASCII в формате people/{person_id} . |
etag | string Тег объекта HTTP ресурса. Используется для проверки веб-кеша. |
metadata | object ( PersonMetadata ) Только вывод. Метаданные о человеке. |
addresses[] | object ( Address ) Уличные адреса человека. |
ageRange (deprecated) | enum ( AgeRange ) Только вывод. УСТАРЕЛО (вместо этого используйте person.ageRanges ) Возрастной диапазон человека. |
ageRanges[] | object ( AgeRangeType ) Только вывод. Возраст человека колеблется. |
biographies[] | object ( Biography ) Биографии человека. Это поле является единственным для источников контактов. |
birthdays[] | object ( Birthday ) Дни рождения человека. Это поле является единственным для источников контактов. |
braggingRights[] (deprecated) | object ( BraggingRights ) УСТАРЕЛО : данные не будут возвращены. Человек имеет право хвастаться. |
calendarUrls[] | object ( CalendarUrl ) URL-адреса календаря человека. |
clientData[] | object ( ClientData ) Данные клиента о человеке. |
coverPhotos[] | object ( CoverPhoto ) Только вывод. Фотографии человека на обложке. |
emailAddresses[] | object ( EmailAddress ) Адреса электронной почты человека. people.connections.list otherContacts.list количество адресов электронной почты ограничено 100. Если у человека больше адресов электронной почты, весь набор можно получить, people.getBatchGet . |
events[] | object ( Event ) События человека. |
externalIds[] | object ( ExternalId ) Внешние идентификаторы человека. |
fileAses[] | object ( FileAs ) Файл-ассы человека. |
genders[] | object ( Gender ) Пол человека. Это поле является единственным для источников контактов. |
imClients[] | object ( ImClient ) Клиенты обмена мгновенными сообщениями человека. |
interests[] | object ( Interest ) Интересы человека. |
locales[] | object ( Locale ) Региональные предпочтения человека. |
locations[] | object ( Location ) Местоположение человека. |
memberships[] | object ( Membership ) Членство человека в группах. |
miscKeywords[] | object ( MiscKeyword ) Разные ключевые слова человека. |
names[] | object ( Name ) Имена человека. Это поле является единственным для источников контактов. |
nicknames[] | object ( Nickname ) Прозвища человека. |
occupations[] | object ( Occupation ) Занятия человека. |
organizations[] | object ( Organization ) Прошлые или нынешние организации человека. |
phoneNumbers[] | object ( PhoneNumber ) Номера телефонов человека. Для people.connections.list otherContacts.list количество телефонных номеров ограничено 100. Если у Person есть больше телефонных номеров, весь набор можно получить, вызвав people.getBatchGet . |
photos[] | object ( Photo ) Только вывод. Фотографии человека. |
relations[] | object ( Relation ) Отношения человека. |
relationshipInterests[] (deprecated) | object ( RelationshipInterest ) Только вывод. УСТАРЕЛО : данные не будут возвращены. Интересы человека в отношениях. |
relationshipStatuses[] (deprecated) | object ( RelationshipStatus ) Только вывод. УСТАРЕЛО : данные не будут возвращены. Статусы отношений человека. |
residences[] (deprecated) | object ( Residence ) УСТАРЕЛО : (вместо этого используйте person.locations ) Место жительства человека. |
sipAddresses[] | object ( SipAddress ) SIP-адреса человека. |
skills[] | object ( Skill ) Навыки человека. |
taglines[] (deprecated) | object ( Tagline ) Только вывод. УСТАРЕЛО : данные не будут возвращены. Слоганы человека. |
urls[] | object ( Url ) Связанные URL-адреса человека. |
userDefined[] | object ( UserDefined ) Определенные пользователем данные человека. |
Методы |
---|
| Предоставляет список контактов аутентифицированного пользователя. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-25 UTC.
[null,null,["Последнее обновление: 2024-10-25 UTC."],[[["The Person resource aggregates information about individuals from various sources, including contacts and profile data."],["Most fields in the Person resource can contain multiple entries, with one designated as primary using the `metadata.primary` flag."],["A comprehensive JSON representation is provided, detailing the structure and data types of the Person resource."],["The Person resource offers various fields such as addresses, age ranges, biographies, and contact information like email addresses and phone numbers."],["Methods are available for interactions with the Person resource, such as listing the authenticated user's contacts."]]],["The `Person` resource merges data from user contacts and profiles. It uses a JSON format with fields like `addresses`, `emailAddresses`, and `phoneNumbers`, each potentially containing multiple items. Fields such as `names`, and `gender` are singletons for contact sources. One item in each non-empty field will have `metadata.primary` set to true. Deprecated fields like `braggingRights` are noted. The `list` method allows listing an authenticated user's contacts.\n"]]