REST Resource: people.connections

リソース: 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)

ユーザーのファイルファイル。

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)

そのユーザーのユーザー定義データ。

Methods

list

認証されたユーザーの連絡先のリストを提供します。