REST Resource: people

리소스: Person

인증된 사용자의 연락처 및 프로필 데이터 등 다양한 데이터 소스에서 병합된 사람에 대한 정보입니다.

대부분의 필드에는 여러 개의 항목이 포함될 수 있습니다. 필드의 항목에는 순서가 보장되지 않지만 비어 있지 않은 각 필드에는 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

서버에서 할당한 사람의 리소스 이름입니다. people/{person_id} 형식의 ASCII 문자열.
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)

사용자의 외부 ID입니다.
fileAses[]

object (FileAs)

사용자의 file-ases입니다.
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개로 제한됩니다. 사람의 전화번호가 더 많은 경우 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)

개인의 사용자 정의 데이터입니다.

PersonMetadata

사람에 관한 메타데이터입니다.

JSON 표현 
{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}
필드
sources[]

object (Source)

개인에 대한 데이터 소스입니다.
previousResourceNames[]

string

출력 전용입니다. 이 사용자가 보유한 이전 리소스 이름입니다. 동기화 토큰이 포함된 people.connections.list 요청에 대해서만 채워집니다.

리소스 이름은 확인된 이메일, 인증된 전화번호 또는 프로필 URL과 같이 연락처와 프로필을 연결하는 필드를 추가하거나 삭제할 때 변경될 수 있습니다.
linkedPeopleResourceNames[]

string

출력 전용입니다. 이 리소스에 연결된 사용자의 리소스 이름입니다.
deleted

boolean

출력 전용입니다. 사람 리소스가 삭제되었으면 true입니다. people.connections.list 및 otherContacts.list 동기화 요청에 대해서만 채워집니다.
objectType
(deprecated)

enum (ObjectType)

출력 전용입니다. 지원 중단됨 (대신 person.metadata.sources.profileMetadata.objectType 사용)

사람 객체의 유형입니다.

소스

필드의 소스입니다.

JSON 표현 
{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}
필드
type

enum (SourceType)

소스 유형입니다.
id

string

서버에서 생성한 소스 유형 내의 고유 식별자입니다.
etag

string

person.metadata.sources에만 채워집니다.

소스의 HTTP 항목 태그. 웹 캐시 유효성 검사에 사용됩니다.
updateTime

string (Timestamp format)

출력 전용입니다. person.metadata.sources에만 채워집니다.

이 소스의 최종 업데이트 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

통합 필드 metadata. person.metadata.sources에만 채워집니다.

소스에 대한 메타데이터입니다. metadata는 다음 중 하나여야 합니다.
profileMetadata

object (ProfileMetadata)

출력 전용입니다. person.metadata.sources에만 채워집니다.

PROFILE 유형의 소스에 대한 메타데이터입니다.

SourceType

소스의 유형입니다.

열거형
SOURCE_TYPE_UNSPECIFIED 지정되지 않았습니다.
ACCOUNT Google 계정
PROFILE Google 프로필. https://profiles.google.com/{id}에서 프로필을 확인할 수 있으며 여기서 {id}는 소스 ID입니다.
DOMAIN_PROFILE Google Workspace 도메인 프로필.
CONTACT Google 연락처: https://contact.google.com/{id}에서 연락처를 확인할 수 있으며 여기서 {id}는 소스 ID입니다.
OTHER_CONTACT Google '기타 연락처'.
DOMAIN_CONTACT Google Workspace 도메인 공유 연락처.

ProfileMetadata

프로필에 대한 메타데이터입니다.

JSON 표현 
{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}
필드
objectType

enum (ObjectType)

출력 전용입니다. 프로필 객체 유형입니다.
userTypes[]

enum (UserType)

출력 전용입니다. 사용자 입력

ObjectType

사람 객체의 유형입니다.

열거형
OBJECT_TYPE_UNSPECIFIED 지정되지 않았습니다.
PERSON 사람입니다.
PAGE Currents 페이지.

UserType

사용자 유형입니다.

열거형
USER_TYPE_UNKNOWN 사용자 유형을 알 수 없습니다.
GOOGLE_USER 사용자가 Google 사용자입니다.
GPLUS_USER 사용자가 Currents 사용자입니다.
GOOGLE_APPS_USER 사용자가 Google Workspace 사용자입니다.

주소

개인의 실제 주소입니다. 사서함일 수도 있습니다. 주소를 입력해야 합니다. 모든 입력란은 선택사항입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}
필드
metadata

object (FieldMetadata)

주소에 대한 메타데이터입니다.
formattedValue

string

주소의 구조화되지 않은 값입니다. 사용자가 설정하지 않으면 구조화된 값에서 자동으로 구성됩니다.
type

string

주소 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 주소의 유형입니다.
poBox

string

P.O. 있습니다.
streetAddress

string

상세 주소입니다.
extendedAddress

string

주소의 확장된 주소입니다. 예를 들어 아파트 동호수를 입력할 수 있습니다.
city

string

주소의 도시입니다.
region

string

주소의 지역입니다. 예를 들어 주 또는 도입니다.
postalCode

string

주소의 우편번호입니다.
country

string

주소의 국가입니다.
countryCode

string

주소의 ISO 3166-1 alpha-2 국가 코드입니다.

FieldMetadata

필드에 관한 메타데이터입니다.

JSON 표현 
{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}
필드
primary

boolean

출력 전용입니다. 필드가 개인의 모든 소스에 대한 기본 필드인 경우 참입니다. 각 사용자는 primary가 true로 설정된 필드를 최대 1개 보유할 수 있습니다.
sourcePrimary

boolean

필드가 source의 기본 필드인 경우 true입니다. 각 소스에는 sourcePrimary가 true로 설정된 필드가 최대 1개 있어야 합니다.
verified

boolean

출력 전용입니다. 필드가 인증된 경우 true이고, 필드가 확인되지 않은 경우 false입니다. 확인된 필드는 일반적으로 사용자가 소유한 것으로 확인된 이름, 이메일 주소, 전화번호 또는 웹사이트입니다.
source

object (Source)

필드의 소스입니다.

연령

지원 중단됨 (대신 person.ageRanges 사용)

사람의 연령대입니다.

열거형
AGE_RANGE_UNSPECIFIED 지정되지 않았습니다.
LESS_THAN_EIGHTEEN 만 18세 미만입니다.
EIGHTEEN_TO_TWENTY 18에서 22 사이입니다.
TWENTY_ONE_OR_OLDER 만 21세 이상.

AgeRangeType

개인의 연령대입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}
필드
metadata

object (FieldMetadata)

연령대에 관한 메타데이터입니다.
ageRange

enum (AgeRange)

연령대입니다.

전기

개인의 짧은 약력입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}
필드
metadata

object (FieldMetadata)

약력에 관한 메타데이터입니다.
value

string

짧은 약력
contentType

enum (ContentType)

약력의 콘텐츠 유형입니다.

ContentType

콘텐츠 유형입니다.

열거형
CONTENT_TYPE_UNSPECIFIED 지정되지 않았습니다.
TEXT_PLAIN 일반 텍스트
TEXT_HTML HTML 텍스트입니다.

생일

사용자의 생일입니다. date 및 text 필드 중 하나 이상이 지정됩니다. date 및 text 필드는 일반적으로 동일한 날짜를 나타내지만 보장되지는 않습니다. 클라이언트는 생일을 변경할 때 항상 date 필드를 설정해야 합니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}
필드
metadata

object (FieldMetadata)

생일에 대한 메타데이터입니다.
date

object (Date)

생일의 구조화된 날짜입니다.
text
(deprecated)

string

설정된 경우 date 필드를 사용하는 것이 좋습니다.

사용자의 생일을 나타내는 자유 형식의 문자열입니다. 이 값은 검증되지 않습니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

BraggingRights

지원 중단됨: 데이터가 반환되지 않습니다. 개인의 자랑거리입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

자랑거리에 대한 메타데이터입니다.
value

string

자랑거리 예: climbed mount everest

CalendarUrl

사용자의 캘린더 URL입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

캘린더 URL에 대한 메타데이터입니다.
url

string

캘린더 URL입니다.
type

string

캘린더 URL의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • freeBusy
  • work
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 캘린더 URL의 유형입니다.

ClientData

클라이언트가 채우는 임의의 클라이언트 데이터입니다. 중복된 키와 값이 허용됩니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
필드
metadata

object (FieldMetadata)

클라이언트 데이터에 대한 메타데이터입니다.
key

string

클라이언트가 지정한 클라이언트 데이터 키입니다.
value

string

클라이언트 데이터의 클라이언트 지정 값입니다.

CoverPhoto

인물의 표지 사진입니다. 프로필 페이지에 표시되는 큰 이미지로, 자신이 누구인지 또는 무엇에 관심이 있는지를 나타냅니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
필드
metadata

object (FieldMetadata)

표지 사진에 대한 메타데이터입니다.
url

string

표지 사진의 URL입니다.
default

boolean

표지 사진이 기본 표지 사진이면 true이고, 표지 사진이 사용자가 제공한 표지 사진인 경우 false입니다.

EmailAddress

개인의 이메일 주소입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}
필드
metadata

object (FieldMetadata)

이메일 주소에 대한 메타데이터입니다.
value

string

이메일 주소입니다.
type

string

이메일 주소의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 이메일 주소의 유형입니다.
displayName

string

이메일의 표시 이름입니다.

이벤트

사람과 관련된 이벤트입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

이벤트에 대한 메타데이터입니다.
date

object (Date)

이벤트 날짜입니다.
type

string

이벤트 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • anniversary
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 이벤트의 유형입니다.

외부 ID

사람과 관련된 외부 법인의 식별자입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

외부 ID에 대한 메타데이터입니다.
value

string

외부 ID의 값입니다.
type

string

외부 ID의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 이벤트의 유형입니다.

FileAs

목록에서 사용자를 정렬할 때 사용해야 하는 이름입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

as a file-as에 대한 메타데이터입니다.
value

string

file-as 값

성별

개인의 성별입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}
필드
metadata

object (FieldMetadata)

성별에 대한 메타데이터입니다.
value

string

개인의 성별입니다. 성별은 맞춤설정하거나 다음과 같은 사전 정의된 값 중 하나일 수 있습니다.

  • male
  • female
  • unspecified
formattedValue

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 성별의 값입니다. 지정되지 않았거나 커스텀 값이 현지화되지 않았습니다.
addressMeAs

string

사람을 호칭하는 데 사용할 호칭을 위한 자유 형식 텍스트 입력란입니다. 일반적인 값은 다음과 같습니다.

  • he/him
  • she/her
  • they/them

ImClient

개인의 채팅 클라이언트입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}
필드
metadata

object (FieldMetadata)

메신저 클라이언트에 대한 메타데이터입니다.
username

string

메신저 클라이언트에서 사용되는 사용자 이름입니다.
type

string

메신저 클라이언트의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 번역 및 형식이 지정된 IM 클라이언트의 유형입니다.
protocol

string

메신저 클라이언트의 프로토콜입니다. 프로토콜은 커스텀 값 또는 다음과 같은 사전 정의된 값 중 하나일 수 있습니다.

  • aim
  • msn
  • yahoo
  • skype
  • qq
  • googleTalk
  • icq
  • jabber
  • netMeeting
formattedProtocol

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 형식이 지정된 메신저 클라이언트의 프로토콜입니다.

관심

개인의 관심분야 중 하나입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

관심분야에 대한 메타데이터입니다.
value

string

이해관계 예: stargazing

언어

사용자의 언어 환경설정입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

언어에 대한 메타데이터입니다.
value

string

언어를 나타내는 올바른 형식의 IETF BCP 47 언어 태그입니다.

위치

개인의 위치입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}
필드
metadata

object (FieldMetadata)

위치에 대한 메타데이터입니다.
value

string

위치의 자유 형식 값입니다.
type

string

위치의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • desk
  • grewUp
current

boolean

위치가 현재 위치인지 여부입니다.
buildingId

string

건물 식별자입니다.
floor

string

층 이름 또는 번호입니다.
floorSection

string

floor_name의 층 섹션
deskCode

string

개별 데스크 위치입니다.

멤버십

사용자의 그룹 멤버십입니다. 연락처 그룹 멤버십만 수정할 수 있습니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}
필드
metadata

object (FieldMetadata)

멤버십에 대한 메타데이터입니다.
통합 필드 membership. 멤버십입니다. membership은 다음 중 하나여야 합니다.
contactGroupMembership

object (ContactGroupMembership)

연락처 그룹 멤버십입니다.
domainMembership

object (DomainMembership)

출력 전용입니다. 도메인 멤버십입니다.

ContactGroupMembership

Google 주소록 그룹 멤버십

JSON 표현 
{
  "contactGroupId": string,
  "contactGroupResourceName": string
}
필드
contactGroupId
(deprecated)

string

출력 전용입니다. 연락처 그룹 멤버십의 연락처 그룹 ID입니다.
contactGroupResourceName

string

서버에서 할당한 연락처 그룹의 리소스 이름입니다. contactGroups/{contactGroupId} 형식의 ASCII 문자열. contactGroupResourceName만 멤버십을 수정하는 데 사용할 수 있습니다. 모든 연락처 그룹 멤버십은 삭제할 수 있지만 사용자 그룹 또는 'myContacts'만 삭제할 수 있습니다. 또는 '별표표시함' 시스템 그룹 멤버십을 추가할 수 있습니다. 연락처에는 항상 하나 이상의 연락처 그룹 회원이 있어야 합니다.

DomainMembership

Google Workspace 도메인 멤버십.

JSON 표현 
{
  "inViewerDomain": boolean
}
필드
inViewerDomain

boolean

사용자가 뷰어의 Google Workspace 도메인에 속한 경우 참입니다.

MiscKeyword

개인의 기타 키워드입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

기타 키워드에 대한 메타데이터입니다.
value

string

기타 키워드의 값입니다.
type

enum (KeywordType)

기타 키워드 유형입니다.
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 기타 키워드의 유형입니다.

KeywordType

기타 키워드의 유형입니다.

열거형
TYPE_UNSPECIFIED 지정되지 않았습니다.
OUTLOOK_BILLING_INFORMATION 결제 정보를 위한 Outlook 필드입니다.
OUTLOOK_DIRECTORY_SERVER 디렉터리 서버의 Outlook 필드입니다.
OUTLOOK_KEYWORD 키워드의 Outlook 필드입니다.
OUTLOOK_MILEAGE 마일리지를 확인하는 Outlook 필드입니다.
OUTLOOK_PRIORITY 우선순위를 위한 Outlook 필드입니다.
OUTLOOK_SENSITIVITY 민감도에 대한 Outlook 필드입니다.
OUTLOOK_SUBJECT 제목의 Outlook 필드입니다.
OUTLOOK_USER 사용자의 Outlook 필드입니다.
HOME 홈.
WORK 직장으로 이동합니다.
OTHER 기타.

이름

사람의 이름입니다. 이름이 한명명인 경우 성이 비어 있습니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}
필드
metadata

object (FieldMetadata)

이름에 대한 메타데이터입니다.
displayName

string

출력 전용입니다. 뷰어의 계정 또는 Accept-Language HTTP 헤더에서 지정한 언어에 따라 형식이 지정된 표시 이름입니다.
displayNameLastFirst

string

출력 전용입니다. 먼저 뷰어의 계정 또는 Accept-Language HTTP 헤더에서 지정한 언어에 따라 형식이 지정된 성을 포함하는 표시 이름입니다.
unstructuredName

string

자유 형식의 이름 값입니다.
familyName

string

성입니다.
givenName

string

지정된 이름입니다.
middleName

string

중간 이름
honorificPrefix

string

경어 접두사(예: Mrs. 또는 Dr.)
honorificSuffix

string

경어 접미사(예: Jr.)
phoneticFullName

string

발음 그대로 입력하세요.
phoneticFamilyName

string

성의 철자를 그대로 표기합니다.
phoneticGivenName

string

주어진 이름입니다.
phoneticMiddleName

string

들리는 대로 철자를 입력하세요.
phoneticHonorificPrefix

string

들리는 대로 표기된 경어 접두사입니다.
phoneticHonorificSuffix

string

들리는 대로 표기된 경어 접미사입니다.

닉네임

사람의 닉네임입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}
필드
metadata

object (FieldMetadata)

닉네임에 대한 메타데이터입니다.
value

string

닉네임입니다.
type

enum (NicknameType)

닉네임의 유형입니다.

NicknameType

닉네임의 유형입니다.

열거형
DEFAULT 일반적인 닉네임입니다.
MAIDEN_NAME

결혼 전 성 또는 출생 성 결혼으로 인해 성이 변경된 경우 사용됩니다.
INITIALS

이니셜
GPLUS

Google+ 프로필 닉네임
OTHER_NAME

소속사 또는 기타 이름 예: Dr. Smith.
ALTERNATE_NAME 다른 사람의 이름을 아는 사람입니다.
SHORT_NAME

개인 이름의 짧은 버전입니다.

직업

개인의 직업입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

직업에 관한 메타데이터입니다.
value

string

직업 예: carpenter

조직

개인의 과거 또는 현재 조직입니다. 중복 기간은 허용됩니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}
필드
metadata

object (FieldMetadata)

조직에 관한 메타데이터입니다.
type

string

조직의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • work
  • school
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환되고 형식이 지정된 조직의 유형입니다.
startDate

object (Date)

사용자가 조직에 가입한 시작일입니다.
endDate

object (Date)

사용자가 조직을 떠난 종료일입니다.
current

boolean

조직이 개인의 현재 조직인 경우 참입니다. 조직이 과거 조직인 경우 false입니다.
name

string

조직의 이름입니다.
phoneticName

string

조직의 이름(소리나는 대로)입니다.
department

string

조직 내 개인의 부서입니다.
title

string

개인의 조직 내 직책입니다.
jobDescription

string

개인의 조직 내 직무 설명입니다.
symbol

string

조직과 관련된 상징 주식 종목 기호, 약어, 두문자어를 예로 들 수 있습니다.
domain

string

조직과 연결된 도메인 이름 예: google.com
location

string

직원이 근무하는 조직 사무실의 위치입니다.
costCenter

string

조직의 개인 비용 센터입니다.
fullTimeEquivalentMillipercent

integer

조직 내 개인의 풀타임에 상응하는 밀리초 (100,000 = 100%)입니다.

전화번호

사람의 전화번호입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

전화번호에 대한 메타데이터입니다.
value

string

전화번호입니다.
canonicalForm

string

출력 전용입니다. 전화번호의 표준화된 ITU-T E.164 형식입니다.
type

string

전화번호 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • mobile
  • homeFax
  • workFax
  • otherFax
  • pager
  • workMobile
  • workPager
  • main
  • googleVoice
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 번역되고 형식이 지정된 전화번호 유형입니다.

사진

인물 사진입니다. 다른 사람이 사람을 알아볼 수 있도록 이름 옆에 사진이 표시됩니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
필드
metadata

object (FieldMetadata)

사진에 대한 메타데이터입니다.
url

string

사진의 URL입니다. URL 끝에 쿼리 매개변수 sz={size}를 추가하여 원하는 크기를 변경할 수 있습니다. 여기서 {size}는 픽셀 단위의 크기입니다. 예: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
default

boolean

사진이 기본 사진이면 true이고, 사진이 사용자 제공 사진인 경우 false입니다.

관계

한 사람과 다른 사람의 관계입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

관계에 대한 메타데이터입니다.
person

string

이 관계가 참조하는 다른 사람의 이름입니다.
type

string

상대와 상대방 사이의 관계입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • spouse
  • child
  • mother
  • father
  • parent
  • brother
  • sister
  • friend
  • relative
  • domesticPartner
  • manager
  • assistant
  • referredBy
  • partner
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더에 지정된 로케일로 변환되고 형식이 지정된 관계의 유형입니다.

RelationshipInterest

지원 중단됨: 데이터가 반환되지 않습니다. 개인의 관계에 대한 관심분야입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
필드
metadata

object (FieldMetadata)

관계 관심분야에 대한 메타데이터입니다.
value

string

그 사람이 찾고 있는 관계의 종류입니다. 값은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • friend
  • date
  • relationship
  • networking
formattedValue

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더에 지정된 언어로 번역되고 형식이 지정된 관계 관심 값입니다.

RelationshipStatus

지원 중단됨: 개인의 관계 상태는 반환되지 않습니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
필드
metadata

object (FieldMetadata)

관계 상태에 대한 메타데이터입니다.
value

string

연애/결혼 상태 값은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • single
  • inARelationship
  • engaged
  • married
  • itsComplicated
  • openRelationship
  • widowed
  • inDomesticPartnership
  • inCivilUnion
formattedValue

string

출력 전용입니다. 보기 권한 사용자의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 관계 상태의 값입니다.

주거지

지원 중단됨: person.locations를 대신 사용하세요. 개인의 과거 또는 현재 거주지입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}
필드
metadata

object (FieldMetadata)

주택에 관한 메타데이터입니다.
value

string

거주지 주소입니다.
current

boolean

해당 거주지가 개인의 현재 거주지인 경우 참입니다. 거짓으로 간주됩니다.

SipAddress

사용자의 SIP 주소입니다. 세션 초기 프로토콜 주소는 인터넷을 통해 음성 또는 영상 통화를 하기 위해 VoIP 통신에 사용됩니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

SIP 주소에 관한 메타데이터입니다.
value

string

RFC 3261 19.1 SIP URI 형식의 SIP 주소입니다.
type

string

SIP 주소의 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • mobile
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환 및 형식이 지정된 SIP 주소의 유형입니다.

기술

그 사람이 가진 스킬입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

스킬에 대한 메타데이터입니다.
value

string

스킬, 예: underwater basket weaving

소개 문구

지원 중단됨: 데이터가 반환되지 않습니다. 개인에 대한 1줄의 간단한 설명입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
필드
metadata

object (FieldMetadata)

소개 문구에 관한 메타데이터입니다.
value

string

소개 문구

URL

개인과 연결된 URL입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
필드
metadata

object (FieldMetadata)

URL에 대한 메타데이터입니다.
value

string

URL입니다.
type

string

URL 유형입니다. 유형은 커스텀 값 또는 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • blog
  • profile
  • homePage
  • ftp
  • reservations
  • appInstallPage: Currents 애플리케이션의 웹사이트입니다.
  • other
formattedType

string

출력 전용입니다. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 번역되고 형식이 지정된 URL 유형입니다.

UserDefined

최종 사용자가 채우는 임의 사용자 데이터입니다.

JSON 표현 
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
필드
metadata

object (FieldMetadata)

사용자 정의 데이터에 대한 메타데이터입니다.
key

string

사용자 정의 데이터의 최종 사용자 지정 키입니다.
value

string

사용자 정의 데이터의 최종 사용자 지정 값입니다.

메서드

batchCreateContacts

새 연락처를 일괄적으로 생성하고 새로운 연락처에 대한 PersonResponses를

지연 시간 및 실패 증가를 방지하려면 동일한 사용자에 대한 변형 요청을 순차적으로 전송해야 합니다.

batchDeleteContacts

 연락처 일괄 삭제

batchUpdateContacts

 연락처를 일괄적으로 업데이트하고 업데이트된 연락처에 대한 리소스 이름 맵을 PersonResponses에 반환합니다.

createContact

 새 연락처를 만들고 해당 연락처의 사람 리소스를 반환합니다.

deleteContact

 담당자 삭제

deleteContactPhoto

 연락처 사진 삭제

get

 리소스 이름을 지정하여 사람에 대한 정보를 제공합니다.

getBatchGet

 요청된 리소스 이름 목록을 지정하여 특정 사용자 목록에 대한 정보를 제공합니다.

listDirectoryPeople

 인증된 사용자의 도메인 디렉터리에 있는 도메인 프로필 및 도메인 연락처 목록을 제공합니다.

searchContacts

 인증된 사용자의 그룹화된 연락처 중 검색어와 일치하는 연락처 목록을 제공합니다.

searchDirectoryPeople

 인증된 사용자의 도메인 디렉터리에서 검색어와 일치하는 도메인 프로필 및 도메인 연락처 목록을 제공합니다.

updateContact

 기존 담당자의 연락처 데이터를 업데이트합니다.

updateContactPhoto

 연락처 사진을 업데이트합니다.