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.listotherContacts.list의 경우 이메일 주소 수가 100개로 제한됩니다. 사용자에게 더 많은 이메일 주소가 있는 경우 people.getBatchGet를 호출하여 전체 세트를 가져올 수 있습니다.

events[]

object (Event)

사용자의 일정입니다.

externalIds[]

object (ExternalId)

개인의 외부 ID입니다.

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.listotherContacts.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)

해당 사용자가 정의한 데이터입니다.

사용자 메타데이터

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

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.listotherContacts.list 동기화 요청에 대해서만 채워집니다.

objectType
(deprecated)

enum (ObjectType)

출력 전용. 지원 중단됨 (대신 person.metadata.sources.profileMetadata.objectType를 사용하세요.)

사람 객체의 유형입니다.

출처

필드의 소스입니다.

JSON 표현
{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}
필드
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".

profileMetadata

object (ProfileMetadata)

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

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

소스 유형

소스의 유형입니다.

열거형
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 도메인 공유 연락처

프로필 메타데이터

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

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

enum (ObjectType)

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

userTypes[]

enum (UserType)

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

객체 유형

사람 객체의 유형입니다.

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

사용자 유형

사용자 유형입니다.

열거형
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

주소의 사서함

streetAddress

string

상세 주소입니다.

extendedAddress

string

주소의 확장된 주소입니다(예: 아파트 번호).

city

string

주소의 도시입니다.

region

string

주소의 지역입니다(예: 주/도).

postalCode

string

주소의 우편번호입니다.

country

string

주소의 국가입니다.

countryCode

string

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

필드 메타데이터

필드에 관한 메타데이터

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

boolean

출력 전용. 필드가 사람에 속한 모든 소스의 기본 필드인 경우 true입니다. 각 사용자에게는 primary가 true로 설정된 최대 1개의 필드가 있습니다.

sourcePrimary

boolean

필드가 source의 기본 필드인 경우 true입니다. 각 소스에는 sourcePrimary가 true로 설정된 필드가 하나만 있어야 합니다.

verified

boolean

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

source

object (Source)

필드의 소스입니다.

연령대

지원 중단됨 (대신 person.ageRanges를 사용하세요.)

개인의 연령대입니다.

열거형
AGE_RANGE_UNSPECIFIED 지정되지 않았습니다.
LESS_THAN_EIGHTEEN 18세 미만
EIGHTEEN_TO_TWENTY 18~20
TWENTY_ONE_OR_OLDER 만 21세 이상.

연령대 유형

개인의 연령대입니다.

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 텍스트

생일

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

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

object (FieldMetadata)

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

date

object (Date)

생일의 구조화된 날짜입니다.

text
(deprecated)

string

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

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

날짜

생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 시간 및 시간대는 다른 곳에서 지정하거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0인 전체 날짜
  • 0년이 되는 연월일 (예: 기념일)
  • 그 자체로 1년이며 0개월과 0일입니다.
  • 연도와 월, 0일 (예: 신용카드 만료일)

관련 유형:

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

integer

날짜 연도입니다. 1~9,999 사이의 값이어야 하며, 1년 없이 날짜를 지정하려면 0이어야 합니다.

month

integer

월 범위는 1~12여야 합니다. 월과 일 없이 연도를 지정하려면 0이어야 합니다.

day

integer

날짜입니다. 1~31 사이의 값이어야 하며 연과월에 유효해야 합니다. 단, 연도를 직접 지정하거나 연도가 중요하지 않은 연도와 월을 지정해야 합니다.

자랑거리

지원 중단됨: 개인의 자랑 권리가 반환되지 않습니다.

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

object (FieldMetadata)

자랑거리에 대한 메타데이터

value

string

자랑할 만한 권리입니다(예: climbed mount everest).

캘린더 URL

개인의 캘린더 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 유형입니다.

고객 데이터

클라이언트에 의해 채워진 임의의 클라이언트 데이터입니다. 중복 키 및 값은 허용됩니다.

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

object (FieldMetadata)

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

key

string

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

value

string

클라이언트에서 지정한 클라이언트 데이터 값입니다.

표지사진

인물의 표지 사진 사용자의 프로필 페이지에 표시되는 본인 확인 대상 또는 관심 대상의 큰 이미지

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)

파일에 대한 메타데이터

value

string

파일 형식 값

성별

개인의 성별입니다.

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)

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

username

string

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

type

string

메신저 클라이언트의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

  • home
  • work
  • other
formattedType

string

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

protocol

string

IM 클라이언트의 프로토콜입니다. 프로토콜은 맞춤 설정되거나 다음과 같은 사전 정의된 값 중 하나일 수 있습니다.

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

string

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

관심

사용자의 관심분야 중 하나입니다.

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)

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

연락처 그룹 멤버십

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

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

string

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

contactGroupResourceName

string

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

도메인 멤버십

Google Workspace 도메인 멤버십

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

boolean

사용자가 뷰어의 Google Workspace 도메인에 있는 경우 true입니다.

기타 키워드

사용자의 기타 키워드입니다.

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

object (FieldMetadata)

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

value

string

기타 키워드의 값입니다.

type

enum (KeywordType)

기타 키워드 유형.

formattedType

string

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

키워드 유형

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

열거형
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)

닉네임의 유형입니다.

닉네임 유형

닉네임의 유형입니다.

열거형
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

조직이 사용자의 현재 조직인 경우 true, 조직이 이전 조직인 경우 false입니다.

name

string

조직의 이름입니다.

phoneticName

string

조직의 이름(소리 나는 대로)

department

string

조직 내 사용자의 부서입니다.

title

string

조직의 직책입니다.

jobDescription

string

조직에서 일하는 사람의 설명입니다.

symbol

string

조직과 관련된 기호입니다(예: 주식 시세 기호, 약어, 두문자어).

domain

string

조직과 연결된 도메인 이름입니다(예: google.com).

location

string

개인이 근무하는 조직 사무실의 위치

costCenter

string

조직의 비용 센터입니다.

fullTimeEquivalentMillipercent

integer

개인의 조직 내 정규직 밀리초 (100000 = 100%)입니다.

PhoneNumber

개인의 전화번호입니다.

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 헤더에 지정된 언어로 번역되고 지정된 관계의 유형입니다.

연애/결혼

지원 중단됨: 사용자의 관계 관심분야가 반환되지 않습니다 .

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

object (FieldMetadata)

관계 관심분야에 대한 메타데이터

value

string

사용자가 찾는 관계의 종류 값은 맞춤이거나 다음 사전 정의된 값 중 하나입니다.

  • friend
  • date
  • relationship
  • networking
formattedValue

string

출력 전용. 보기 전용 사용자의 계정 언어 또는 Accept-Language HTTP 헤더에 지정된 언어로 변환된 관계 관심분야의 값입니다.

연애/결혼 상태

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

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

사용자의 현재 거주지인 경우 true, 이전 거주지인 경우 false입니다.

SIP주소

개인의 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)

소개 문구

지원 중단됨: 데이터가 반환되지 않습니다. 사람에 대한 간단한 한 줄 설명이 표시됩니다.

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의 유형입니다.

사용자 정의

최종 사용자가 채우는 임의의 사용자 데이터

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

연락처 사진 업데이트