Office365

Office365 コネクタを使用すると、Office 365 インスタンスに接続し、サポートされているオペレーションを実行できます。

始める前に

Office365 コネクタを使用する前に、次の作業を行います。

• Google Cloud プロジェクトで次の操作を行います。
  • 次のサービスを有効にします。
    • secretmanager.googleapis.com（Secret Manager API）
    • connectors.googleapis.com（Connectors API）

    サービスを有効にする方法については、サービスを有効にするをご覧ください。

  以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

コネクタを構成する

コネクタを構成するには、データソース（バックエンド システム）への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

   [接続] ページに移動

2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
3. [ロケーション] セクションで、接続のロケーションを選択します。
   1. リージョン: プルダウン リストからロケーションを選択します

      コネクタをサポートしているリージョンは次のとおりです。

      サポートされているすべてのリージョンのリストについては、ロケーションをご覧ください。

   2. [Next] をクリックします。
4. [接続の詳細] セクションで、次の操作を行います。
   1. コネクタ: 使用可能なコネクタのプルダウン リストから [Office365] を選択します。
   2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
   3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 63 文字以内で指定してください。
   4. 必要に応じて、接続インスタンスの [説明] を入力します。
   5. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
   6. 必要に応じて、接続ノードの設定を構成します。
      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。

   注: 接続ノード値をカスタマイズできるのは、従量課金制のお客様のみです。
   7. Azure テナント: データへのアクセスに使用される Microsoft Online テナント。指定しない場合、デフォルトのテナントが使用されます。
   8. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
   9. [Next] をクリックします。
5. [認証] セクションで、認証の詳細を入力します。
   1. [認証タイプ] を選択し、関連する詳細を入力します。

      Office365 接続でサポートされる認証タイプは次のとおりです。

      • OAuth 2.0 認証コードの付与

   これらの認証タイプの構成方法については、認証を構成するをご覧ください。

   2. [次へ] をクリックします。
6. Review: 接続と認証の詳細を確認します。
7. [作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

• OAuth 2.0 認証コードの付与
  • アクセス トークン: auth-code-flow-based 接続でリクエストを認証するために使用されるアクセス トークン。
  • クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
  • クライアント シークレット: アクセス トークンのリクエストに使用されるクライアント シークレット。

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

注: コネクタタスクで、コネクタのエンティティ、オペレーション、アクションを表示できます。

• エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

  ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

• オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
  • リスト
  • 取得
  • 作成
  • 更新
  • 削除

  使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがどのエンティティ オペレーションもサポートしていない場合、サポートされていないオペレーションは Operations リストに表示されません。

• アクション: コネクタ インターフェースを介して統合で使用できる最初のクラス関数です。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

システムの上限

Office365 コネクタは、ノードごとに 1 秒あたり 1 件のトランザクションを処理することができ、この上限を超えるトランザクションすべてをスロットルします。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

• 従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
• サブスクリプション ベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンド システムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。

アクション

このセクションでは、コネクタでサポートされているアクションを一覧表示します。アクションの構成方法については、アクションの例をご覧ください。

注: すべてのアクションの結果は、統合を実行した後に Connectors タスクの connectorOutputPayload レスポンス パラメータで JSON レスポンスとして利用できます。

CancelEvent アクション

このアクションにより、予定をキャンセルできます。

CancelEvent アクションの入力パラメータ

パラメータ名	データ型	必須	説明
EventId	文字列	○	イベントの ID。
UserId	文字列	いいえ	ユーザの ID
UserPrincipalName	文字列	いいえ	ライセンスを割り当てる必要があるユーザー名。
コメント	文字列	いいえ	追加するコメント。

CancelEvent アクションの構成方法の例については、アクションの例をご覧ください。

MoveMail アクション

このアクションにより、メールを移動できます。

MoveMail アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MessageId	文字列	○	メール ID
DestinationId	文字列	○	メールの移行先フォルダの ID。

MoveMail アクションの構成方法の例については、アクションの例をご覧ください。

AssignLicense アクション

このアクションを行うと、ライセンスを割り当てることができます。

AssignLicense アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserId	文字列	いいえ	ライセンスを割り当てる必要があるユーザーの ID。
UserPrincipalName	文字列	いいえ	ライセンスを割り当てる必要があるユーザー名。
AddLicenseSkuId	文字列	いいえ	SKU の一意の識別子。
DisabledPlans	文字列	いいえ	無効化されたプランのカンマ区切りの一意識別子のコレクション。
RemoveLicenses	文字列	いいえ	削除するライセンスを識別するカンマ区切り ID のコレクション。

AssignLicense アクションの構成方法の例については、アクションの例をご覧ください。

ForwardEvent アクション

このアクションにより、予定を転送できます。

ForwardEvent アクションの入力パラメータ

パラメータ名	データ型	必須	説明
EventId	文字列	○	イベントの ID。
UserId	文字列	いいえ	ユーザの ID
UserPrincipalName	文字列	いいえ	ライセンスを割り当てる必要があるユーザー名。
コメント	文字列	いいえ	追加するコメント。
ToRecipients	文字列	○	セミコロンで区切った受信者メールのリスト。

ForwardEvent アクションの構成方法の例については、アクションの例をご覧ください。

UploadFile アクション

このアクションにより、ファイルをアップロードできます。

UploadFile アクションの入力パラメータ

パラメータ名	データ型	必須	説明
FileName	文字列	いいえ	コンテンツをアップロードするファイルの名前。
LocalFile	文字列	いいえ	アップロードするコンテンツを含むローカル ファイル。
ContentStream	文字列	いいえ	localpath または folderpath が指定されていない場合にアップロードされる入力ストリームとしてのコンテンツ。
ParentId	文字列	○	現在のアイテムが存在するフォルダの ID。
コンテンツ	文字列	いいえ	アップロードするファイルのコンテンツ。

UploadFile アクションの構成方法の例については、アクションの例をご覧ください。

DownloadFile アクション

このアクションにより、ファイルをダウンロードできます。

DownloadFile アクションの入力パラメータ

パラメータ名	データ型	必須	説明
FileId	文字列	○	ダウンロードするファイルの ID。
DownloadTo	文字列	いいえ	ファイルの保存場所。
エンコード	文字列	いいえ	FileData 入力エンコード タイプ。指定できる値は NONE、BASE64 で、デフォルト値は BASE64 です。
FileStream	文字列	いいえ	ファイルデータの書き込み先の出力ストリームのインスタンス。DownloadTo が指定されていない場合にのみ使用されます。

DownloadFile アクションの構成方法の例については、アクションの例をご覧ください。

CreateFolder アクション

このアクションにより、フォルダを作成できます。

CreateFolder アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ParentId	文字列	いいえ	現在のアイテムが存在するフォルダの ID。
FolderName	文字列	○	作成されるフォルダの名前。

CreateFolder アクションの構成方法の例については、アクションの例をご覧ください。

SendMail アクション

このアクションにより、メールを送信できます。

SendMail アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ToRecipients	文字列	いいえ	メールの送信先の受信者。
コンテンツ	文字列	いいえ	メールの内容
件名	文字列	いいえ	メールの件名。
Id	文字列	いいえ	送信するメッセージの ID（省略可）。ユーザーは既存のメール ID を使用するか、必要に応じて他のフィールドに入力して新しいメールを送信できます。
添付ファイル	文字列	いいえ	添付ファイル。添付ファイルを次の形式で指定します。 filename1,filecontent1;filename2,filecontent2. 各ファイルのコンテンツは、BASE64 データか、@ 文字の前にローカル ファイルのパスを指定します。
FileName	文字列	いいえ	受信者として、次の順序で受信者を指定します。
LocalFile	文字列	いいえ	添付ファイルのコンテンツを含むファイル。
ContentBytes	文字列	いいえ	BASE64 にエンコードされた添付ファイルの内容。
CCRecipients	文字列	いいえ	CC 内の受信者のセミコロン区切りの値。
SenderEmail	文字列	いいえ	代理のメールアドレスを送信する必要があります。別のユーザーのアカウントに代わってメールを送信する場合に設定します。
FromEmail	文字列	いいえ	メールの送信元のユーザーのメールアドレス。他のユーザーのアカウントからメールを送信する場合、これを設定します。
ContentType	文字列	いいえ	メール本文のコンテンツ タイプ。指定できる値は text、html です。 デフォルト値はテキストです。

SendMail アクションの構成方法の例については、アクションの例をご覧ください。

ForwardMail アクション

このアクションにより、メールを転送できます。

ForwardMail アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MessageId	文字列	○	メールの ID。
ToRecipients	文字列	○	セミコロンで区切った受信者メールのリスト。
コメント	文字列	いいえ	元のメッセージに加えたコンテンツ。

ForwardMail アクションの構成方法の例については、アクションの例をご覧ください。

DownloadEmail アクション

このアクションにより、メールをアップロードできます。

DownloadEmail アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MessageId	文字列	○	ダウンロードするメッセージの ID。
エンコード	文字列	いいえ	ファイルデータの入力エンコード タイプ。
DownloadTo	文字列	いいえ	ファイルの保存場所。
FileStream	文字列	いいえ	ファイルデータを書き込む出力ストリームのインスタンス。この値は、DownloadTo が指定されていない場合にのみ使用されます。

DownloadMail アクションの構成方法の例については、アクションの例をご覧ください。

DownloadAttachments アクション

このアクションにより、メールの添付ファイルをダウンロードできます。

DownloadAttachments アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MessageId	文字列	○	添付ファイルを取得するメールの ID。
エンコード	文字列	いいえ	FileData 入力エンコード タイプ。 指定できる値は NONE、BASE64 です。
DownloadTo	文字列	いいえ	アタッチメントの保存場所。指定しない場合は、添付ファイルのコンテンツ バイトが返されます。MessageId が指定されている場合、この値は必須です。
AttachmentId	文字列	いいえ	ダウンロードする添付ファイルの ID。指定されていない場合は、メールのすべての添付ファイルを返します。
UserId	文字列	いいえ	ユーザの IDこのアクションは、認証されたユーザーに管理者権限がある場合にのみ機能します。
FileStream	文字列	いいえ	ファイルデータの書き込み先の出力ストリームのインスタンス。DownloadTo が指定されていない場合のみ使用されます。

DownloadAttachments アクションの構成方法の例については、アクションの例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - イベントをキャンセルする

この例では、指定した ID のイベントをキャンセルします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [CancelEvent] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",
   "Comment": "Canceled due to rain"
   }

アクションが成功すると、CancelEvent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - ライセンスの割り当てと削除を行う

この例では、指定したユーザーのライセンスの割り当てと削除を行います。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [AssignLicense] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

アクションが成功すると、AssignLicense タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - 予定を転送する

この例では、予定を転送します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [ForwardEvent] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",
   "Comment": "forwarded due to rain",
   "ToRecipients": "[e-mail]"
   }

アクションが成功すると、ForwardEvent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - ファイルをアップロードする

この例では、ファイルをアップロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [UploadFile] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "FileName": "Document1234.docx",
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",
   "Content": "test"
   }

アクションが成功すると、UploadFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

例 - ファイルをダウンロードする

この例では、ファイルをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadFile] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

アクションが成功すると、DownloadFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

例 - フォルダを作成する

この例では、フォルダを作成します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [CreateFolder] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",
   "FolderName": "outbox1234"
   }

アクションが成功すると、CreateFolder タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例: メールを送信する

この例では、指定した受信者にメールを送信します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [SendMail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "ToRecipients": "[e-mail]",
   "Content": "Testing",
   "Subject": "Test subject",
   "FileName": "Google"
   }

アクションが成功すると、SendMail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - メールを転送する

この例では、メールを転送します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [ForwardMail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",
   "ToRecipients": "[e-mail]",
   "Comment": "forwarded message"
   }

アクションが成功すると、ForwardMail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - メールをダウンロードする

この例では、メールをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadEmail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

アクションが成功すると、DownloadEmail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success",
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

例 - 添付ファイルをダウンロードする

この例では、添付ファイルをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadAttachments] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",
   "DownloadTo": "My files/Office355/reports/"}
   }

アクションが成功すると、DownloadAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]

統合で Office365 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

• Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
• Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

次のステップ

• 接続を一時停止して再開する方法を確認する。
• コネクタの使用状況をモニタリングする方法を確認する。
• コネクタログを表示する方法を確認する。