REST Resource: people

리소스: Person

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

대부분의 필드에는 여러 항목이 포함될 수 있습니다. 필드 내 항목의 순서는 보장되지 않지만 비어 있지 않은 각 필드에는 metadata.primary가 true로 설정된 필드가 정확히 1개 있습니다.

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개로 제한됩니다. Person의 이메일 주소가 더 있다면 people.getBatchGet를 호출하여 전체 집합을 가져올 수 있습니다.

events[]

object (Event)

사용자의 이벤트입니다.

externalIds[]

object (ExternalId)

사용자의 외부 ID

fileAses[]

object (FileAs)

사용자의 파일-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.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)

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

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

주소의 사서함입니다.

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

출력 전용. 필드가 사람에 있는 모든 소스의 기본 필드이면 true입니다. 각 사용자는 primary가 true로 설정된 필드를 최대 1개 사용할 수 있습니다.

sourcePrimary

boolean

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

verified

boolean

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

source

object (Source)

필드의 소스입니다.

AgeRange

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

개인의 연령대입니다.

열거형
AGE_RANGE_UNSPECIFIED 지정되지 않았습니다.
LESS_THAN_EIGHTEEN 만 18세 미만입니다.
EIGHTEEN_TO_TWENTY 18에서 20 사이입니다.
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 텍스트.

생일

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

JSON 표현
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}
입력란
metadata

object (FieldMetadata)

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

date

object (Date)

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

text
(deprecated)

string

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

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

날짜

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

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 0년을 사용한 월과 일 (예: 기념일)
  • 0개월과 0일로 구성된 1년입니다.
  • 연도와 월을 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 헤더 언어로 번역되고 형식이 지정된 이벤트의 유형입니다.

ExternalId

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

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)

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

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)

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

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

조직이 개인의 현재 조직인 경우 참이고 이전 조직인 경우 거짓입니다.

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%)입니다.

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

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

해당 거주지가 그 사람의 현재 거주지인 경우 'true'이고, 이전 거주지인 경우 'false'입니다.

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)

소개 문구

지원 중단됨: 데이터는 반환되지 않습니다. 인물에 관한 간략한 한 줄 설명입니다.

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

새 연락처 배치를 만들고 새로운

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

batchDeleteContacts

연락처 일괄 삭제

batchUpdateContacts

연락처 배치를 업데이트하고 업데이트된 연락처에 대한 리소스 이름 맵을 PersonResponses에 반환합니다.

createContact

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

deleteContact

담당자 삭제

deleteContactPhoto

연락처 사진 삭제

get

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

getBatchGet

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

listDirectoryPeople

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

searchContacts

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

searchDirectoryPeople

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

updateContact

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

updateContactPhoto

연락처 사진 업데이트