對話動作已於 2023 年 6 月 13 日淘汰。詳情請參閱「對話動作已淘汰」。

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

Google 助理連結

你可以產生直接連結至動作特定意圖的網址。使用者在網頁或行動瀏覽器中點選 Google 助理連結 (原稱為「動作連結」) 後，系統會將使用者導向使用者透過其裝置上的 Google 助理直接與您的動作互動。

Google 助理連結與目錄網頁連結不同，後者會將使用者帶往 Google 助理目錄中的動作頁面。

Google 助理連結在以下情況中相當實用：

將使用者導向操作說明網站上的語音導覽操作說明。
從說明頁面將使用者導向客戶服務體驗。
將使用者導向更新意圖，以便他們選擇未來更新

產生 Google 助理連結

你可以在動作主控台中透過專案產生 Google 助理連結。所有部署管道 (Alpha 版、Beta 版、和正式版群組)。舉例來說，如果您的 Google 助理連結已啟用 Alpha 版

如要產生動作的網址，請按照下列步驟操作：

在動作控制台中，依序前往「部署」>「部署」Google 助理連結。
在「Intent」Intent部分，選取要產生連結的意圖。
啟用「Would you like to enable links for intent_name?」選項。
(選用) 在「廣告活動參數」部分，輸入您想要的任何資訊額外擷取連結做為網址參數。
(選用) 輸入連結標題。使用標題說明該動作的用途。適用對象舉例來說，如果動作將使用者下推交易流程進行購買演唱會門票，連結標題可以是「購買演唱會門票」。

輸入資訊後，您可以查看及複製系統產生的網址產生的 Google 助理連結程式碼片段隨時隨地使用 Google 助理連結如果目標是想將使用者導向這項特定動作，

測試 Google 助理連結

您可以測試任何意圖 (主要、自訂或不含) 的 Google 助理連結參數)。

如要在裝置上測試 Google 助理連結，請按照下列步驟操作：

在 Actions 主控台產生 Google 助理連結。
透過電子郵件、即時通訊訊息或其他方式，透過網址將 Google 助理連結傳送給自己格式。
在支援 Google 助理的裝置上，使用相同的帳戶登入 Google 助理您使用的「動作」專案
在同一裝置上，按一下你傳送給自己的 Google 助理連結。

確認 Google 助理連結的運作方式符合預期後，就必須重新部署您的動作，讓使用者可以使用該連結。

Google 助理連結參數

Google 助理連結可選擇在網址中加入意圖和參數。使用 廣告活動參數部分，新增廣告活動參數。

如果 Google 助理連結不含任何額外參數，Google 助理會連結至動作的 MAIN 意圖 (actions.intent.MAIN)，包含以下內容行為：

如未在 Google 助理連結中明確啟用 MAIN 意圖，請按照下列步驟操作： Google 助理會比對主要意圖，但不含任何參數，類似「與 app_name 交談」的行為。
如果已明確啟用 MAIN 意圖，Google 助理就會傳遞參數加入動作

以下是使用 MAIN 意圖，但不含其他參數：

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

Google 助理連結網址規格

Google 助理連結網址的一般語法如下：

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

下表說明您可以設定的網址參數：

網址參數	說明
`$action_id`	動作的數字 ID。
`$intent`	內建或使用者意圖的全名。
`$param`	動作套件中指定的意圖參數全名。
`$value`	為 `$param` 宣告的類型網址編碼值，動作套件。
`$utm_param`	一或多個 Urchin 流量監視器 (UTM) 參數類型的清單。有效的值包括： `utm_source`、`utm_medium`、 `utm_campaign`、`utm_term`和 `utm_content`。
`$utm_value`	Urchin 流量監視器 (UTM) 參數的字串值。

內建意圖的 Google 助理連結網址

如果 Google 助理連結包含內建意圖 (意圖開頭為 actions.intent.)，Google 助理會嘗試擷取任何內建意圖參數並傳遞至動作任何符合以下條件的參數內建意圖參數已移除，因此 Google 助理無法理解。

如果是對話動作，Google 助理會將這些參數傳送至執行要求做為 AppRequest 訊息的一部分。

以下範例說明如何指定 Google 助理連結網址，包括具有單一意圖參數的內建意圖：

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

具有使用者意圖的 Google 助理連結網址

就使用者意圖而言，Google 助理只會擷取您動作在意圖中定義的任何參數，並捨棄其他任何參數。

以下範例說明如何指定 Google 助理連結網址，使用者意圖

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

針對上述網址範例，Google 助理會在 AppRequest 中新增 JSON 物件，做為如下：

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

含有 Urchin 流量監視器 (UTM) 參數的 Google 助理連結網址

UTM 參數是 Google 助理傳送給使用者點選 Google 助理連結時的動作。您可以使用這些字串稍後用於數據分析

Google 助理傳送給動作的 Urchin 流量監視器 (UTM) 參數包括：

utm_source
utm_medium
utm_campaign
utm_term
utm_content

以下範例說明如何指定 Google 助理連結網址，包含 Urchin 流量監視器 (UTM) 參數：

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

針對上方網址範例，Google 助理會在 AppRequest 訊息：

argument {
  name: 'utm_source',
  raw_text: 'Google',
  text_value: 'Google',
}
argument {
  name: 'utm_medium',
  raw_text: 'email',
  text_value: 'email',
}
argument {
  name: 'utm_campaign',
  raw_text: 'holiday sale',
  text_value: 'holiday sale',
}

豐富的 Google 助理連結

運用豐富的 Google 助理連結，你可以透過運用 help.js 解決網站問題使用者可以試用您的動作，並將 Google 帳戶與您的服務連結，並且使用帳戶連結功能。

使用者造訪你的網站時，會看到「使用 Google 助理試用」訊息按鈕，用於觸發複合式助理連結流程。

為動作啟用帳戶連結後，使用者就能在任何支援 Google 助理的裝置上存取你的動作。此外，使用者可以將自己的服務與 Google 帳戶連結，以便享有更貼近個人需求的服務。

搭配帳戶連結時，複合式 Google 助理連結會使用您在 Actions 主控台專案中設定的授權網址。詳情請參閱帳戶連結說明文件。

必要條件

如要使用複合式助理連結，必須符合下列條件：

動作專案。
已為你的動作啟用 Google 助理連結。
(選用) 已為動作啟用帳戶連結功能。

本機開發

如要在網站中加入複合式 Google 助理連結，請完成下列步驟：

在頁面中加入下列 JavaScript 程式庫，並將 <PROJECT_ID> 替換成您的動作專案 ID：

<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>

將下列 HTML 標記加到網頁的某個位置，這項操作會載入內嵌的「透過 Google 助理試用」按鈕：
```
<google-assistant-link-group>
  
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>
```
注意： 如果未登入 Google 助理，系統會觸發第一個 Google 助理連結。 Google 助理，或是將使用者重新導向至您的 Google 助理目錄頁面採取行動。

主動觸發

如果您希望在使用者首次造訪您的網頁時，自動啟動互動式 Google 助理連結流程，請使用 <google-assistant-proactive-link> 標記。套用這個代碼後，如果使用者第一次造訪時沒有選取內嵌按鈕，連結就會啟用。

將 id 加入 Google 助理連結群組標記：

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

在網頁上放置 <google-assistant-proactive-action-link> 標記，並將其 groupId 屬性設為 id：

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

<google-assistant-proactive-link
groupId="my-group">
</google-assistant-proactive-link>

部署作業

複合式 Google 助理連結僅適用於您所擁有且通過 Google 驗證的網域。在本機開發時，如果您能夠存取 Actions 專案、登入 Google 帳戶，並在指令碼標記中設定 dev=true 查詢參數，系統就會略過這項規定。

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

如何使用複合式 Google 助理連結部署動作：

在 Actions 主控台的「部署」>「部署」下方註冊您的公開網域品牌驗證 >連結網站。

從指令碼中移除 dev=true 查詢參數：

<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

限制和最佳做法

請遵守下列限制和最佳做法，確保 Google 助理連結網址可在目錄之外，或其他 Google 服務：

繼續支援所有 Google 助理連結。如果您將某個應用程式稍後中斷的 Google 助理連結，系統可能會將 Actions 專案標記為並且被下架
發布連結即表示你支援透過不受信任的來源觸發動作。對於任何已連結的動作，您必須明確與使用者確認，才能採取任何因應措施會用於模擬例如關閉智慧型住宅的動作設備應該會提示使用者說「確定要關閉$applianceName嗎？」

在此情況下，實際操作是指任何會影響使用者服務、資料、裝置、網路、電腦或 API舉例來說，傳送執行交易, 變更智慧型住宅的狀態設備、建立訂閱或更新內容。