PREMIUM PLUGIN

自社の Google Cloud で使う ― 設定手順

ドライブ連携 for kintone

ドライブ連携は、はじめから使える KIZUNA Works の接続と、お客様ご自身の Google Cloud のどちらでも動きます。本番運用では自社の Google Cloud をおすすめします。このページはその準備手順です。作業は 15 分ほど、費用はかかりません。

なぜ自社の Google Cloud をすすめるのか

どちらを選んでも機能は同じで、ファイルの流れも変わりません(利用者のブラウザから Google ドライブへ直送)。違うのは「誰の Google 利用枠を使うか」です。

01

利用枠が自社専用になる

Google の利用枠(クォータ)は Cloud プロジェクト単位で決まります。KIZUNA Works の接続は当社のプロジェクトを全ご利用者で共有するため、毎日大量に転送する運用では枠を分け合うことになります。

02

第三者の都合で止まらない

当社の接続を使う場合、当社の OAuth クライアントに何かあれば影響を受けます。自社のプロジェクトなら、止まる・止めるの判断も自社で握れます。

03

利用状況を自社で確認できる

API の利用状況を自社の Cloud コンソールで確認できます。情報システム部門の管理下に置きたい場合に向いています。

まず動かして試したいだけなら、KIZUNA Works の接続のままで構いません。あとから設定画面で切り替えられます(保存先フォルダの選び直しと再接続が必要です)。

用意するもの

  • Google アカウント(Google Workspace を推奨。個人の Google アカウントでも可)
  • kintone のアプリ管理権限(設定画面を開くため)
  • 費用は不要です。Google Drive API と Google Picker API は、請求先アカウントを紐づけなくても使えます

所要時間の目安:15 分。作業は最初の 1 回だけで、そのあとは通常の利用に切り替わります。

設定手順

1Google Cloud プロジェクトを作る

下記を開き、プロジェクトを 1 つ作ります。名前は何でも構いません(例:kintone-drive-connect)。

https://console.cloud.google.com/projectcreate

Google Workspace をお使いの場合は、組織に所属したプロジェクトとして作ってください。次の手順 3 で「内部」を選べるようになり、手続きが一段簡単になります。

2API を 2 つ有効にする

画面右上のプロジェクト名が、いま作ったプロジェクトになっているか必ず確認してから、次の 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 を忘れないでください。保存先フォルダを選ぶ画面がこれを使います。有効になっていないと、設定画面の[フォルダを選択]を押しても何も開きません。

3OAuth 同意画面を用意する

「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 が非機密に分類しているため審査の対象になりません。同意画面に出る内容と実際に要求する内容を揃えておくと、接続時に「確認されていないアプリ」の警告が出るのを防げます。

4OAuth クライアント ID を作る

「クライアント」→「クライアントを作成」と進みます。

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クライアント シークレットを控えてください(シークレットはこの画面を閉じると再表示できないことがあります)。

5API キーを作る(フォルダ選択用)

「認証情報」→「認証情報を作成」→「API キー」で作ります。

https://console.cloud.google.com/apis/credentials

作成したキーを開き、次のとおり設定してください。

  • API の制限「Google Picker API」だけを選ぶ(必ず設定してください)
  • アプリケーションの制限「なし」のままにする
HTTP リファラー制限は付けないでください。付けるとフォルダ選択の画面が「API デベロッパー キーが無効です。」となって開きません。フォルダ選択の画面は Google 側(docs.google.com)で読み込まれるため、kintone のドメインでは照合が通らないためです。
制限を「Picker API のみ」にしてあれば、仮にキーが読み取られてもできるのはフォルダ選択の画面を出すことだけで、ドライブのデータには一切触れられません(アクセスには別途 OAuth の認可が必要です)。
6プラグインに登録して接続する

kintone のアプリ設定 → プラグイン →「ドライブ連携 for kintone」の歯車 →「① Google 接続」を開きます。

  1. 接続方式で 「自社の Google Cloud を使う【推奨】」 を選ぶ
  2. クライアント IDクライアント シークレットAPI キー を入力する
  3. [Google に接続]を押し、アカウントを選んでアクセスを許可する
  4. 「🟢 接続済:(メールアドレス)」に変われば完了

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 API と Google Picker API は請求先アカウントを紐づけなくても利用でき、通常の利用範囲では料金が発生しません。プロジェクトに請求先アカウントを紐づけないままにしておけば、想定外の請求が発生する経路そのものがありません。
Google の審査(アプリの確認)は必要ですか?
通常は不要です。本プラグインが求めるアクセス権は drive.file だけで、Google が非機密に分類しているものです。Google Workspace で「内部」を選んだ場合は審査という手続き自体がありません。「外部」の場合も、本番環境に公開するだけで使えます(同意画面にアプリ名やロゴを表示したい場合のみ、ブランド確認という軽い手続きがあります)。
リダイレクト URI が KIZUNA Works のページなのはなぜですか?
Google は認可後の戻り先を完全一致でしか認めず、ワイルドカードも使えないためです。お客様の kintone サブドメインを個別に登録していく方式は現実的でないため、当社が用意した静的なページ 1 枚に集約しています。このページはサーバー処理を持たず、受け取った認可コードをブラウザ内で設定画面へ渡すだけで、保存も転送もしません。ファイルがここを通ることもありません。
あとから KIZUNA Works の接続に戻せますか?
戻せます。設定画面の「① Google 接続」で接続方式を切り替え、あらためて接続してください。切り替え後は保存先フォルダを選び直す必要があります(フォルダの選択は接続したアカウントの権限で行うためです)。すでにドライブへ転送済みのファイルとリンクはそのまま残ります。
複数のアプリで使う場合、プロジェクトも複数必要ですか?
必要ありません。1 つの Cloud プロジェクトで作ったクライアント ID・シークレット・API キーを、複数のアプリの設定画面にそれぞれ入力してお使いいただけます。

ドライブ連携 for kintone

添付ファイルを Google ドライブへ転送し、kintone にはリンクだけを残すプラグインです。無料プランでも転送ルール1本・手動モードで利用でき、自動転送や一覧からの一括転送はプレミアム年間サポーター(税込 ¥16,500/年)に含まれます。

製品ページを見る →