このページは Cloud Translation API によって翻訳されました。

Outlook の予定表とメールのアクションを追加する

次のページでは、Outlook メールと Outlook カレンダーのアクションを設定する方法について説明します。

Outlook メールアクションを追加する

Outlook メールアクションが有効になっている場合、エンドユーザーはアシスタントにメールの送信を依頼できます。

たとえば、ユーザーが「userA@example.com にメールを送信して。件名は「今日の会議」、内容は「議題は何ですか？」」と入力する可能性があります。必要に応じて追加の詳細情報を尋ね、メールの送信を確認します。

アシスタントは、アクションを通じて次の Outlook フィールドを読み取り、編集できます。

フィールド	説明
To	必須。受信者のメールリスト。
件名	必須。メールの件名
コンテンツ	必須。メールのコンテンツ（Markdown 形式）。
CC	メールの CC リスト。
BCC	メールの BCC リスト。

Outlook メール用の認証と権限を設定する

Outlook アクションを有効にする前に、管理者は Outlook の認証と権限を設定する必要があります。

次の手順は、Outlook メールと Outlook カレンダーの両方のアクションに適用されます。メールとカレンダーの両方のアクションを使用する場合は、スコープの有効化手順で両方のスコープを有効にします。

OAuth アプリを作成してスコープを追加する

https://portal.azure.com/ にログインし、[アプリの登録] ページに移動します。
[New registration] をクリックします。
1. アプリに名前を付けます。
2. リダイレクト URI の場合:
  - プラットフォームタイプで [ウェブ] を選択します。
  - 次のリダイレクト URI を追加します。 https://vertexaisearch.cloud.google.com/oauth-redirect
[証明書とシークレット] で、新しいクライアントシークレットを作成します。クライアントシークレットをメモします。これは作成直後にのみ表示されます。

必要なスコープを有効にするには:

Azure アプリの [API Permissions] 設定ページに移動します。
[権限を追加] をクリックします。
[Microsoft Graph] を選択します。
[委任された権限] を選択します。
次のスコープを追加します。
1. offline_access
2. User.Read
3. Calendars.ReadWrite（カレンダーアクションが必要な場合）
4. Mail.Send（メールアクションが必要な場合）

Azure の組織設定の種類によっては、このスコープを有効にする最後の手順を省略できます。

Outlook メールアクションを構成する

始める前に、 Google Cloud 管理者が Outlook メール用の認証と権限を設定するの手順を完了し、次の情報を提供していることを確認してください。

クライアント ID
クライアントシークレット
テナント ID（API ではインスタンス ID と呼ばれます）

API を使用して Outlook メールアクションを構成する

API を使用してアプリにアクションを追加する手順は次のとおりです。

次の手順に沿って、Outlook のメールとカレンダーの両方のアクションを構成できます。Outlook カレンダーのアクションをすでに設定している場合は、これらの手順を再度行う必要はありません。

Outlook データを Gemini Enterprise に接続していない場合は、Outlook コネクタを作成します。Outlook コネクタがすでに存在する場合は、次の手順に進みます。

SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

次のように置き換えます。

PROJECT_NUMBER: Google Cloud プロジェクトの番号。
COLLECTION_ID: コレクションの ID。
COLLECTION_DISPLAY_NAME: コレクションの表示名。
CLIENT_ID: 管理者が OAuth アプリを作成してスコープを追加するセクションで作成したクライアント ID。
CLIENT_SECRET: 管理者が作成したクライアントシークレット（OAuth アプリを作成してスコープを追加するセクションを参照）。

Outlook コネクタにアクション構成を含めます。

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

次のように置き換えます。

PROJECT_NUMBER: Google Cloud プロジェクトの番号。
COLLECTION_ID: コレクションの ID。
CLIENT_ID: 管理者が OAuth アプリを作成してスコープを追加するセクションで作成したクライアント ID。
CLIENT_SECRET: 管理者が作成したクライアントシークレット（OAuth アプリを作成してスコープを追加するセクションを参照）。

アシスタントで Outlook アクションを有効にします。メールアクションのみが必要な場合は、カレンダーのエントリを省略します。

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

次のように置き換えます。

PROJECT_ID: アプリと Outlook コネクタが配置されているプロジェクトの ID。
LOCATION: アプリとコネクタのマルチリージョン（global、us、eu）。
APP_ID: アクションを関連付けるアプリの ID。
COLLECTION_ID: 前の手順で作成した Outlook コネクタの ID。

アクションを追加すると、アシスタントはアプリでエンドユーザーの代わりにアクションを実行できるようになります。ユーザーがアシスタントに Outlook アクションの実行を初めて依頼したときに、Outlook アカウントへのアクセスを承認するよう求められます。アシスタントを使用するには、Gemini Enterprise Enterprise Plus ライセンスが必要です。

Outlook カレンダーアクションを追加する

Outlook カレンダーアクションが有効になっている場合、エンドユーザーはアシスタントにカレンダーの予定の作成を依頼できます。

たとえば、「11 月 4 日金曜日の午前 11 時に userA@example.com との会議をスケジュールして」と入力します。必要に応じて、アシスタントが追加の詳細情報を尋ね、イベントの作成を確認するようユーザーに求めます。

アシスタントは、アクションを通じて次の Outlook カレンダーフィールドを読み取り、編集できます。

フィールド	説明
参加者	必須。参加者のメールアドレスのリスト。リクエストしたユーザーは自動的にリストに追加されます。
タイトル	会議のタイトル。
開始時刻	会議の開始時刻。
所要時間	会議の長さ。デフォルトは 30 分です。
タイムゾーン	会議のタイムゾーン。指定しない場合、ユーザーのタイムゾーンが使用されます。
説明	会議の説明。

Outlook カレンダーの認証と権限を設定する

Outlook アクションを有効にする前に、管理者は Outlook の認証と権限を設定する必要があります。

OAuth アプリを作成してスコープを追加する

https://portal.azure.com/ にログインし、[アプリの登録] ページに移動します。
[New registration] をクリックします。
1. アプリに名前を付けます。
2. リダイレクト URI の場合:
  - プラットフォームタイプで [ウェブ] を選択します。
  - 次のリダイレクト URI を追加します。 https://vertexaisearch.cloud.google.com/oauth-redirect
[証明書とシークレット] で、新しいクライアントシークレットを作成します。クライアントシークレットをメモします。これは作成直後にのみ表示されます。

必要なスコープを有効にするには:

Azure アプリの [API Permissions] 設定ページに移動します。
[権限を追加] をクリックします。
[Microsoft Graph] を選択します。
[委任された権限] を選択します。
次のスコープを追加します。
1. offline_access
2. User.Read
3. Calendars.ReadWrite（カレンダーアクションが必要な場合）
4. Mail.Send（メールアクションが必要な場合）

Azure の組織設定の種類によっては、このスコープを有効にする最後の手順を省略できます。

Outlook カレンダーアクションを構成する

始める前に、Microsoft Outlook 管理者が Outlook カレンダーの認証と権限を設定するの手順を完了し、次の情報を提供していることを確認してください。

クライアント ID
クライアントシークレット
テナント ID（API ではインスタンス ID と呼ばれます）

API を使用して Outlook カレンダーアクションを構成する

次の手順に沿って、Outlook のメールとカレンダーの両方のアクションを構成できます。Outlook のメールアクションをすでに構成している場合は、これらの手順を再度行う必要はありません。

API を使用してアプリにアクションを追加する手順は次のとおりです。

SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

次のように置き換えます。

PROJECT_NUMBER: Google Cloud プロジェクトの番号。
COLLECTION_ID: コレクションの ID。
COLLECTION_DISPLAY_NAME: コレクションの表示名。
CLIENT_ID: 管理者が OAuth アプリを作成してスコープを追加するセクションで作成したクライアント ID。
CLIENT_SECRET: 管理者が作成したクライアントシークレット（OAuth アプリを作成してスコープを追加するセクションを参照）。

Outlook コネクタにアクション構成を含めます。

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

次のように置き換えます。

PROJECT_NUMBER: Google Cloud プロジェクトの番号。
COLLECTION_ID: コレクションの ID。
CLIENT_ID: 管理者が OAuth アプリを作成してスコープを追加するセクションで作成したクライアント ID。
CLIENT_SECRET: 管理者が作成したクライアントシークレット（OAuth アプリを作成してスコープを追加するセクションを参照）。

アシスタントで Outlook アクションを有効にします。

新しいデータコネクタは、UI でアシスタントに関連付けることができます。Outlook アクションを有効にするには、次の API コマンドが必要です。

SERVER=https://discoveryengine.googleapis.com
PROJECT_NUMBER={YOUR PROJECT_NUMBER}
ENGINE_ID="{YOUR ENGINE ID}"
CONNECTOR_ID="{THE CONNECTOR'S COLLECTION ID YOU GENERATED IN PREVIOUS STEP}"

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

次のように置き換えます。

PROJECT_ID: アプリと Outlook コネクタが配置されているプロジェクトの ID。
APP_ID: アクションを関連付けるアプリの ID。
COLLECTION_ID: 前の手順で作成した Outlook コネクタの ID。

Outlook の予定表とメールのアクションを追加する

Outlook メール アクションを追加する

Outlook メール用の認証と権限を設定する

OAuth アプリを作成してスコープを追加する

Outlook メール アクションを構成する

API を使用して Outlook メール アクションを構成する

Outlook カレンダー アクションを追加する

Outlook カレンダーの認証と権限を設定する

OAuth アプリを作成してスコープを追加する

Outlook カレンダー アクションを構成する

API を使用して Outlook カレンダー アクションを構成する

Outlook メールアクションを追加する

Outlook メールアクションを構成する

API を使用して Outlook メールアクションを構成する

Outlook カレンダーアクションを追加する

Outlook カレンダーアクションを構成する

API を使用して Outlook カレンダーアクションを構成する