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

新增 Google 日曆和 Gmail 動作

下頁說明如何為 Google 日曆和 Gmail 設定助理動作。

Google 日曆動作

開啟 Google 日曆動作後，使用者可以要求 Google 助理為他們建立 Google 日曆活動。

舉例來說，使用者可以輸入「明天下午 3 點與 user1@example.com 安排會議」。如有必要，Google 助理會要求提供其他詳細資料，然後請使用者確認是否要建立活動。

Google 助理可透過動作讀取及編輯下列 Google 日曆欄位：

欄位	說明
與會者	這是必要旗標，與會者的電子郵件地址清單。系統會自動將要求者加入清單。
標題	會議標題。
開始時間	會議開始時間。
時間長度	會議時間長度。預設值為 30 分鐘。
時區	會議時區。如未提供，系統會使用使用者的時區。
說明	會議說明。

設定 Google 日曆的驗證和權限

啟用 Google Calendar 動作前，管理員必須啟用 Google Calendar API，並按照下列步驟設定授權。 Google Cloud

啟用 Google Calendar API

在 Google Cloud 控制台中啟用下列 API：

Google Calendar API：啟用 API。
Google People API：啟用 API。

建立 OAuth 應用程式並新增範圍

如果您沒有 OAuth 應用程式，請按照下列步驟操作。如果您已有 OAuth 應用程式，請跳至「建立 OAuth 用戶端憑證」。

前往 Google Auth Platform / 總覽。
按一下「開始使用」。
輸入 OAuth 應用程式的名稱。
輸入使用者支援電子郵件地址。
選取「內部」。
輸入開發人員聯絡資訊。
點選「建立」。

建立 OAuth 用戶端憑證

以下程序說明如何為動作建立新的 OAuth 用戶端 ID。 Google Cloud 這個 OAuth 用戶端 ID 和密鑰也可用於其他 Google Cloud動作。如果您有現有的 Google Cloud 動作 OAuth 用戶端 ID Google Cloud，可以將該用戶端 ID 和密碼用於 Google 日曆動作，不必建立新的用戶端 ID。

前往 Google Auth Platform / Clients。
按一下「建立用戶端」。
「應用程式類型」請選取「網頁應用程式」。
在「Name」(名稱) 中，輸入用戶端 ID 的名稱。
在「已授權的重新導向 URI」部分，按一下「新增 URI」，然後輸入下列 URI： https://vertexaisearch.cloud.google.com/oauth-redirect
按一下「建立」，然後複製下列資訊：
- 用戶端 ID
- 用戶端密鑰

新增 Google 日曆動作

請按照下列步驟，使用控制台或 API 建立 Google 日曆動作：

事前準備

新增 Google 日曆動作前，請務必符合必要條件，包括現有應用程式和驗證詳細資料。

Google Cloud 管理員必須先完成「設定 Google 日曆的驗證和權限」一節中的步驟，並提供用戶端 ID 和用戶端密鑰，您才能新增動作。
您必須擁有已連結至 Google 日曆資料儲存庫的現有 Gemini Enterprise 應用程式。如要建立新應用程式，請參閱「建立應用程式」。
如果您最近在 Google Cloud 專案中啟用 Discovery Engine API 並建立應用程式，請等待至少 15 分鐘，讓應用程式完成設定，再設定 Google 日曆動作。

設定 Google 日曆動作

控制台

如要使用控制台將動作新增至應用程式，請按照下列步驟操作：

在 Gemini Enterprise 中，前往「Gemini Enterprise」頁面。
選擇 Gemini Enterprise 應用程式。
在導覽選單中，按一下「動作」。
新增動作：
- 如果這是您的第一個動作，請按一下「新增動作」。
- 如果您先前已建立動作，請按一下「建立」。
如果是 Google 日曆，請按一下「連結」。
輸入動作連接器的名稱。
輸入動作連接器的授權資訊：
1. 在「New client ID」(新用戶端 ID) 和「New client secret」(新用戶端密鑰) 欄位，輸入管理員在「Create OAuth client credentials」(建立 OAuth 用戶端憑證) 專區建立的用戶端 ID 和用戶端密鑰。
2. 按一下「驗證授權」，然後授予 Gemini Enterprise 應用程式存取 Google 日曆的權限。
選取要啟用的動作。
點選「完成設定」。您的動作會顯示在「動作」頁面上。

REST

如要使用 API 在應用程式中新增動作，請按照下列步驟操作。

為 Google 日曆動作建立動作連結器。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"google_calendar",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'

PROJECT_ID：您要建立 Google 日曆動作連結器的專案 ID。
：Google 日曆動作連接器的多區域：global、us 或 eu。LOCATION
CONNECTOR_ID：要建立的連結器 ID。這個 ID 只能包含小寫英文字母、數字、底線和連字號。
CONNECTOR_DISPLAY_NAME：要建立的連結器顯示名稱。
CLIENT_ID：管理員在「建立 OAuth 用戶端憑證」中建立的用戶端 ID。
CLIENT_SECRET：管理員在「建立 OAuth 用戶端憑證」中建立的用戶端密鑰。

將您建立的 Google 日曆動作連結器，連結至現有的應用程式。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "create_calendar_event",
          "tool_display_name": "Create Calendar Event"
        }
      ]
    }
  }
}'

PROJECT_ID：應用程式和 Google 日曆動作連結器所在的專案 ID。
LOCATION：應用程式的多區域和動作連結器：global、us 或 eu。
APP_ID：要附加動作的應用程式 ID。
CONNECTOR_ID：在上一個步驟中建立的 Google 日曆動作連接器 ID。

新增動作後，Google 助理就能在應用程式中代表使用者執行這些動作。使用者首次要求 Google 助理執行 Google 日曆動作時，系統會要求他們授權存取 Google 日曆帳戶。

Gmail 動作

啟用 Gmail 動作後，使用者可以要求 Google 助理代為傳送電子郵件。

舉例來說，使用者可以輸入「傳送電子郵件給 user1@example.com，主旨為『Hi there』，內容為『how are you doing?』」。如有需要，助理會要求提供其他詳細資料，然後請使用者確認是否要傳送電子郵件。

Google 助理可透過動作讀取及編輯下列 Gmail 欄位：

欄位	說明
收件者	這是必要旗標，收件者電子郵件地址清單。
主旨	這是必要旗標，電子郵件主旨
內容	這是必要旗標，電子郵件內容 (Markdown 格式)。
CC	電子郵件的副本清單。
密件副本	電子郵件的密件副本清單。

設定 Gmail 的驗證和權限

開啟 Gmail 動作前， Google Cloud 管理員必須先啟用 Gmail API 並設定授權。

啟用 Gmail API

在 Google Cloud 控制台中啟用下列 API：

Gmail API：啟用 API。
Google People API：啟用 API。

建立 OAuth 應用程式並新增範圍

如果您沒有 OAuth 應用程式，請按照下列步驟操作。如果您已有 OAuth 應用程式，請跳至「建立 OAuth 用戶端憑證」。

前往 Google Auth Platform / 總覽。
按一下「開始使用」。
輸入 OAuth 應用程式的名稱。
輸入使用者支援電子郵件地址。
選取「內部」。
輸入開發人員聯絡資訊。
點選「建立」。

建立 OAuth 用戶端憑證

前往 Google Auth Platform / Clients。
按一下「建立用戶端」。
「應用程式類型」請選取「網頁應用程式」。
在「Name」(名稱) 中，輸入用戶端 ID 的名稱。
在「已授權的重新導向 URI」部分，按一下「新增 URI」，然後輸入下列 URI： https://vertexaisearch.cloud.google.com/oauth-redirect
按一下「建立」，然後複製下列資訊：
- 用戶端 ID
- 用戶端密鑰

新增 Gmail 動作

如要使用控制台或 API 建立 Gmail 動作，請按照下列步驟操作：

事前準備

新增 Gmail 動作前，請務必符合必要條件，包括現有應用程式和驗證詳細資料。

Google Cloud 管理員必須先完成「設定 Gmail 的驗證和權限」一節中的步驟，並提供用戶端 ID 和用戶端密鑰，您才能新增動作。
您必須擁有已連結至 Gmail 資料儲存庫的 Gemini Enterprise 應用程式。如要建立新應用程式，請參閱「建立應用程式」。
如果您最近在 Google Cloud 專案中啟用 Discovery Engine API 並建立應用程式，請等待至少 15 分鐘，讓應用程式完成設定，再設定 Gmail 動作。

設定 Gmail 動作

控制台

如要使用控制台將動作新增至應用程式，請按照下列步驟操作：

在 Gemini Enterprise 中，前往「Gemini Enterprise」頁面。
選擇 Gemini Enterprise 應用程式。
在導覽選單中，按一下「動作」。
新增動作：
- 如果這是您的第一個動作，請按一下「新增動作」。
- 如果您先前已建立動作，請按一下「建立」。
如果是 Gmail，請按一下「連結」。
輸入動作連接器的名稱。
輸入動作連接器的授權資訊：
1. 在「New client ID」(新用戶端 ID) 和「New client secret」(新用戶端密鑰) 欄位，輸入管理員在「Create OAuth client credentials」(建立 OAuth 用戶端憑證) 專區建立的用戶端 ID 和用戶端密鑰。
2. 按一下「驗證授權」，然後授予 Gemini Enterprise 應用程式存取 Gmail 的權限。
選取要啟用的動作。
點選「完成設定」。您的動作會顯示在「動作」頁面上。

REST

如要使用 API 在應用程式中新增動作，請按照下列步驟操作。

為 Gmail 動作建立動作連接器。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"gmail",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'

PROJECT_ID：您要在其中建立 Gmail 動作連結器的專案 ID。
LOCATION：Gmail 動作連接器的多區域：global、us 或 eu。
CONNECTOR_ID：要建立的連結器 ID。這個 ID 只能包含小寫英文字母、數字、底線和連字號。
CONNECTOR_DISPLAY_NAME：要建立的連結器顯示名稱。
CLIENT_ID：管理員在「建立 OAuth 用戶端憑證」中建立的用戶端 ID。
CLIENT_SECRET：管理員在「建立 OAuth 用戶端憑證」中建立的用戶端密鑰。

將您建立的 Gmail 動作連結器連結至現有應用程式。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "send_email",
          "tool_display_name": "Send Email"
        }
      ]
    }
  }
}'

PROJECT_ID：應用程式和 Gmail 動作連結器所在的專案 ID。
LOCATION：應用程式和連接器的多重區域：global、us 或 eu。
APP_ID：要附加動作的應用程式 ID。
CONNECTOR_ID：在上一步建立的 Gmail 動作連結器 ID。

新增動作後，助理就能在應用程式中代表使用者執行這些動作。使用者首次要求助理執行 Gmail 動作時，系統會要求他們授權存取 Gmail 帳戶。

將 Google 日曆和 Gmail 動作連結至應用程式

下列 API 要求示範如何將 Google 日曆和 Gmail 動作連結至現有應用程式。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'

PROJECT_ID：應用程式和 Google 日曆與 Gmail 動作連接器所在的專案 ID。
LOCATION：應用程式和連接器的多重區域： global、us 或 eu。
APP_ID：要附加動作的應用程式 ID。
CALENDAR_CONNECTOR_ID：在上一個步驟中建立的 Google 日曆動作連接器 ID。
GMAIL_CONNECTOR_ID：在上一步建立的 Gmail 動作連結器 ID。

新增動作後，助理就能在應用程式中代表使用者執行這些動作。使用者首次要求助理執行 Google 日曆或 Gmail 動作時，系統會要求他們授權存取帳戶。

新增 Google 日曆和 Gmail 動作 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Google 日曆動作

設定 Google 日曆的驗證和權限

啟用 Google Calendar API

建立 OAuth 應用程式並新增範圍

建立 OAuth 用戶端憑證

新增 Google 日曆動作

事前準備

設定 Google 日曆動作

控制台

REST

Gmail 動作

設定 Gmail 的驗證和權限

啟用 Gmail API

建立 OAuth 應用程式並新增範圍

建立 OAuth 用戶端憑證

新增 Gmail 動作

事前準備

設定 Gmail 動作

控制台

REST

將 Google 日曆和 Gmail 動作連結至應用程式

新增 Google 日曆和 Gmail 動作