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,

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

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

P.O. 있습니다.

string

상세 주소입니다.

string

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

string

주소의 도시입니다.

string

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

string

주소의 우편번호입니다.

string

주소의 국가입니다.

string

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

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

boolean

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

boolean

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

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~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

integer

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

integer

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

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

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

string

file-as 값

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

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

string

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

string

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

• home
• work
• other

string

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

string

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

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

string

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

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

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

{
  "inViewerDomain": boolean
}

boolean

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

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

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

string

조직의 이름입니다.

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

integer

조직 내 개인의 풀타임에 상응하는 밀리초 (100,000 = 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

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

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

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