本頁面由 Cloud Translation API 翻譯而成。

Entity
透過集合功能整理內容你可以依據偏好儲存及分類內容。

代表文字中已知實體的字詞，例如人物、機構或地點。API 會將醒目效果和提及等資訊與實體建立關聯。

JSON 表示法
{ "name": string, "type": enum (`Type`), "metadata": { string: string, ... }, "salience": number, "mentions": [ { object (`EntityMention`) } ], "sentiment": { object (`Sentiment`) } }

欄位
`name`	`string` 實體的代表名稱。
`type`	`enum (Type)` 實體類型。
`metadata`	`map (key: string, value: string)` 與實體相關聯的中繼資料。對於大多數實體類型，中繼資料是 Wikipedia 網址 (`wikipedia_url`) 和 Knowledge Graph MID (`mid`) (如有)。如要瞭解與其他實體類型相關聯的中繼資料，請參閱下方的「類型」表格。包含 `"key": value` 組合清單的物件。範例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`salience`	`number` 與實體相關聯的顯著性分數，範圍為 [0, 1.0]。實體的顯著性分數可提供該實體對整篇文件文字的重要性或中心性相關資訊。分數越接近 0，醒目程度越低，越接近 1.0，醒目程度越高。
`mentions[]`	`object (EntityMention)` 輸入文件中提及這個實體的次數。這個 API 目前支援專有名詞提及。
`sentiment`	`object (Sentiment)` 如果您呼叫 [AnalyzeEntitySentiment][]，或是將 `AnnotateTextRequest.Features.extract_entity_sentiment` 設為 true，這個欄位就會包含在提供文件中，針對此實體所表達的整體情緒。

類型

實體的類型。對於大多數實體類型，相關聯的中繼資料是 Wikipedia 網址 (wikipedia_url) 和 Knowledge Graph MID (mid)。下表列出具有不同中繼資料的實體相關聯欄位。

列舉
`UNKNOWN`	不明
`PERSON`	人物
`LOCATION`	位置
`ORGANIZATION`	機構
`EVENT`	活動
`WORK_OF_ART`	藝術品
`CONSUMER_GOOD`	消費性產品
`OTHER`	其他類型的實體
`PHONE_NUMBER`	電話號碼中繼資料會列出電話號碼，並根據當地慣例設定格式，以及文字中顯示的其他元素： `number` - 實際號碼，依照當地慣例細分為多個部分 `national_prefix` - 國家/地區代碼 (如有偵測到) `area_code` - 區域或區碼 (如有) `extension` - 電話分機 (連線後撥打) (如有偵測到)
`ADDRESS`	地址中繼資料會標示街道號碼和地區，以及文字中顯示的其他元素： `street_number` - 門牌號碼 `locality` - 城市或鄉鎮 `street_name` - 街道/路線名稱 (如果偵測到) `postal_code` - 郵遞區號 (如果偵測到) `country` - 國家/地區 (如果偵測到) < `broad_region` - 系統偵測到的行政區 (例如州/省) `narrow_region`：如有偵測到，則為較小的行政區域，例如縣 `sublocality`：用於亞洲地址，用於標示城市內的區域 (如有偵測到)
`DATE`	日期中繼資料會標示日期的各個元件： `year` - 以四位數字表示的年份 (如有偵測到) `month` - 以兩位數字表示的月份 (如果偵測到) `day` - 以兩位數字表示的日期 (如果偵測到)
`NUMBER`	數字中繼資料就是數字本身。
`PRICE`	價格中繼資料會標示 `value` 和 `currency`。

代表文字中提及的實體。目前支援專有名詞提及功能。

JSON 表示法
{ "text": { object (`TextSpan`) }, "type": enum (`Type`), "sentiment": { object (`Sentiment`) } }

欄位

欄位
`text`	`object (TextSpan)` 提及文字。
`type`	`enum (Type)` 實體提及的類型。
`sentiment`	`object (Sentiment)` 如果您呼叫 [AnalyzeEntitySentiment][] 或將 `AnnotateTextRequest.Features.extract_entity_sentiment` 設為 true，這個欄位就會包含在提供文件中提及此實體時所表達的情緒。

text

object (TextSpan)

提及文字。

type

enum (Type)

實體提及的類型。

sentiment

object (Sentiment)

如果您呼叫 [AnalyzeEntitySentiment][] 或將 AnnotateTextRequest.Features.extract_entity_sentiment 設為 true，這個欄位就會包含在提供文件中提及此實體時所表達的情緒。

支援的提及類型。