Method: people.get

透過指定資源名稱來提供人員相關資訊。使用 people/me 表示已驗證的使用者。

如未指定「personFields」,要求會傳回 400 錯誤。

HTTP 要求

GET https://people.googleapis.com/v1/{resourceName=people/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
resourceName

string

必要欄位。要提供相關資訊的人員資源名稱。

  • 如要取得已驗證使用者的資訊,請指定 people/me
  • 如要取得 Google 帳戶的相關資訊,請指定 people/{account_id}
  • 如要取得聯絡人的相關資訊,請指定能識別 people.connections.list 傳回聯絡人的資源名稱。

查詢參數

參數
requestMask
(deprecated)

object (RequestMask)

已淘汰 (請改用 personFields)

可將結果限制為部分個人欄位的遮罩。

personFields

string (FieldMask format)

必要欄位。欄位遮罩,用於限制傳回使用者上的欄位。如要指定多個欄位,請用半形逗號分隔。以下為有效值:

  • addresses
  • ageRanges
  • 傳記
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • 活動
  • externalIds
  • 性別
  • imClients
  • 興趣
  • locales
  • 地點
  • 會籍
  • 中繼資料
  • miscKeywords
  • names
  • 暱稱
  • 職業
  • organizations
  • phoneNumbers
  • 相片
  • 關係
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

選用設定。要傳回哪些來源類型的遮罩。如未設定,預設值為 READ_SOURCE_TYPE_PROFILEREAD_SOURCE_TYPE_CONTACT

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Person 的執行例項。

授權範圍

不需授權即可存取公開資料。如果是私人資料,必須提供下列其中一個 OAuth 範圍:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile

詳情請參閱授權指南