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

私書箱は入力します。

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 に設定したフィールドを 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 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。

integer

1 月の中の日付。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)

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)

IM クライアントに関するメタデータ。

string

IM クライアントで使用されるユーザー名。

string

IM クライアントのタイプ。型は、カスタム値、または次の定義済みの値のいずれかです。

• home
• work
• other

string

出力専用。閲覧者のアカウントの言語 / 地域または Accept-Language HTTP ヘッダーの言語 / 地域に翻訳およびフォーマットされた IM クライアントのタイプ。

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

建物の ID。

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」のみです「スター付き」システム グループのメンバーを追加できます。連絡先には、常に 1 つ以上の連絡先グループ メンバーシップが必要です。

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

組織内のフルタイムに換算した割合（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

居住地がその人の現在の居住地である場合は 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

ユーザー定義データのエンドユーザー指定値。