REST Resource: people

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

object (Source)

개인의 데이터 소스입니다.

string

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

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

string

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

boolean

출력 전용. 사람 리소스가 삭제된 경우 true입니다. people.connections.list 및 otherContacts.list 동기화 요청에 대해서만 채워집니다.

enum (ObjectType)

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

사람 객체의 유형입니다.

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}

enum (SourceType)

소스 유형입니다.

string

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

string

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

소스의 HTTP 항목 태그입니다. 웹 캐시 검증에 사용됩니다.

string (Timestamp format)

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

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".

object (ProfileMetadata)

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

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

{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}

enum (ObjectType)

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

enum (UserType)

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

{
  "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
}

object (FieldMetadata)

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

string

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

string

주소의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• home
• work
• other

string

출력 전용. 보기 권한 사용자의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환되고 형식이 지정된 주소 유형입니다.

string

주소의 사서함

string

상세 주소입니다.

string

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

string

주소의 도시입니다.

string

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

string

주소의 우편번호입니다.

string

주소의 국가입니다.

string

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

{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}

boolean

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

boolean

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

boolean

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

object (Source)

필드의 소스입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}

object (FieldMetadata)

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

enum (AgeRange)

연령대입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}

object (FieldMetadata)

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

string

짧은 전기

enum (ContentType)

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}

object (FieldMetadata)

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

object (Date)

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

string

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

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

캘린더 URL에 관한 메타데이터

string

캘린더 URL입니다.

string

캘린더 URL 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• home
• freeBusy
• work

string

출력 전용. 보기 권한 사용자의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 변환되고 형식이 지정된 캘린더 URL 유형입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

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

string

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

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

string

표지 사진의 URL입니다.

boolean

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}

object (FieldMetadata)

이메일 주소에 관한 메타데이터

string

이메일 주소입니다.

string

이메일 주소의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• home
• work
• other

string

출력 전용. 보기 권한 사용자의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 번역되고 형식이 지정된 이메일 주소의 유형입니다.

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

object (Date)

이벤트 날짜입니다.

string

이벤트 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• anniversary
• other

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

string

외부 ID의 값입니다.

string

외부 ID의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• account
• customer
• loginId
• network
• organization

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

파일에 대한 메타데이터

string

파일 형식 값

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}

object (FieldMetadata)

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

string

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

• male
• female
• unspecified

string

출력 전용. 뷰어의 계정 언어 또는 Accept-Language HTTP 헤더 언어로 번역되고 형식이 지정된 성별 값입니다. 지정되지 않았거나 맞춤 값이 현지화되지 않았습니다.

string

사람을 지칭하는 데 사용할 인칭 대명사 텍스트 입력란입니다. 일반적인 값은 다음과 같습니다.

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}

object (FieldMetadata)

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

string

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

string

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

• home
• work
• other

string

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

string

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

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

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

string

관심분야입니다(예: stargazing).

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}

object (FieldMetadata)

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

string

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

string

위치의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• desk
• grewUp

boolean

위치가 현재 위치인지 여부

string

건물 식별자입니다.

string

층 이름 또는 번호입니다.

string

floor_name의 층 섹션

string

개별 데스크 위치입니다.

{
  "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.
}

object (FieldMetadata)

멤버십에 대한 메타데이터입니다.

object (ContactGroupMembership)

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

object (DomainMembership)

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

{
  "contactGroupId": string,
  "contactGroupResourceName": string
}

string

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

string

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

{
  "inViewerDomain": boolean
}

boolean

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}

object (FieldMetadata)

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

string

기타 키워드의 값입니다.

enum (KeywordType)

기타 키워드 유형.

string

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

{
  "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
}

object (FieldMetadata)

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

string

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

string

출력 전용. 뷰어의 계정 또는 Accept-Language HTTP 헤더에 지정된 언어에 따라 성이 처음 표시되는 표시 이름입니다.

string

자유 형식 이름 값입니다.

string

성입니다.

string

주어진 이름입니다.

string

중간 이름입니다.

string

유효한 접두사(예: Mrs. 또는 Dr.)

string

다음의 이름(예: Jr.)

string

전체 이름의 발음과 같습니다.

string

성의 철자가 발음과 같습니다.

string

이름의 철자가 발음과 같습니다.

string

중간 이름의 철자가 발음과 같습니다.

string

유효한 접두사가 들리는 대로 표기합니다.

string

경어로 보이는 철자 그대로의 철자입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}

object (FieldMetadata)

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

string

닉네임입니다.

enum (NicknameType)

닉네임의 유형입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

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

string

직업입니다(예: carpenter).

{
  "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
}

object (FieldMetadata)

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

string

조직의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

• work
• school

string

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

object (Date)

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

object (Date)

사용자가 조직을 떠난 종료일

boolean

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

string

조직의 이름입니다.

string

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

string

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

string

조직의 직책입니다.

string

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

string

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

string

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

string

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

string

조직의 비용 센터입니다.

integer

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

string

전화번호입니다.

string

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

string

전화번호 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

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

string

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

boolean

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

string

이 관계가 지칭하는 사람의 이름입니다.

string

상대방과의 관계 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

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

string

출력 전용. 보기 전용 사용자의 계정 언어 또는 Accept-Language HTTP 헤더에 지정된 언어로 번역되고 지정된 관계의 유형입니다.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

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

string

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

• friend
• date
• relationship
• networking

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

연애/결혼 상태에 대한 메타데이터

string

연애/결혼 상태입니다. 값은 맞춤이거나 다음 사전 정의된 값 중 하나입니다.

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}

object (FieldMetadata)

거주지에 관한 메타데이터입니다.

string

거주지 주소입니다.

boolean

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

string

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

string

SIP 주소의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나입니다.

• home
• work
• mobile
• other

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

기술에 대한 메타데이터

string

기술(예: underwater basket weaving)

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

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

string

소개 문구

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

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

string

URL입니다.

string

URL의 유형입니다. 유형은 맞춤이거나 다음 사전 정의된 값 중 하나일 수 있습니다.

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

string

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

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

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

string

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

string

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