發布動作

邀請使用者測試您的動作，藉此盡早取得意見回饋並修正所有技術或使用者體驗問題，再正式發布。

動作控制台支援發布環境，因此您只要先讓少數使用者測試新的動作或現有動作版本，再將其公開發布。

版本的生命週期

下圖顯示動作的生命週期可能採取的路徑：

圖 1. 動作發布版本的生命週期。

Action Console 支援兩種正式發布前測試環境：

• Alpha 版：應使用這個版本快速測試早期動作。

  • 可讓您將動作發布給少數使用者，不必經過完整的 Google 審查。
  • 使用者會看到該警告，說明動作尚未經過 Google 審查，確保符合政策規定。
  • 適用於內部測試。

• Beta 版：您可以透過這個管道，針對已通過 Google 完整審查的部分使用者發布動作。

  • 建議您使用這個版本，讓機構外的使用者使用舊版動作。
  • 告知使用者該動作為預覽版本。
  • 測試版已通過 Google 審查，因此您可以隨時選擇公開發布，不需經過 Google 的其他審查。

注意： 其中一個動作只能發布「正式版」Alpha 版或 Beta 版。

版本環境比較

下表摘要說明各種部署管道之間的差異。

	模擬器	Alpha 值	Beta 版	正式版
目標觀眾	僅限開發人員	您的團隊、朋友和家人中的早期測試人員	團隊外的測試人員	所有 Google 助理使用者
需要 Google 審查	不可以	否	是	是
有權存取的使用者	僅限開發人員	開發人員定義的使用者名單。使用者必須選擇啟用。	開發人員定義的使用者名單。使用者必須選擇啟用。	對所有 Google 助理使用者公開發布
使用者人數上限	1	20	200	不適用
適用的國家/地區	模擬器和所有 Google 助理裝置	所有 Google 助理裝置	所有 Google 助理裝置	所有 Google 助理裝置
Actions Builder	是否支援	是否支援	是否支援	是
Actions SDK	是否支援	是否支援	是否支援	是
Dialogflow	是否支援	是否支援	是否支援	是
智慧型住宅	支援 (必須連結帳戶)	不支援	不支援	是
範本	是否支援	不支援	不支援	是
明確叫用	是否支援	是否支援	是否支援	是
隱含叫用	是否支援	是否支援	是否支援	是
帳戶連結	是否支援	是否支援	是否支援	是

注意： 如果您使用的是 Dialogflow 版本管理，則可將不同的版本部署至不同的發布環境。詳情請參閱「提交專案」。

管理 Alpha 版或 Beta 版測試

如要設定測試 Alpha 版或 Beta 版，請按照下列步驟操作：

1. 按一下「管理 Alpha 版測試人員」或「管理 Beta 版測試人員」。

2. 輸入測試人員的電子郵件地址，並以半形逗號分隔。您最多可以指定 20 位測試人員進行 Alpha 版測試，以及指定最多 200 位測試人員進行 Beta 版測試。

   注意： 測試人員必須擁有 Google 帳戶 (@gmail.com) 或 Google Workspace。您無法透過 Google 群組電子郵件別名指定多位使用者。

   

3. 複製選擇接受連結，與測試人員分享。

4. 按一下「儲存」。

您應該傳送邀請電子郵件給測試人員，其中包含行動 Alpha 或 Beta 版動作的連結 (選擇接受連結)。詳情請參閱「取得意見回饋」。

選擇接受連結

選擇接受連結代表「動作目錄」頁面，絕不會有任何變更。這個連結會將測試人員指向您的目錄頁面，並查看適用環境的選擇加入資訊卡。如果 Alpha 版和 Beta 版測試中也有相同的測試人員，則符合測試雙方的搶先體驗資格，可先看到 Alpha 版的接受測試卡片。

實作 Alpha 或 Beta 版執行要求

Google 助理的 HTTP 要求中不會包含發布版本資訊。如要處理執行要求中的發布版本，請提供不同的執行要求網址，例如一個 Beta 版測試網址，以及動作動作的另一個網址。

收集意見回饋

將動作發布到 Alpha 或 Beta 版後，建議您透過選擇接受連結 (即 Google 助理目錄清單) 邀請測試人員參加測試。

請務必告知測試人員他們必須：

• 在行動裝置上下載 Google 助理應用程式，以便進行 Alpha 版或 Beta 版測試。
• 使用指定為 Alpha 版或 Beta 版測試人員的帳戶登入 Google 助理應用程式。

部署動作後，所有新測試人員必須至少等待 3 小時，才能使用選擇接受連結存取動作。

當使用者按一下這個連結時，系統會將他們導向至對應的動作目錄頁面。第一次操作時，他們應按一下動作目錄頁面底部的「I'm in」按鈕，選擇成為測試人員。

測試人員在手機上啟用這項功能後，你的動作就會立即顯示在所有裝置上。測試人員會在 Google 助理應用程式的「我的應用程式」部分中查看您的動作，並標示為下列其中一種模式：Alpha 版、Beta 版或無測試。「No testing」選項會向使用者提供動作的正式版 (如果有)。如果沒有正式版，使用者就不會看到任何內容。

注意： 如果使用者使用的是 Alpha 版或 Beta 版，則使用者無法在 Google 助理應用程式中為動作評分。相反地，請讓測試人員能夠透過電子郵件、網站、訊息論壇或其他不當機制提供意見回饋。

最佳做法

• 確保使用者可以加入測試。測試人員必須擁有 Google 帳戶 (@gmail.com) 或 G Suite 帳戶才能加入測試。
• 選擇合適的測試類型。Alpha 版測試群組應較小且測試「建議行動」(例如貴公司或團隊內部) 的穩定穩定實驗版本。Beta 版測試則適合在即將發布的版本上測試穩定版的穩定版本。
• 提供測試人員的意見回饋管道。Alpha 版和 Beta 版頻道僅供自己的測試人員使用。請務必告知他們透過電子郵件、網站、訊息論壇或其他適當的機制提供意見回饋。
• 對同一動作執行並行測試。您可以同時執行 Alpha 版和 Beta 版測試。

已知問題

• 網頁版的 Google 助理目錄不支援選擇採用 Alpha 版或 Beta 版。 確認測試人員使用行動裝置 (Android 或 iOS) 中的連結。
• 你的變更可能需要數小時才會生效。請保留適當的一段時間，再向使用者提供選擇接受連結。

建立新的 Alpha 或 Beta 版

如要將動作部署至 Alpha 版或 Beta 版頻道，請按照下列步驟操作：

1. 在 Actions 主控台，按一下「Deploy」>「Release」。

2. 按一下「啟動新版本」。

   

3. 選取「Alpha 版」或「Beta 版」，然後按一下「提交」。

4. 如果看到提示訊息，表示您已完成動作審查規定檢查清單中的必要步驟。

5. 如果適用於你的專案，請選取發布版本的語言。

6. 按一下「提交」。

提交 Alpha 版或 Beta 版後，該版本會顯示在「管理版本」部分中。

注意： 部署完成後，您的版本會處於「部署」狀態長達 3 小時，再提供給使用者。部署作業完成後，系統會從該發布環境中移除其他使用中的版本。

注意： 如果您是專案開發人員，系統預設會在裝置上啟用測試版。如要取得 Alpha 版和 Beta 版，請在動作主控台模擬工具中停用「裝置端測試」選項。

將現有版本從 Alpha 版或 Beta 版升級至正式版

正式版可對所有 Google 助理使用者推出，或只對特定區域或特定比例推出。階段推出功能可協助您測試 Action 專案的穩定性。建議您僅對一小群使用者發布應用程式，然後逐步完成升級，直到 100% 的使用者為止。如此一來，您就可以先解決錯誤，再將應用程式推出給所有使用者。

注意： 無論您想以完整或階段推出的方式發布，都必須先通過審查程序，才能部署至正式版。只有一則審查項目。但如果修改動作，則必須重新送交審查。您必須將新版本的動作提交到 Beta 版或正式版，才能開始審查。

階段推出

階段推出可讓開發人員向所有使用者推出正式版，並逐步向所有使用者推出版本，藉此管理正式版。您可以在階段中逐步擴大區域或使用者百分比。

注意： 您無法選取所選區域中的使用者百分比。升級持續發布版本時，您無法在測試類型 (位置或使用者百分比) 之間切換。如要變更測試類型，您必須先取消版本並建立新的版本。階段推出版本只能有一個版本。

如要在階段推出的階段部署動作，請按照下列步驟操作：

1. 在「管理版本」下方，選取要升級為正式版的版本。
2. 按一下「管理部署作業」。
3. 選取「部署至實際工作環境」。
4. 選取 [階段推出]。
5. 按一下「選取推出類型」。

6. 選取「指定的位置」或「使用者百分比」。如要進一步瞭解這個選項，請參閱「依指定地區推出」或「按使用者百分比推出」。

   

7. 按一下「提交」。

如要為階段推出，請參閱「推出多個版本」。

全面推出

選取這個選項後，您的行動專案就會向所有指定國家/地區的使用者發布。

如要將動作部署為全面推出，請按照下列步驟操作：

1. 在「管理版本」下方，選取要升級為正式版的版本。

2. 按一下「管理部署作業」。

   

3. 選取「部署至實際工作環境」。

4. 選取 [全面推出]。

5. 按一下「提交」。

建立不含 Alpha 或 Beta 版測試的正式版

正式版可對所有 Google 助理使用者推出，或只對特定區域或特定比例推出。階段推出功能可協助您測試 Action 專案的穩定性。建議您僅對一小群使用者發布應用程式，然後逐步完成升級，直到 100% 的使用者為止。如此一來，您就可以先解決錯誤，再將應用程式推出給所有使用者。

注意： 無論您想以完整或階段推出的方式發布，都必須先通過審查程序，才能部署至正式版。只有一則審查項目。不過，如果你修改動作並發布至正式版應用程式，則必須重新送交審查。您必須提交新版本的 Beta 版或正式版，才能展開審查。

階段推出

階段推出可讓開發人員向所有使用者推出正式版，並逐步向所有使用者推出版本，藉此管理正式版。您可以在階段中逐步擴大區域或使用者百分比。

注意： 您無法選取所選區域中的使用者百分比。升級持續發布版本時，您無法在測試類型 (位置或使用者百分比) 之間切換。如要變更測試類型，您必須先取消版本並建立新的版本。階段推出版本只能有一個版本。

如要在階段推出的階段部署動作，請按照下列步驟操作：

1. 在 Actions 主控台，按一下「Deploy」>「Release」。

2. 按一下「啟動新版本」。

   

3. 選取「正式版」。

4. 如果看到提示訊息，表示您已完成動作審查規定檢查清單中的必要步驟。

5. 如果適用於你的專案，請選取發布版本的語言。

6. 選取 [階段推出]。

7. 按一下「選取推出類型」。

8. 選取「指定的位置」或「使用者百分比」。如要進一步瞭解這個選項，請參閱「依指定地區推出」或「按使用者百分比推出」。

   

9. 按一下「提交」。

由特定位置推出

選取這個選項後，這個動作專案就會發布至所選國家或地區。

如要按地區劃分動作，請按照下列步驟操作：

1. 按一下「選取國家或地區」，然後勾選發布版本的區域。

2. 按一下「提交」。

   注意： 僅允許您在指定地區中選取的區域。

推出 (依使用者族群區分)

這個選項會將您的動作放開給隨機選取的使用者。

如要向特定比例的使用者推出動作，請按照下列步驟操作：

1. 按一下「使用者百分比」。

2. 選取你要對動作採取動作的百分比。

   

3. 按一下「提交」。

   注意： 如要恢復這類版本，請將百分比設為 0%。

全面推出

選取這個選項後，您的行動專案就會向所有指定國家/地區的使用者發布。

如要將動作部署為全面推出，請按照下列步驟操作：

1. 在 Actions 主控台，按一下「Deploy」>「Release」。

2. 按一下「啟動新版本」。

   

3. 選取「正式版」。

4. 如果看到提示訊息，表示您已完成動作審查規定檢查清單中的必要步驟。

5. 如果適用於你的專案，請選取發布版本的語言。

6. 選取 [全面推出]。

7. 按一下「提交」。

正式版提交後，就會顯示在「管理版本」部分中。

注意： 部署完成後，您的版本會處於「部署」狀態最多 3 小時，再提供給使用者。部署作業完成後，系統會自動取消部署該版本環境中的其他有效版本。

編輯或取消部署版本

將動作提交至發布版本後，你仍然可以進行變更。方便您測試目前的版本、從版本審查版本、查看版本詳細資料、管理部署作業、取消部署及升級推出階段。也可以在這裡查看過往版本的詳細資料。

查看及編輯版本

如要查看版本詳細資料或變更動作版本，請按照下列步驟操作：

1. 在「管理版本」下方，選取「版本名稱」下方的版本。
2. 選擇「編輯推出作業」、「管理部署作業」或「顯示更多」。

推出版本的推出階段

如要為動作推出推出階段，請按照下列步驟操作：

1. 在「管理版本」下方，選取要升級的版本。
2. 按一下「編輯推出作業」按鈕。
3. 變更推出作業。例如，您可以將使用者數量從 5% 提升到 20%。
4. 按一下「提交」。

取消部署至實際工作環境

• 如需將階段推出離線，請按一下「管理版本」下方的「編輯推出作業」。您可以清除所有地區設定，或是選取 0% 做為發布目標 (具體取決於推出地點的分佈比例或使用者數量百分比)。
• 如要取消部署完全推出的動作 (100% 的使用者)，請按一下「管理版本」下方的「管理部署作業」按鈕，然後選取「從部署項目取消部署」。