REST Resource: projects.locations.conversations

資源：Conversation

對話訊息。

JSON 表示法 
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  },
  "kmsKey": string
}
欄位
name

string

選用。ID。對話的不重複資源名稱。格式：projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} 是資源 ID，長度應為 63 個字元以下，且必須符合 https://google.aip.dev/122#resource-id-segments 中說明的格式

範例：projects/1234567890/locations/global/conversations/my-conversation。

建議在建立對話時略過設定這個欄位，因為系統會自動推斷並覆寫 {parent}/conversations/{conversationId}。
agents[]

string

這是必要旗標，對話中的代理程式。目前僅支援一個代理程式。這個欄位會重複，以便日後支援在對話中加入多位代理人。格式：projects/{project}/locations/{location}/dataAgents/{agent}
createTime

string (Timestamp format)

僅供輸出。建立時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastUsedTime

string (Timestamp format)

僅供輸出。上次使用對話的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

選用。開放式和使用者定義的標籤，可由用戶端設定來標記對話 (例如，篩選特定平台/產品的對話)。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
kmsKey

string

選用。用於加密 Conversation 資源的客戶代管加密金鑰 (CMEK)。加密作業會在 Titan 層進行，我們會將 KMS 金鑰傳遞給 Titan。

格式：projects/{projectId}/locations/{location}/keyRings/{key_ring_name}/cryptoKeys/{key_name}。

方法

create

 建立新對話，保留對話記錄。

delete

 刪除對話。

get

 使用對話 ID 和父項取得單一對話的詳細資料。

list

 列出指定家長的全部對話。