Google系サービスのOAuth2.0認証を作成する方法

Google Cloud Storage（GCS）や Google Drive でファイル名を取得したいという問い合わせをよくもらいます。

単一ファイルの場合は、カスタム変数を転送対象のファイルプレフィックスとカラム定義に埋め込むことでファイル名を転送することが可能です。
しかし、ファイルプレフィックスに設定したフォルダの配下に存在しているファイルをすべて転送対象にした場合、ファイル名を転送することができません。

ファイル名を転送したい場合は、転送元HTTP・HTTPSを使い Google Workspace API を実行してメタデータを取得する方法をお試しください。
OAuth2.0認証で接続情報を作成する必要があるので、その方法をご説明します。

手順は、Google公式ドキュメントを参考にしています。
（参考）OAuth 同意画面を設定し、スコープを選択する

Step1. Google側の設定方法

ブランディング（アプリ）を作成する

• 承認済みドメインには「trocco.io」を追加する

API を有効化する

• 「APIとサービス」→「有効なAPIとサービス」→「ライブラリ」から利用したいサービスのAPIを有効にする
  • Google Cloud Storage（GCS）の場合は、Google Cloud Storage JSON API
  • Google Driveの場合は、Google Drive API  

認証情報を作成する

• 「APIとサービス」→「認証情報」→「認証情報を作成する」→「OAuthクライアントID」からOAuthクライアントIDを作成する
   
  • アプリケーションの種類は「ウェブアプリケーション」
  • 名前は任意
  • 承認済みのJavaScript生成元は空欄
  • 承認済みのリダイレクトURIにTROCCOのリダイレクトURL（https://trocco.io/connections/http/callback）を設定 
    
• 発行されたクライアントIDとクライアントシークレットを控えておく 
  

Step2. TROCCO側の設定

HTTP・HTTPSの接続情報を作成する

• グラントタイプ：認可コード
• クライアントID：Google側で取得したクライアントID
• クライアントシークレット：Google側で取得したクライアントシークレット
• 認可URL：https://accounts.google.com/o/oauth2/v2/auth
• アクセストークン：https://oauth2.googleapis.com/token
• スコープ：
  • Google Driveからファイル名などのメタデータ取得：https://www.googleapis.com/auth/drive.metadata.readonly
  • Google Cloud Storageからファイル名などのメタデータ取得：https://www.googleapis.com/auth/devstorage.read_only
    
• 「詳細を設定する」内
  • カスタムパラメータ：
    • access_type：offline
    • prompt：consent
      

認証する

• 「認証」をクリックして、許可するスコープを選択して認証する 
  
• 成功したら保存する
  

Step3. ファイル名取得の転送設定

Google Cloud Storage（GCS）のファイル名の取得方法

1. OAuth2.0：利用するを選択して上記で作成した接続情報を使用する
2. URL：https://storage.googleapis.com/storage/v1/b/tバケット名/o
3. HTTPメソッド：GET 

4. 入力ファイル形式：JSONPath

   JSONPath：$.items[*]
   

Google Driveのファイル名の取得方法

GCSと同様にHTTP・HTTPSコネクタを利用して取得が可能です。

1. OAuth2.0：利用するを選択して上記で作成した接続情報を使用する
2. URL：https://www.googleapis.com/drive/v3/files 
3. HTTPメソッド：GET

4. 入力ファイル形式：JSONPath

   JSONPath：$.files[*]

Google系のサービスとの接続については、弊社ブログでも紹介しています。併せてご確認ください。
（参考）Google Calendarの予定データ連携の実践事例 | カスタムコネクタ作成事例