前提条件
開始する前に、以下を確認してください：- Administrator がサービスアカウントを作成し、Client Id と Client Secret を共有していること。これらの認証情報は、サービスアカウントの作成時に一度だけ表示されます。サービスアカウントの作成手順については、Service Accounts を参照してください。
- サービスアカウントに、データコネクションまたはワークスペースに対する権限が少なくとも 1 つ割り当てられていること。Administrator は Edit Service Account ページから権限を設定します。詳細については、権限とアクセス制御 を参照してください。
- サービスアカウントのステータスが Active であること。非アクティブなサービスアカウントは認証できません。
Client Secret をお持ちでない場合は、Administrator に依頼して Users ページの Service Accounts タブからサービスアカウントの認証情報をローテーションしてもらってください。新しいシークレットは認証情報のローテーション直後に表示されます。シークレットは一度しか表示されません。
認証
Authentication ガイドの OAuth 2.0 Client Credentials の手順に従って、ベアラートークンを取得し、最初の API 呼び出しを行います。セットアップの検証
権限を持つコネクションに対してクエリを実行します。成功レスポンスが返れば、サービスアカウントの認証が完了し、利用可能な状態であることが確認できます。 リクエストが失敗した場合は、以下を確認してください：- トークンの有効期限切れ：トークンは
expires_inの期間経過後に失効します。新しいトークンをリクエストして再試行してください。 - 権限の不足：サービスアカウントには、クエリ対象のコネクションに対する権限が必要です。Administrator に連絡し、Users ページの Service Accounts タブで権限を確認または更新してください。
- 非アクティブなアカウント：サービスアカウントのステータスは Active である必要があります。Administrator は Users ページの Service Accounts タブからステータスを確認および更新できます。