みなさん、power automate flow使っていますか？
power automate flowとはMicrosoftが提供しているiPaaSです。IFTTTに近い製品です。
添付メールが届いたら、添付ファイルをboxにアップロードするとか、boxにファイルがアップロードされたらteams/slackに通知するみたいなことができます。
参考：
https://qiita.com/glenn/items/f37cecb228618c1a718b
各種SaaSサービスとつなげるためのAPIコネクタが多数用意されています。
Power automate はboxのコネクタを用意しているのですが、すべてのAPIが用意されているわけではありません。
用意されているコネクタは実は結構貧弱。。。
https://docs.microsoft.com/en-us/connectors/box/
たとえば自動で誰かをフォルダにコラボレーターとして呼びたい、そんなフローを作ろうと思ってもデフォルトのコネクタではできません。
この場合、カスタムコネクタを作成して、好きなbox apiを追加することができます。
カスタムコネクタはpostman collectionやswaggerを使用してインポートすることもできますが、このガイドではマニュアルで追加する方法を記載します。
詳しくは知りたい人はこちらのガイドを参照してみてください。
https://docs.microsoft.com/ja-jp/connectors/custom-connectors/use-custom-connector-flow
カスタムコネクタを追加するには、flow.microsoft.com > Data > custom connectorから新規コネクタ
この画面ではコネクタの名前やコネクタの画像やbox apiのurlを設定します。
security設定は、box apiに接続するための認証情報をいれます。
flowにはすでに用意されているboxコネクタの認証情報を使って認証を行うことができます。
APIの設定を追加します。
①追加しようとしているAPIのわかりやすい名前
②Flow上に表示されるオペレーション名
③次にRequestを追加します
④ここにはAPIの呼び出しかたやリクエスト詳細をいれます。
box apiのドキュメンテーションからAPIのURL,リクエストのサンプルをコピペします
今回はコラボレーターの追加を例にフィールドをいれていきます。
あとは画面にしたがって次へ次へと進めていき、最後に保存します。
途中api testせよと言われますが、無視して次にすすめてokです。
保存したら新しいフローを作成して先ほど作ったコネクタを使うことができるようになります
セットアップ時に入れてjsonを自動解析して必要なフィールドを入力するよう求められます！
これで好きなAPIを追加して使うことができるようになります、すごい！
happy collaborating!