建構應用程式動作 (已淘汰)

應用程式動作可讓應用程式使用者藉由查詢 Google 助理觸發 Android 應用程式內的現有功能。以下是利用應用程式動作擴充 Android 應用程式的五大步驟：

  1. 辨別要觸發的應用程式功能。
  2. 找到和應用程式功能相符的內建意圖 (BII)。
  3. 提供 BII 的執行要求詳細資料。
  4. 使用測試裝置預覽應用程式動作。
  5. 要求審查和部署應用程式動作。

如果想嘗試利用範例應用程式建立應用程式動作，請參閱「使用應用程式動作將 Android 應用程式擴充至 Google 助理」程式碼研究室。

要求

在開發應用程式動作之前，請先注意符合以下要求：

  • 擁有可存取 Google Play 管理中心的 Google 帳戶。
  • 僅有已發布至 Google Play 商店的應用程式才能使用應用程式動作。另外，也請確定應用程式不適合在工作資料夾內使用，因為 Google Play 管理版不支援應用程式動作。
  • 擁有實體 Android 裝置，以便測試應用程式動作。雖然動作可在搭載 Android 5 (API 級別 21) 以上版本的裝置運作，我們仍建議使用 Android 8 (API 級別 26) 以上的 OS 版本。
  • 安裝最新版本的 Android Studio。
  • 使用相同的 Google 帳戶登入 Android Studio、測試裝置上的 Google 應用程式，以及 Google Play 管理中心。
  • 長按測試裝置的「主畫面」按鈕，藉此設定並測試 Google 助理是否可以正常運作。

辨別應用程式功能

首先，從 Android 應用程式中選擇適合透過應用程式動作存取的活動。活動必須以 Android 深層連結網址設定，且 Android 應用程式資訊清單內須有對應的意圖篩選器。應用程式動作會使用 Google 助理產生的深層連結網址，直接引導使用者前往應用程式的特定內容。

如果想測試使用者能不能存取活動，以及能不能透過應用程式動作觸發活動，請執行以下 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 應用程式連結」說明的步驟操作。

找出符合應用程式功能的內建意圖

請參閱內建意圖參考資料，找到適合您用途的 BII。BII 會針對使用者透過查詢在應用程式內執行的作業建立模型，因此，請找出符合應用程式重要功能和使用者流程的 BII。

舉例來說，比起財經管理應用程式，訂餐應用程式更可能會用到 actions.intent.ORDER_MENU_ITEM BII。如果應用程式實作不符主題或和應用程式功能無關的 BII，便可能讓使用者感到困擾，也可能因此而無法通過應用程式動作審核。

提供 BII 的執行要求詳細資料

建構應用程式動作時，大部分的作業內容就是為應用程式建立 actions.xml 檔案，並在其中指定您挑選的 BII 及對應的執行要求。BII 為使用者查詢的作業建立模型後，執行要求便會向 Google 助理提供如何執行該作業的資訊。

在 actions.xml 檔案中，<action> 元素便代表 BII，而每項執行要求則以 <fulfillment> 元素代表：

<actions>
    <action intentName="actions.intent.ORDER_MENU_ITEM">
        <fulfillment urlTemplate="exampleapp://browse{?food}">
            <parameter-mapping intentParameter="menuItem.name" urlParameter="food" />
        </fulfillment>
    </action>

    <action intentName="actions.intent.GET_THING">
        <fulfillment urlTemplate="exampleapp://search{?query}">
            <parameter-mapping intentParameter="thing.name" urlParameter="query"/>
        </fulfillment>
    </action>
</actions>

多數的 BII 都會依據 schema.org 實體，從使用者查詢中擷取意圖參數。然後，應用程式便會用這些意圖參數引導使用者前往想用的功能。舉例來說，上述程式碼會將 "thing.name" 意圖參數對應到深層連結網址範本中的 "query" 網址參數。

如需有關建立 actions.xml 檔案的重要詳細資料，請參考「建立 actions.xml」。結構定義頁面也會說明如何指定應用程式預期的參數值 (稱作清查)，以及如何更新 AndroidManifest.xml 檔案來參照 actions.xml 資源。

預覽應用程式動作

請先用草稿模式測試應用程式，然後再提交審核。詳情請參閱「準備及推出版本」。

在開發和測試期間，您需要使用應用程式動作測試工具確認應用程式可以正常使用該應用程式動作。應用程式動作測試工具是一種 Android Studio 外掛程式，可以在 (您 Google 帳戶的) Google 助理內建立應用程式動作預覽。使用這組測試工具，即可為 BII 提供您預期使用者會提出的輸入參數，進而在測試裝置上測試執行要求。

當您預覽應用程式動作時，也可以在該裝置上用語音觸發查詢內容。這項功能僅適用於應用程式動作 BII 參考資料中列出的查詢內容。請將語音觸發功能用於純展示用途，而非做為定期測試之用。

要求進行應用程式動作審查及部署

應用程式動作必須通過審查和核准，使用者才能使用這些動作。應用程式動作審查不會影響 Android 應用程式在 Google Play 內的評論及部署狀態。但請注意，即使您提交的應用程式已通過核准，actions.xml 仍可能還在接受 Google 審查。

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

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

  1. 符合應用程式動作部署規範。這些規範有助於針對 Google 助理最佳化您的應用程式，確保使用者在使用應用程式動作時享有流暢的體驗。

  2. 接受 Google Play 管理中心的《Actions on Google 服務條款》(依序點選「定價與發行」>「同意聲明」)：

    Google Play 管理中心的《Actions on Google 服務條款》。

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

  4. 將應用程式上傳至 Play 管理中心之後，我們會透過您在 Play 管理中心登錄的電子郵件地址與您聯絡，並提供更多與應用程式動作審查狀態相關的資訊。