HTTP(第2世代)の連携先として、Google APIsを使用することができます。
ReckonerからGoogle APIsに接続するには、選択する認証方式(oauth または service_account)に応じた設定が必要です。
事前確認
- oauthの場合:画面上のログイン・認可操作のみで完了します。事前にJSONキーなどのファイルを取得・添付する必要はありません。
- service_accountの場合:Google Cloud Consoleで事前にサービスアカウントの作成およびJSONキー(秘密鍵ファイル)の発行が必要です。
認証方式の選択
ReckonerからGoogle APIsに接続するには、以下の2種類の認証方式があります。ご利用の環境や用途に合わせて選択してください。
| 認証方式 | 概要 | 適したケース |
| oauth | ユーザー認証 利用者のGoogleアカウントでログインして認可します。 |
個人のアカウントがアクセス権を持つリソース(Google Workspace等)に連携する場合 |
| service_account | サービスアカウント認証 GCP(Google Cloud Platform)側で発行したサービスアカウントキー(JSON)を使用して接続します。 |
自動実行、共有データの操作、システム間連携など長期運用する場合 |
スコープ(全認証方式共通)
「スコープ」は、ReckonerがGoogleのどのデータや機能に対してどんな操作(閲覧、作成、編集、削除など)を行うかを定義するための権限設定です。認証方式(oauth / service_account)に関わらず設定が必要です。
設定方法
- URL形式で入力:Googleが定義しているスコープURLを入力します。
- 複数指定の場合:「+ 追加」ボタンをクリックして入力欄を増やし、1つの欄につき1つのスコープURLを入力してください。
代表的なサービスとスコープの例
操作目的に合わせて、該当するスコープURLをコピーして接続設定画面の「スコープ」欄に入力してください。
| サービス | 操作目的・アクセス範囲 | スコープURL |
| Gmail | メールすべての閲覧、作成、送信、完全削除 | https://mail.google.com/ |
| Gmail | メールの閲覧(読み取り専用) | https://www.googleapis.com/auth/gmail.readonly |
| Google Drive | ファイルすべての閲覧、編集、作成、削除 | https://www.googleapis.com/auth/drive |
| Google Drive | ファイルの閲覧・ダウンロード(読み取り専用) | https://www.googleapis.com/auth/drive.readonly |
| Google スプレッドシート | スプレッドシートの閲覧・編集 | https://www.googleapis.com/auth/spreadsheets |
| Google スプレッドシート | スプレッドシートの閲覧(読み取り専用) | https://www.googleapis.com/auth/spreadsheets.readonly |
※上記以外のサービスや目的のスコープを確認したい場合は、Google公式の「OAuth 2.0 Scopes for Google APIs」をご参照ください。
必要情報
認証方法が「oauth」の場合
項目名 |
入力条件 |
詳細 |
|---|---|---|
| 認証方法 | 必須 | 「oauth」を選択 |
| スコープ | 必須 | 利用するGoogle APIに応じたスコープURLを入力 ※「+ 追加」ボタンで複数のスコープを指定できます。 |
| OAuth | 必須 | 「Google」ボタンを押下し、GoogleアカウントでのOAuth認証を行う 認可成功後、画面上に「認可成功」と表示されます。 |
| 表示名 | 必須 | この接続設定を識別するための任意の名称を入力 ※OAuth認可成功後に表示・入力可能になります。 |
認証方法が「service_account」の場合
項目名 |
入力条件 |
詳細 |
|---|---|---|
| 認証方法 | 必須 | 「service_account」を選択 |
| 表示名 | 必須 | この接続設定を識別するための任意の名称を入力 接続情報一覧画面に表示される名称となります。 |
| スコープ | 必須 | 利用するGoogle APIに応じたスコープURLを入力 ※「+ 追加」ボタンで複数のスコープを指定できます。 |
| GCPサービスアカウント JSONキー | 必須 | Google Cloud Consoleからダウンロードしたサービスアカウントの鍵ファイル(.json)をドラッグ&ドロップまたは選択して指定 |
サービスアカウントのJSONキー取得手順
注意 サービスアカウントのJSONキー取得手順は service_account認証を利用する場合のみ必要な事前設定 です。(OAuth認証の場合は以下の操作は不要です。)
取得方法は以下のページを参照してください。
【接続情報】Google Search Console Json Keyの作成方法