Google アプリケーション用の OAuth クライアントID、クライアントシークレット、アクセストークン、およびリフレッシュトークンを取得するには

Google Cloud Platform では、プロジェクトにおける OAuth および 2.0 の認証と承認に関する詳細を設定します。 IBM （ App Connect ）では、既存のプロジェクトを使用するか、新しいプロジェクトを作成することができます。

1. Google Cloud Platform （ https://console.developers.google.com/apis/dashboard ）を開きます。

   ( Google アカウントでサインイン)

2. プロジェクト・メニューから、以下のように既存のプロジェクトを選択するか、新しいプロジェクトを作成する。
   1. NEW PROJECTをクリック
   2. 表示された場合は、 Google Cloud Platform の利用規約に同意して続行してください
   3. プロジェクトを識別するプロジェクト名を入力します。

      Project for IBM App Connect

   4. 「作成」をクリックします。

IBM App Connect 使用のためのアクセストークンとリフレッシュトークンを取得するために、同意画面を使用します。

1. 「 OAuth 」の同意画面オプションを選択してください
2. Google Workspace ユーザーでない場合は、[ External] チェックボックスが選択されているため、アプリを自分で使用したり、 Google アカウントを持つユーザーがアプリを使用できるようにしたりできます。 これらのユーザーは、アクセストークンとリフレッシュトークンを設定する際に 「未確認のアプリ 」画面が表示される場合がありますが、 OAuth の認証情報を使用して、 IBM App Connect を Google のアプリに接続することができます。 Google Workspace ユーザーは、 「内部 」チェックボックスを選択することで、組織内の他のユーザーがアプリを利用できるようにすることができます。 Google の管理コンソールでは、組織の構造、設定、およびポリシーに応じて、ユーザーが独自のクライアントIDとクライアントシークレットを作成できます。 あるいは、 Google ワークスペースのアカウント所有者のクライアントIDとクライアントシークレットを使用することも可能です。 これらのユーザーは、アクセストークンとリフレッシュトークンを設定する際に 「未確認のアプリ 」画面が表示されず、 OAuth の認証情報を使用して、 IBM App Connect を Google のアプリに接続することができます。
3. 「作成」をクリックします。
4. App for IBM App Connect のように、アプリケーションを識別する名前を入力します。
5. Authorized domains（許可されたドメイン） フィールドに、 ibm.com と入力し、returnを押して値を許可されたドメインのリストに追加します。
6. 保存 をクリックします。

「 認証情報 」オプションを使用して、 OAuth のクライアントIDとシークレットを取得してください。

1. 資格情報オプションをクリックします
2. をクリックします。
3. OAuth のクライアントID をクリック
4. Webアプリケーションのチェックボックスをクリックします
5. 「 IBM App Connect 」の「 OAuth 」を管理しやすくするために、名前を入力してください。例： Web client for IBM App Connect
6. Authorized redirect URIs ］フィールドに、 Google API playground用のリダイレクトURIを入力します（この値は、後でアクセストークンとリフレッシュトークンを取得する際に必要になります）： https://developers.google.com/oauthplaygroundを入力し、returnを押してこの値をリストに追加します
7. 作成 をクリックします。

プロジェクトでは、使用可能な Google API を有効にしてください。 APIの利用を許可するスコープを後で定義する。 例えば、メッセージの取得のみや、新しいスプレッドシートの作成などである。

1. ライブラリオプションをクリックします。
2. IBM App Connect フローで使用する Google API を選択し、[ ENABLE] をクリックします。

IBM App Connect で使用したい Google アプリのそれぞれについて、以下の手順を繰り返す：

• Gmail Gmail API
• Google アナリティクス Google アナリティクスAPI
• Google Drive : Google Drive API
• Google シート Google Sheets API および Google Drive API
• Google カレンダー Google カレンダーAPI
• Google 翻訳する Google 翻訳API
• Google 連絡先 Google コンタクトAPI
• Google チャット Google チャットAPI
• Google グループ Google グループAPI
• Google タスク Google タスクAPI
• Google Gemini：Google Gemini API

以下の手順では、 Google Developers（ OAuth ）の 2.0 Playgroundを使用してアクセストークンとリフレッシュトークンを取得し、 IBM （ App Connect ）で使用する各 Google アプリのAPIスコープを選択します。 この段階では、APIのスコープを選択し、 IBM App Connect で使用したい Google アカウントのアクセストークンとリフレッシュトークンを取得します。 そのアカウントは、以前の段階で「 Google 」アプリを作成するために使用した Google アカウント（クライアントIDとクライアントシークレットを取得するため）とは異なる場合があります。 IBM （ App Connect ）で一連のイベントやアクションをすべて実行できるようにするには、このセクションに記載されているように、最も高い権限を持つスコープを選択してください。 IBM （ App Connect ）の権限を制限し、特定のイベントやアクションのみを実行できるようにすることができます。具体的には、1つの Google アプリケーションに必要なスコープのみを含むアクセストークンを取得し、イベントやアクションに必要な最も制限の厳しいスコープのみを選択することで実現できます。 1つ以上の Google アプリケーションにおけるイベントやアクションに必要な、それぞれ異なるスコープの組み合わせを持つ複数のアクセストークンを取得できます。 たとえば、スコープが ` https://www.googleapis.com/auth/gmail.readonly ` のアクセストークンを取得することで、` IBM ` および ` App Connect ` のフローを「新しいメール」イベントによってトリガーし、「メールを取得」アクションを実行できるようになります。

1. Google 開発者向けページを表示 OAuth 2.0 Playground: https://developers.google.com/oauthplayground/
2. クライアントIDとクライアントシークレットを指定します：
   1. 設定アイコン（右側）をクリックします
   2. 「 OAuth の認証情報を使用する 」チェックボックスを選択してください
   3. OAuth のクライアントIDと OAuth のクライアントシークレットを入力してください
   4. 閉じるをクリック

   

   (画像をクリックすると拡大表示されます）

3. Step 1 Select & authorize APIs」では、 IBM App Connect で使用したい Google アプリごとに、API のスコープを選択する。 IBM App Connect がすべてのイベントとアクションを実行できるようにするには、使用する Google アプリケーションを以下のスコープリストから選択することをお勧めします：
   • Gmailアプリの場合 - (Gmail API v1 の下 )
     • https://www.googleapis.com/auth/gmail.modify
   • Google Drive アプリの場合 - (Drive API v3 の下 )
     • https://www.googleapis.com/auth/drive
   • Google Sheets アプリ用 - ( Google Sheets API v4 の下)
     • https://www.googleapis.com/auth/drive
   • Google アナリティクスアプリについて – （ Google アナリティクスAPI v4 ）
     • https://www.googleapis.com/auth/analytics
     • https://www.googleapis.com/auth/analytics.edit
     • https://www.googleapis.com/auth/analytics.manage.users
     • https://www.googleapis.com/auth/analytics.manage.users.readonly
   IBM App Connect、フローをトリガーする「New email」イベントやメールを送信する「Send email」アクションなど、イベントやアクションのサブセットのみを実行できるようにするには、より小さな権限を持つスコープを選択します。例えば、Gmailのイベントやアクションでは、以下のような小さなスコープを選択できます：
   • 'New email' イベントと 'Retrieve emails' アクション：
     • https://www.googleapis.com/auth/gmail.readonly
   • メール送信」アクション：
     • https://www.googleapis.com/auth/gmail.readonly
     • https://www.googleapis.com/auth/gmail.send
   • メールを削除する」アクション：
     • https://www.googleapis.com/auth/gmail.readonly
     • https://www.googleapis.com/auth/gmail.compose
   • 電子メール・ラベルの更新アクションは、スコープ https://www.googleapis.com/auth/gmail.modify を必要とします。このスコープは、 IBM App Connect、すべてのイベントとアクションを実行できるようにします。

   (Gmail、 Google Analytics、 Google Drive、 Google Sheets、 Google Calendar、 Google Translate、 Google Contacts、 Google Chat、 Google Groups、 Google Tasks、 Google Geminiの最小APIスコープについては、 このページの脚注を参照)

   

   (画像をクリックすると拡大表示されます）

4. Authorize APIs ］をクリックします。
5. アカウントの選択ウィンドウで、 IBM App Connect で使用する Google アカウントを選択します。 This app isn't verified（このアプリは認証されていません）」というメッセージが表示される場合は、設定しようとしているアプリが Google によって認証されていないためです。 続ける：
   1. Advanced（詳細）リンクをクリックし、続行するオプションを表示します
   2. 「移動」 リンクをクリックします（先ほど定義した「 OAuth 」の同意画面へ移動します）

   先ほど選択した Google APIそれぞれのダイアログウィンドウが表示されます。 各ダイアログウィンドウの［ 許可］をクリックします。 (表示されたパーミッションに懸念がある場合は、後で戻って選択した Google APIを変更することができます) 最後のダイアログウィンドウの後に、先ほど定義した OAuth の同意画面が表示されます（許可した Google APIの情報が入力された状態で表示されます）。

   

   (画像をクリックすると拡大表示されます）

6. 「 OAuth 」の同意ウィンドウで、 「許可」 をクリックします。 （表示されている権限について懸念がある場合は、該当するチェックボックスの選択を解除するか、戻って有効にした Google APIを変更することができます。）
7. ステップ2でトークンの認証コードを交換します。
   1. チェックボックス「 Auto-refresh before it expires 」を選択します
   2. トークンの認証コードを交換 ]をクリックします。

これらの手順は、次の例に示すように、アクセストークンとリフレッシュトークンを生成し、選択したAPIのスコープを生成します。

{
  "access_token": "ya29.Il-9B2KbXhweZamxIsHe3_rjblkc7Xh_...VyvmQlj-JgAuWsTeTw29Hl22ivqHUIdwuDVn9ixxaEGJoDkZBZAkaCss4w", 
  "scope": "https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/drive", 
  "token_type": "Bearer", 
  "expires_in": 3599, 
  "refresh_token": "1//04g2mKH5RhxUECgYIARAAGAQSNwF-L9IreLqEqk...x5eDp6nTKBRsxCRMVW6gU9ijJnY02uQRuw"
}