自社の Google Cloud で使う ― 設定手順
ドライブ連携 for kintone
ドライブ連携は、はじめから使える KIZUNA Works の接続と、お客様ご自身の Google Cloud のどちらでも動きます。本番運用では自社の Google Cloud をおすすめします。このページはその準備手順です。作業は 15 分ほど、費用はかかりません。
なぜ自社の Google Cloud をすすめるのか
どちらを選んでも機能は同じで、ファイルの流れも変わりません(利用者のブラウザから Google ドライブへ直送)。違うのは「誰の Google 利用枠を使うか」です。
利用枠が自社専用になる
Google の利用枠(クォータ)は Cloud プロジェクト単位で決まります。KIZUNA Works の接続は当社のプロジェクトを全ご利用者で共有するため、毎日大量に転送する運用では枠を分け合うことになります。
第三者の都合で止まらない
当社の接続を使う場合、当社の OAuth クライアントに何かあれば影響を受けます。自社のプロジェクトなら、止まる・止めるの判断も自社で握れます。
利用状況を自社で確認できる
API の利用状況を自社の Cloud コンソールで確認できます。情報システム部門の管理下に置きたい場合に向いています。
用意するもの
- Google アカウント(Google Workspace を推奨。個人の Google アカウントでも可)
- kintone のアプリ管理権限(設定画面を開くため)
- 費用は不要です。Google Drive API と Google Picker API は、請求先アカウントを紐づけなくても使えます
所要時間の目安:15 分。作業は最初の 1 回だけで、そのあとは通常の利用に切り替わります。
設定手順
下記を開き、プロジェクトを 1 つ作ります。名前は何でも構いません(例:kintone-drive-connect)。
https://console.cloud.google.com/projectcreate Google Workspace をお使いの場合は、組織に所属したプロジェクトとして作ってください。次の手順 3 で「内部」を選べるようになり、手続きが一段簡単になります。
画面右上のプロジェクト名が、いま作ったプロジェクトになっているか必ず確認してから、次の 2 つを「有効にする」で有効化します。
Google Drive API
https://console.cloud.google.com/apis/library/drive.googleapis.com
Google Picker API
https://console.cloud.google.com/apis/library/picker.googleapis.com Picker API を忘れないでください。保存先フォルダを選ぶ画面がこれを使います。有効になっていないと、設定画面の[フォルダを選択]を押しても何も開きません。
「Google Auth Platform」を開き、案内にしたがってアプリの情報を登録します。
https://console.cloud.google.com/auth/overview - アプリ名:接続するときの画面に出ます(例:
kintone ドライブ連携) - ユーザーサポートメール/デベロッパーの連絡先:自社のアドレス
Google Workspace をお使いの場合 → ユーザーの種類は「内部」
自社の組織のアカウントだけが接続できる設定です。審査は要りません。接続するのはアプリ管理者ご自身の 1 アカウントだけなので、これで足ります。
個人の Google アカウントの場合 → 「外部」+「本番環境に公開」
「外部」しか選べません。登録後、公開ステータスを「本番環境」に切り替えてください。テストのままにすると、接続が 7 日で切れます(Google の仕様で、テスト中のトークンは 7 日で失効します)。
本プラグインが求めるアクセス権は drive.file だけで、これは Google が非機密に分類しているものです。本番環境に切り替えるだけで、Google の審査を受ける必要はありません。
データアクセス(スコープ)には https://www.googleapis.com/auth/drive.file を追加してください。これ 1 つだけで、ほかは追加しません。このスコープは「アプリが作ったファイル」と「利用者が選んだフォルダ」に限定されたもので、Google が非機密に分類しているため審査の対象になりません。同意画面に出る内容と実際に要求する内容を揃えておくと、接続時に「確認されていないアプリ」の警告が出るのを防げます。
「クライアント」→「クライアントを作成」と進みます。
https://console.cloud.google.com/auth/clients - アプリケーションの種類:ウェブ アプリケーション
- 名前:任意(例:
kintone-drive-connect) - 承認済みの JavaScript 生成元:登録不要
- 承認済みのリダイレクト URI:次の 1 本だけを登録します
https://kizuna-works.jp/drive-connect/callback.html これは Google からの認可コードを受け取るための当社の静的なページです。サーバー処理はなく、受け取った値をブラウザ内で設定画面へ渡すだけで、保存も転送もしません。Google はリダイレクト URI を完全一致でしか認めず、ワイルドカードも使えないため、お客様の kintone サブドメインを個別に登録する方式が成り立たないので、この 1 枚に集約しています。
作成後に表示されるクライアント IDとクライアント シークレットを控えてください(シークレットはこの画面を閉じると再表示できないことがあります)。
「認証情報」→「認証情報を作成」→「API キー」で作ります。
https://console.cloud.google.com/apis/credentials 作成したキーを開き、次のとおり設定してください。
- API の制限:「Google Picker API」だけを選ぶ(必ず設定してください)
- アプリケーションの制限:「なし」のままにする
docs.google.com)で読み込まれるため、kintone のドメインでは照合が通らないためです。制限を「Picker API のみ」にしてあれば、仮にキーが読み取られてもできるのはフォルダ選択の画面を出すことだけで、ドライブのデータには一切触れられません(アクセスには別途 OAuth の認可が必要です)。
kintone のアプリ設定 → プラグイン →「ドライブ連携 for kintone」の歯車 →「① Google 接続」を開きます。
- 接続方式で 「自社の Google Cloud を使う【推奨】」 を選ぶ
- クライアント ID・クライアント シークレット・API キー を入力する
- [Google に接続]を押し、アカウントを選んでアクセスを許可する
- 「🟢 接続済:(メールアドレス)」に変われば完了
3 つとも同じプロジェクトのものにしてください。クライアント ID と別プロジェクトの API キーを混ぜると、フォルダ選択の画面が開きません(Google 側でプロジェクトの一致を見ています)。
あとは「② 転送ルール」で保存先フォルダを選び、保存してアプリを更新すれば、通常どおり使えます。
つまずきやすいところ
| 症状 | 原因と対処 |
|---|---|
| [フォルダを選択]を押しても何も開かない | Google Picker API が有効になっていない/API キーに HTTP リファラー制限が付いている/クライアント ID と API キーが別プロジェクト |
| 「API デベロッパー キーが無効です。」と出る | API キーの HTTP リファラー制限を外してください(アプリケーションの制限=なし) |
| 接続が 7 日で切れる | OAuth 同意画面が「テスト」のままです。「本番環境に公開」に切り替えてください |
| 接続時に「アクセスをブロックしました」「確認されていないアプリ」と出る | ①OAuth 同意画面が「テスト」のままです。「本番環境に公開」に切り替えてから接続してください(テストのまま使う場合は、自分のアカウントをテストユーザーに追加します)/②ユーザーの種類が「内部」で、組織外のアカウントで接続しようとしています。組織内のアカウントで接続してください |
| リダイレクト URI が一致しないと言われる | 末尾まで含めて https://kizuna-works.jp/drive-connect/callback.html と完全一致で登録してください |
| しばらく使っていなかったら接続が切れた | Google のリフレッシュトークンは 6 か月間まったく使われないと失効します。設定画面から接続し直してください。日常的に転送していれば起きません |
| 接続はできるが転送でエラーになる | Google Drive API が有効になっているか確認してください |
よくある質問
費用はかかりますか?
Google の審査(アプリの確認)は必要ですか?
drive.file だけで、Google が非機密に分類しているものです。Google Workspace で「内部」を選んだ場合は審査という手続き自体がありません。「外部」の場合も、本番環境に公開するだけで使えます(同意画面にアプリ名やロゴを表示したい場合のみ、ブランド確認という軽い手続きがあります)。リダイレクト URI が KIZUNA Works のページなのはなぜですか?
あとから KIZUNA Works の接続に戻せますか?
複数のアプリで使う場合、プロジェクトも複数必要ですか?
ドライブ連携 for kintone
添付ファイルを Google ドライブへ転送し、kintone にはリンクだけを残すプラグインです。無料プランでも転送ルール1本・手動モードで利用でき、自動転送や一覧からの一括転送はプレミアム年間サポーター(税込 ¥16,500/年)に含まれます。
製品ページを見る →