Person
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
JSON 表示法 |
{
"name": string,
"obfuscatedId": string,
"personNames": [
{
object (Name )
}
],
"emailAddresses": [
{
object (EmailAddress )
}
],
"phoneNumbers": [
{
object (PhoneNumber )
}
],
"photos": [
{
object (Photo )
}
]
} |
欄位 |
name |
string
要提供資訊的使用者資源名稱。請參閱 Google People API 的 People.get 。
|
obfuscatedId |
string
使用者經模糊處理的 ID。
|
personNames[] |
object (Name )
對方的姓名
|
emailAddresses[] |
object (EmailAddress )
對方的電子郵件地址
|
phoneNumbers[] |
object (PhoneNumber )
使用者的電話號碼
|
photos[] |
object (Photo )
某人的唯讀相片。顯示在使用者名稱旁邊的圖片,可協助其他人在搜尋結果中辨識該使用者。
|
名稱
JSON 表示法 |
{
"displayName": string
} |
欄位 |
displayName |
string
只讀顯示名稱,格式依照觀看者帳戶或 Accept-Language HTTP 標頭指定的語言代碼。
|
EmailAddress
JSON 表示法 |
{
"emailAddress": string,
"primary": boolean,
"type": string,
"customType": string,
"emailUrl": string
} |
欄位 |
emailAddress |
string
電子郵件地址。
|
primary |
boolean
指出這是否為使用者的主要電子郵件地址。只能將一個項目標示為主要項目。
|
type |
string
電子郵件帳戶類型。可接受的值包括:"custom"、"home"、"other"、"work"。
|
customType |
string
如果類型的值為自訂,這個屬性會包含自訂類型字串。
|
emailUrl |
string
傳送電子郵件的網址。
|
PhoneNumber.PhoneNumberType
相片
JSON 表示法 |
{
"url": string
} |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Person\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [Name](#Name)\n - [JSON representation](#Name.SCHEMA_REPRESENTATION)\n- [EmailAddress](#EmailAddress)\n - [JSON representation](#EmailAddress.SCHEMA_REPRESENTATION)\n- [PhoneNumber](#PhoneNumber)\n - [JSON representation](#PhoneNumber.SCHEMA_REPRESENTATION)\n- [PhoneNumber.PhoneNumberType](#PhoneNumber.PhoneNumberType)\n- [Photo](#Photo)\n - [JSON representation](#Photo.SCHEMA_REPRESENTATION)\n\nObject to represent a person.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"obfuscatedId\": string, \"personNames\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/Person#Name) } ], \"emailAddresses\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress) } ], \"phoneNumbers\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber) } ], \"photos\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/Person#Photo) } ] } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of the person to provide information about. See [`People.get`](https://developers.google.com/people/api/rest/v1/people/get) from the Google People API. |\n| `obfuscatedId` | `string` Obfuscated id of a person. |\n| `personNames[]` | `object (`[Name](/workspace/cloud-search/docs/reference/rest/v1/Person#Name)`)` The person's name |\n| `emailAddresses[]` | `object (`[EmailAddress](/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress)`)` The person's email addresses |\n| `phoneNumbers[]` | `object (`[PhoneNumber](/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber)`)` The person's phone numbers |\n| `photos[]` | `object (`[Photo](/workspace/cloud-search/docs/reference/rest/v1/Person#Photo)`)` A person's read-only photo. A picture shown next to the person's name to help others recognize the person in search results. |\n\nName\n----\n\nA person's name.\n\n| JSON representation |\n|-----------------------------------|\n| ``` { \"displayName\": string } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `displayName` | `string` The read-only display name formatted according to the locale specified by the viewer's account or the `Accept-Language` HTTP header. |\n\nEmailAddress\n------------\n\nA person's email address.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------|\n| ``` { \"emailAddress\": string, \"primary\": boolean, \"type\": string, \"customType\": string, \"emailUrl\": string } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------|\n| `emailAddress` | `string` The email address. |\n| `primary` | `boolean` Indicates if this is the user's primary email. Only one entry can be marked as primary. |\n| `type` | `string` The type of the email account. Acceptable values are: \"custom\", \"home\", \"other\", \"work\". |\n| `customType` | `string` If the value of type is custom, this property contains the custom type string. |\n| `emailUrl` | `string` The URL to send email. |\n\nPhoneNumber\n-----------\n\nA person's Phone Number\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"phoneNumber\": string, \"type\": enum (/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.PhoneNumberType) } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `phoneNumber` | `string` The phone number of the person. |\n| `type` | `enum (`[PhoneNumber.PhoneNumberType](/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.PhoneNumberType)`)` |\n\nPhoneNumber.PhoneNumberType\n---------------------------\n\nPhone number type enum.\n\n| Enums ||\n|----------|---|\n| `OTHER` | |\n| `MOBILE` | |\n| `OFFICE` | |\n\nPhoto\n-----\n\nA person's photo.\n\n| JSON representation |\n|---------------------------|\n| ``` { \"url\": string } ``` |\n\n| Fields ||\n|-------|--------------------------------|\n| `url` | `string` The URL of the photo. |"]]