建構應用程式動作

應用程式動作可讓使用者透過詢問 Google 助理或使用 Google 助理建議的 Android 捷徑，在您的 Android 應用程式中啟動功能。這些 是利用應用程式動作擴充 Android 應用程式的主要步驟：

1. 辨別要觸發的應用程式內功能及其比對功能 內建意圖 (BII)。
2. 提供 BII 的執行要求詳細資料。
3. 將應用程式動作的快速指令推送至 Google 助理。
4. 使用測試裝置預覽應用程式動作。
5. 建立應用程式的測試版。
6. 要求審查和部署應用程式動作。

你也可以視需要定義動態捷徑，以便提供給 Google 助理 建議使用者查看這些字詞如要使用範例應用程式建立應用程式動作，請按照下列步驟操作： 請按照「應用程式動作程式碼研究室」的指示操作。

注意： 由於法規相關限制，參加 闔家適用 (DFF) 計畫不得含有應用程式動作。如果您將已加入 DFF 計畫的應用程式送交應用程式動作審查，將不會通過核准。

需求條件

在開發應用程式動作前，請確保您和自家應用程式符合 符合以下條件：

• 您的 Google 帳戶必須具有 Google Play 管理中心。
• 應用程式必須發布至 Google Play 商店，因為應用程式動作僅適用於在該商店發布的應用程式。另外，請確認您的應用程式 不適用於工作資料夾，因為系統不支援應用程式動作 。
• 您必須使用實體或虛擬裝置，才能測試應用程式動作。
• 您需要最新版的 Android Studio。
• 必須使用同一個 Google 帳戶登入 Android Studio、測試裝置上的 Google 應用程式和 Google Play 管理中心。
• 您必須在測試裝置上設定 Google 助理，然後執行 觸控和按住主畫面按鈕。

比對內建意圖與應用程式功能

在 Android 應用程式中找出使用者可能想要的功能 跳到語音要求，查看 內建意圖參考資料，找出適當的 BII 符合用途的工作模式BII 會根據使用者想執行的工作建立模型 所以，請找出符合主要功能和使用者需求的 BII 處理應用程式中的流程

其實幾乎所有 Android 應用程式都能使用常見的 BII，例如 你可以透過 actions.intent.GET_THING 在應用程式內搜尋 Google 助理 BII 或讓使用者透過語音啟動特定應用程式功能 實作 actions.intent.OPEN_APP_FEATURE BII。

重要事項： 根據應用程式動作部署規定，這類應用程式會 都必須以搜尋功能實作 actions.intent.GET_THING BII，讓使用者可以使用 常用語音指令，例如：「Ok Google，搜尋慢跑鞋， 範例應用程式。」

也有可用於「產業」或特定類別用途的 BII。舉例來說，健身應用程式可以使用 actions.intent.START_EXERCISE BII。

注意： 如果您的應用程式功能沒有 BII，您可以使用 自訂意圖，可讓您利用應用程式動作擴充應用程式。

為確保使用者獲得良好的體驗，並避免可能延遲核准作業，請進行以下動作： 確認實作的每個 BII 都與應用程式內功能相關。

應用程式動作的運作原理，是依照 Google 助理應用程式啟動 Android 意圖，將使用者直接導向應用程式中的特定內容。您可以指定 targetClass 和 targetPackage 欄位來定義意圖，以明確啟動活動。如果您的應用程式已導入 Android 深層連結 則可選擇將意圖設為針對以下項目使用深層連結： 執行要求詳情請參閱深入測試活動 連結。

提供內建意圖的執行要求詳細資料

建構應用程式動作時，大部分的作業是在 您 Android 應用程式的 shortcuts.xml 資源檔案 指定您選取的 BII 及對應的執行要求。BII 建立 使用者查詢工作，而執行要求意圖可為 Google 助理提供 說明如何執行工作

在 shortcuts.xml 檔案中，BII 表示為 <capability> 元素，而每項執行要求則以 <intent> 元素表示：

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

注意： 您的 Android 需要 Jetpack 程式庫 androidx.core:core:1.6.0 (或更新版本) ，避免在 Cloud 控制台中定義應用程式動作功能時發生編譯錯誤 shortcuts.xml。詳情請參閱「開始使用 Android Jetpack」。

多數的 BII 都會依據 schema.org 實體，從使用者查詢中擷取意圖參數。然後應用程式就會使用這些 BII 參數，將使用者導向所選功能。舉例來說， 之前 程式碼會將 exercise.name BII 參數對應至 exercise_name Android intent 參數。

如果您要透過深層連結執行動作，請使用 urlTemplate 欄位 來定義 Google 助理產生的深層連結網址：

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

提示：應用程式針對單一意圖提供多個意圖時 BII，Google 助理會嘗試按照 capability 元素。

如需在 shortcuts.xml 檔案中新增應用程式動作的重要詳細資料， 請參閱建立 shortcuts.xml。該網頁也 說明如何指定應用程式預期的參數值。

實作 GET_THING 內建意圖

如果應用程式具有搜尋功能，則必須實作 actions.intent.GET_THING該函式的 BII。Google 助理就會轉寄 使用者查詢時，透過應用程式的搜尋功能查詢應用程式內的搜尋結果 例如「Ok Google，在範例應用程式中搜尋範例觀光景點」。

在 shortcuts.xml 檔案中，為以下項目實作 <capability>： actions.intent.GET_THING BII 實作任何其他 BII。只要提供至少一項執行要求，將使用者查詢傳送至應用程式的搜尋功能，就可以針對 GET_THING 使用多個執行要求。

以下範例說明如何將 actions.intent.GET_THING BII shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

在搜尋「Activity」中，從外部 intent，並傳遞至應用程式的搜尋功能。在上述程式碼中，搜尋查詢會以 query 金鑰傳遞，並對應至 "thing.name" BII 參數。然後使用查詢執行搜尋，並在使用者介面中顯示結果。

選用：將應用程式動作的快速指令推送至 Google 助理

在您定義動作的功能後，使用者就可以在 例如說出「Ok Google，使用範例應用程式點一份披薩」。 Google 助理可以向相關使用者建議 Android 快速指令，方便你執行各項操作 時間，讓他們發現並重播你的動作。Google 助理 動態和靜態捷徑都能建議使用。

如要將動態捷徑推送至 Google 助理，請使用 Google 捷徑整合功能 資源庫。這個 Jetpack 程式庫可讓 Google 助理採用捷徑和 並在適當時機向使用者建議他們。

詳情請參閱「推送動態捷徑至 Google 助理」。

預覽應用程式動作

在開發與測試期間，請使用 Android Studio 專用的 Google 助理外掛程式，用於測試 應用程式動作適用於您的應用程式。這個外掛程式會建立應用程式動作預覽畫面 。這個測試工具可以測試 透過提供輸入內容的 BII，在實體測試裝置或模擬器上執行執行要求 您預期會從使用者收到的參數

注意： 您也可以為應用程式動作新增其他測試人員 整合。詳情請參閱「新增其他測試人員」。

預覽應用程式動作時，您可以在 裝置。這項功能僅適用於應用程式動作 BII 參考資料中列出的查詢內容。使用語音 觸發條件只會用於示範，不適用於一般測試。

注意： 應用程式動作測試工具僅支援 en-US 語言代碼，但如需其他語言代碼的查詢範例，請參閱 對應的內建意圖參考資料。

使用 Google Play 的開發人員工具，在草稿模式中測試應用程式 將應用程式送審。 進一步瞭解如何使用 Google Play 管理中心部署草稿 請參閱準備並推出 版本。

建立測試版本

如果您已準備好邀請其他測試人員測試應用程式動作， 為您的應用程式建立內部或封閉測試版本。 根據預設，內部和 封閉式測試版測試人員可以存取已可使用的應用程式動作 審查並獲得核准。

如要授予所有應用程式動作 (包括未經核准的動作) 的測試權限， 請指示測試人員加入 應用程式動作開發計畫 Google 網路論壇。這個群組的成員可存取封閉和內部測試版本中的所有應用程式動作，而不必使用應用程式動作測試工具建立預覽。加入群組後，最多可能需要 3 小時才能完成 才能使用存取權

注意： 使用者無法執行公開測試群組中的應用程式動作 才會通過審查並獲得核准詳情請參閱 。

要求審查和部署應用程式動作

已發布應用程式或公開測試的使用者無法執行應用程式動作 直到通過審查並獲得核准為止。應用程式動作審查不會 會影響您在 Google Play 的 Android 應用程式審查及部署狀態。即使 您提交的應用程式已通過核准並發布至 Play 商店 「shortcuts.xml」可能正在接受 Google 審查。應用程式動作不適用於 使用者，直到評論也獲得核准為止

您部署應用程式時，應用程式動作依然會持續有效。不過 Google 會審查重新部署的版本。如果新版本 無法正常運作或包含違反政策的內容，Google 有權 停用應用程式的應用程式動作。

如果想提交應用程式動作進行審查，請進行下列事項：

1. 接受 Google Play 管理中心的《應用程式動作服務條款》(依序點選「進階設定」>「應用程式動作」)：

   

2. 按照平常的發布方式，將應用程式 (含 shortcuts.xml) 上傳至 Google Play 管理中心。

3. 將應用程式上傳至 Play 管理中心之後，Google 會透過您在 Play 管理中心帳戶登錄的電子郵件地址與您聯絡，並提供更多與應用程式動作審查狀態相關的資訊。您也可以聯絡 Google 助理開發人員支援團隊 與我們聯絡。聯絡人 表單，並提供應用程式套件 ID，然後在 您需要哪方面的協助？

，瞭解如何調查及移除這項存取權。

注意： 如果您的應用程式設有登入憑證限制，請提供 。如要提供測試憑證，請在 Play 管理中心選取您的應用程式，接著依序前往「政策」>「應用程式內容」，然後按照「應用程式存取權」下列出的說明操作。

選用：測試活動深層連結

如要使用深層連結透過應用程式動作啟動 Activity，Activity 必須使用深層連結網址進行設定，並在 Android 應用程式資訊清單中設定對應的意圖篩選器。

注意： 深層連結可以使用應用程式連結網址， 意圖網址或自訂配置，例如 myapp://do.thing/param=value。

如要測試使用者能不能存取及觸發活動，請使用 使用深層連結的應用程式動作，請執行以下 adb 指令：

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

例如：

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

如果活動並未正確以 adb 指令啟動，請檢查以下項目：

• 在應用程式資訊清單檔案中，活動有 android:exported=true，因此 啟動 Google 助理意圖
• 如果您使用應用程式連結網址，請按照「處理 Android 應用程式連結」說明的步驟操作。

應用程式動作政策

應用程式動作必須遵守特定政策，確保能 觸發符合預期的體驗請先詳閱這些政策 提交應用程式以提供最佳使用者體驗，同時避免 Google Play 商店評論延遲或遭拒。

• 將使用者導向至使用者預期的內容

  應用程式動作內建的意圖 (BII) 和/或參數，必須只將使用者導向相關且使用者想要的動作。內容涵蓋應用程式內容 或 Slice 或小工具中顯示的資訊， 打造個人專屬體驗

  例如，實作 START_EXERCISE BII 可協助使用者 開始特定類型的運動，例如跑步或游泳。只有 這項政策的例外狀況，是指您的 OPEN_APP_FEATURE BII 將使用者引導至 應用程式主畫面。

• 實作相關的應用程式動作 BII

  實作的 BII 必須與應用程式內容直接相關， 功能。

  舉例來說，如果您的應用程式屬於「通訊端 Play 商店」類別， 請勿實作 START_EXERCISE BII， 。

• 導入相關的自訂意圖

  為自訂意圖定義的查詢與應用程式的內容和功能有關。可能違反這項政策的例子 政策建立意圖 custom.action.intent.GET_RECIPE，並使用 相關聯的查詢模式「顯示墨西哥捲餅食譜」某個應用程式 交通運輸 Play 商店類別。

---