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

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

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

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

要求

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

  • 擁有可存取 Google Play 管理中心的 Google 帳戶。
  • 僅有已發布至 Google Play 商店的應用程式才能使用應用程式動作。另外,也請確定應用程式不適合在工作資料夾內使用,因為 Google Play 管理版不支援應用程式動作。
  • 擁有實體 Android 裝置,以便測試應用程式動作。推薦使用的 OS 版本為 Android 8 (API 級別 26) 以上,不過動作最多可以支援到 Android 5 (API 級別 21) 的裝置。
  • 安裝最新版本的 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。舉例來說,比起財經管理應用程式,訂餐應用程式更可能會用到 actions.intent.ORDER_MENU_ITEM 內建意圖。如果應用程式實作不符主題或和應用程式功能無關的 BII,便可能讓使用者感到困擾,並可能因此無法通過應用程式動作審核。

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

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

actions.xml 檔案中,<action> 元素便代表內建意圖,而每項執行要求則以 <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>

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

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

預覽應用程式動作

您可以使用應用程式的草稿版本進行測試。更多資訊請參閱「準備作業與發布版本」。強烈建議您先用草稿模式測試應用程式,然後再提交審核。

在開發和測試期間,您需要使用應用程式動作測試工具確認應用程式可以正常使用該應用程式動作。應用程式動作測試工具是一種 Android Studio 外掛程式,可以在 (您的 Google 帳戶的) Google 助理內建立應用程式動作預覽。使用這組測試工具,即可在測試裝置上提供您預期使用者會提出的輸入參數所產生的 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 管理中心登錄的電子郵件地址聯絡您,並說明和應用程式動作審核相關的資訊。