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

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

Google 助理連結

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

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

以下列舉一些 Google 助理連結相當實用：

從操作說明網站將使用者導向語音導引指示。
從說明網頁引導使用者取得客戶服務。
將使用者連結至更新意圖，以便選擇加入日後的更新。

產生 Google 助理連結

您可以透過 Actions 主控台從專案產生 Google 助理連結。您可以透過所有部署管道 (Alpha 版、Beta 版和正式版) 取得 Google 助理連結。舉例來說，如果您的動作 Alpha 版已啟用 Google 助理連結，則 Alpha 版測試人員可使用該連結。

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

在動作主控台中，依序前往「部署」>「Google 助理連結」。
針對「Intent」(意圖)，選取要產生連結的意圖。
啟用「要啟用在 Intent_name 的連結嗎？」選項。
(選用) 在「Campaign parameters」(廣告活動參數) 部分中，輸入您想在連結中擷取的網址參數，並納入網址參數。
(選用) 輸入「連結標題」。請使用此標題來說明動作的用途。舉例來說，如果您的動作會將使用者帶往交易流程，以便購買演唱會門票，則連結標題可以是「購買演唱會門票」。

輸入資訊後，你可以查看及複製 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 意圖的 Google 助理連結網址，不包含額外參數：

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`	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 助理連結網址

Urchin 流量監視器 (UTM) 參數是指當使用者點擊 Google 助理連結時，Google 助理會傳送給動作的字串。您之後可以使用這些字串中包含的資訊進行分析。

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

utm_source
utm_medium
utm_campaign
utm_term
utm_content

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

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 帳戶連結，藉此獲得更貼近個人需求的體驗。

搭配帳戶連結使用時，複合式 Google 助理連結會使用你的授權網址，也就是你在「動作」控制台的專案中設定的網址。詳情請參閱帳戶連結說明文件。

必要條件

如要使用複合式搜尋結果連結，您需要：

Actions Project：
已啟用動作的 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>

Deployment

複合式 Google 連結僅適用於您擁有的網域，且已通過 Google 驗證。在本機開發時，您可以藉由存取「動作」專案、登入 Google 帳戶，並在指令碼標記中設定 dev=true 查詢參數，藉此略過這項規定。

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

透過複合式 Google 助理連結部署你的動作：

在 Actions 控制台中的「Deploy」>「Brand Verification」>「Connect Site」，註冊您的公開網域。

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

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

限制和最佳做法

以下限制和最佳做法適用於 Google 助理連結網址，可在目錄中或其他 Google 服務外發布及參照：

繼續支援所有 Google 助理連結。如果您發行的 Google 助理連結在之後中斷，您的動作專案可能會標示為健康狀態不良，並遭到下架。
發布連結後，即支援從不信任的來源觸發。針對任何已連結的動作，請務必先與使用者確認，再進行實際操作。例如，關閉智慧型住宅設備的動作應提示使用者「您是否確定要關閉 $applianceName？」

在此情況下，「實際操作」是指會影響使用者服務、資料、裝置、網路、電腦或 API 的任何動作。例如，傳送電子郵件、執行交易、修改智慧型住宅設備的狀態、建立訂閱項目或更新內容。