BigQuery API V2(Java)を使用して、
BigQueryテーブルのアクセス許可をテストする方法についてご紹介します。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[BigQuery API(V2)] JavaでBigQueryを使う
を参照ください。

No			目次
1			アクセス許可をテスト
	1		スコープ
	2		実行
	3		レスポンスの内容
	4		IAM権限
		1	BigQueryの権限
		2	BigQueryMLタスクの権限

1. アクセス許可をテスト

指定したテーブルのアクセス許可をテストします。

1.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

BigqueryScopes.BIGQUERY
BigqueryScopes.CLOUD_PLATFORM
BigqueryScopes.CLOUD_PLATFORM_READ_ONLY
https://www.googleapis.com/auth/bigquery.readonly

⧉[BigQuery API(V2)] JavaでBigQueryを使う(3.2. BigQueryインスタンスを取得)
でスコープを指定してください。

1.2. 実行

public static void main(String[] args) throws Exception{
    Bigquery bigquery = getBigquery();
    Bigquery.Tables tables = bigquery.tables();
    
    String resource = String.format("projects/%s/datasets/%s/tables/%s",
                                    "プロジェクトID","データセットID","テーブルID");
    
    TestIamPermissionsRequest content = new TestIamPermissionsRequest();
    content.setPermissions(Arrays.asList("bigquery.tables.getIamPolicy"));
    
    Bigquery.Tables.TestIamPermissions permission = tables.testIamPermissions(resource,content);
    
    TestIamPermissionsResponse res = permission.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

POST:　https://bigquery.googleapis.com/bigquery/v2/projects/{プロジェクトID}/datasets/{データセットID}/tables/{テーブルID}:testIamPermissions
が実行されます。

1.2.2. クエリパラメータ

クエリパラメータはありません。

1.2.3. リクエストボディ

TestIamPermissionsRequestメソッドにより、リクエストボディを追加できます。

メソッド	引数	説明
setPermissions	List<String>	チェックするためのIAM権限

1.3. レスポンスの内容

TestIamPermissionsResponse

メソッド	戻り値	説明
getPermissions	List<String>	許可されたIAM権限

1.4. IAM権限

1.4.1. BigQueryの権限

権限	説明
bigquery.bireservations.get	BI Engine の予約を読み取ります
bigquery.bireservations.update	BI Engine の予約を更新します
bigquery.capacityCommitments.create	プロジェクトに容量コミットメントを作成します
bigquery.capacityCommitments.delete	容量コミットメントを削除します
bigquery.capacityCommitments.get	容量コミットメントに関する詳細を取得します
bigquery.capacityCommitments.list	プロジェクト内の容量コミットメントすべてを一覧表示します
bigquery.capacityCommitments.update	プロジェクト内の容量コミットメントすべてを更新します
bigquery.config.update	構成を作成します
bigquery.config.get	構成の詳細を取得します
bigquery.connections.create	プロジェクト内で新しい接続を作成します
bigquery.connections.delete	接続を削除します
bigquery.connections.get	接続のメタデータを取得します。認証情報は除外されます
bigquery.connections.list	プロジェクト内の接続を一覧表示します
bigquery.connections.update	接続とその認証情報を更新します
bigquery.connections.updateTag	接続のタグを更新します
bigquery.connections.use	接続構成を使用して、リモートデータソースに接続します
bigquery.connections.delegate	承認済みの外部テーブルとリモート関数を作成するために接続を委任します
bigquery.dataPolicies.create	新しいデータポリシーを作成します
bigquery.dataPolicies.delete	データポリシーを削除します
bigquery.dataPolicies.get	データポリシーに関するメタデータを取得します
bigquery.dataPolicies.getIamPolicy	データポリシーの IAM 権限を読み取ります
bigquery.dataPolicies.list	プロジェクト内のデータポリシーを一覧表示します
bigquery.dataPolicies.maskedGet	データポリシーに関連付けられたポリシータグを持つ列のマスクされたデータを表示します
bigquery.dataPolicies.setIamPolicy	データポリシーの IAM 権限を設定します
bigquery.dataPolicies.update	データポリシーのメタデータを更新します
bigquery.datasets.create	新しい空白のデータセットを作成します
bigquery.datasets.createTagBinding	データセットにリソースタグバインディングを作成します
bigquery.datasets.delete	データセットを削除します
bigquery.datasets.deleteTagBinding	データセットのリソースタグバインディングを削除します
bigquery.datasets.get	データセットに関するメタデータと権限を取得します
bigquery.datasets.getIamPolicy	Google Cloud コンソールでデータセットの IAM 権限を取得するオプションをユーザーに提供するために必要です
bigquery.datasets.link	リンクされたデータセットを作成します
bigquery.datasets.listTagBindings	データセットのリソースタグバインディングを一覧表示します
bigquery.datasets.setIamPolicy	Google Cloud コンソールでデータセットの IAM 権限を設定するオプションをユーザーに提供するために必要です
bigquery.datasets.update	データセットのメタデータと権限を更新します
bigquery.datasets.updateTag	データセットの Data Catalog タグを更新します
bigquery.jobs.create	プロジェクト内でジョブ（クエリを含む）を実行します
bigquery.jobs.get	ジョブのデータとメタデータを取得します
bigquery.jobs.list	すべてのジョブを一覧表示し、任意のユーザーが送信した任意のジョブのメタデータを取得します
bigquery.jobs.listAll	すべてのジョブを一覧表示し、任意のユーザーが送信した任意のジョブのメタデータを取得します
bigquery.jobs.listExecutionMetadata	ユーザーが送信したジョブに関するすべてのジョブ実行メタデータを一覧表示します
bigquery.jobs.delete	ジョブのメタデータを削除します
bigquery.jobs.update	ジョブをキャンセルします
bigquery.models.create	新しいML モデルを作成します
bigquery.models.delete	ML モデルを削除します
bigquery.models.getData	ML モデルのデータを取得します
bigquery.models.getMetadata	ML モデルのメタデータを取得します
bigquery.models.list	ML モデルとモデルのメタデータを一覧表示します
bigquery.models.updateData	ML モデルのデータを更新します
bigquery.models.updateMetadata	ML モデルのメタデータを更新します
bigquery.models.export	ML モデルをエクスポートします
bigquery.models.updateTag	モデルの Data Catalog タグを更新します
bigquery.readsessions.create	Storage Read API を使用して新しい読み取りセッションを作成します
bigquery.readsessions.getData	Storage Read API を使用して読み取りセッションからデータを読み取ります
bigquery.readsessions.update	Storage Read API を使用して読み取りセッションを更新します
bigquery.reservations.create	管理プロジェクトでスロット予約を作成します
bigquery.reservations.delete	スロット予約を削除します
bigquery.reservations.get	スロット予約の詳細を取得します
bigquery.reservations.list	管理プロジェクト内のすべてのスロット予約を一覧表示します
bigquery.reservations.update	スロット予約のプロパティを更新します
bigquery.reservationAssignments.create	予約割り当てを作成します
bigquery.reservationAssignments.delete	予約割り当てを削除します
bigquery.reservationAssignments.list	プロジェクト内の予約割り当てすべてを一覧表示します
bigquery.reservationAssignments.search	特定のプロジェクト、フォルダ、または組織の予約割り当てを見つけます
bigquery.rowAccessPolicies.create	テーブルに新しい行レベルのアクセスポリシーを作成します
bigquery.rowAccessPolicies.delete	テーブルから行レベルのアクセスポリシーを削除します
bigquery.rowAccessPolicies.getFilteredData	テーブルから、行レベルアクセスポリシーの権限譲受人リストにあるプリンシパルにのみ表示するデータを取得します
bigquery.rowAccessPolicies.list	テーブルのすべての行レベルのアクセスポリシーを表示します
bigquery.rowAccessPolicies.overrideTimeTravelRestrictions	行レベルのアクセスポリシーがある、または以前に存在していたテーブルの過去のデータにアクセスします
bigquery.rowAccessPolicies.getIamPolicy	行アクセスポリシーの IAM 権限を取得します
bigquery.rowAccessPolicies.setIamPolicy	行アクセスポリシーの IAM 権限を設定します
bigquery.rowAccessPolicies.update	行レベルのアクセスポリシーを再作成します
bigquery.routines.create	新しいルーティン（関数とストアドプロシージャ）を作成します
bigquery.routines.delete	ルーティンを削除します
bigquery.routines.get	ルーティンの定義とメタデータを取得します
bigquery.routines.list	ルーティンおよびルーティンのメタデータを一覧表示します
bigquery.routines.update	ルーティンの定義とメタデータを更新します
bigquery.routines.updateTag	ルーティンの Data Catalog タグを更新します
bigquery.savedqueries.create	保存したクエリを作成します
bigquery.savedqueries.delete	保存したクエリを削除します
bigquery.savedqueries.get	保存したクエリのメタデータを取得します
bigquery.savedqueries.list	保存したクエリの一覧を表示します
bigquery.savedqueries.update	保存したクエリを更新します
bigquery.tables.create	新しいテーブルを作成します
bigquery.tables.createIndex	テーブルの検索インデックスを作成します
bigquery.tables.createSnapshot	新しいテーブルスナップショットを作成します
bigquery.tables.createTagBinding	テーブルにリソースタグバインディングを作成します
bigquery.tables.delete	テーブルを削除します
bigquery.tables.deleteIndex	テーブルの検索インデックスを削除します
bigquery.tables.deleteSnapshot	テーブルスナップショットを削除します
bigquery.tables.deleteTagBinding	テーブルのリソースタグバインディングを削除します
bigquery.tables.export	BigQuery からテーブルのデータをエクスポートします
bigquery.tables.get	テーブルのメタデータを取得します
bigquery.tables.getData	テーブルのデータを取得します
bigquery.tables.getIamPolicy	テーブルの IAM ポリシーを読み取ります
bigquery.tables.list	テーブルとテーブルのメタデータを一覧表示します
bigquery.tables.replicateData	テーブルデータを複製します
bigquery.tables.restoreSnapshot	テーブルスナップショットを復元します
bigquery.tables.setCategory	テーブルスキーマにポリシータグを設定します
bigquery.tables.setIamPolicy	テーブルの IAM ポリシーを変更します
bigquery.tables.update	テーブルのメタデータを更新します
bigquery.tables.updateData	テーブルのデータを更新します
bigquery.tables.updateTag	テーブルの Data Catalog タグを更新します
bigquery.transfers.get	転送のメタデータを取得します
bigquery.transfers.update	転送を作成、更新、削除します

1.4.2. BigQueryMLタスクの権限

権限	説明
bigquery.jobs.create bigquery.models.create bigquery.models.getData bigquery.models.updateData	CREATE MODEL ステートメントを使用して新しいモデルを作成する
bigquery.jobs.create bigquery.models.create bigquery.models.getData bigquery.models.updateData bigquery.models.updateMetadata	CREATE OR REPLACE MODEL ステートメントを使用して既存のモデルを置き換える
bigquery.models.delete	models.delete API を使用してモデルを削除する
bigquery.jobs.create bigquery.models.delete	DROP MODEL ステートメントを使用してモデルを削除する
bigquery.models.getMetadata	models.get API を使用してモデルメタデータを取得する
bigquery.models.list	models.list API を使用してモデルとそのメタデータを一覧表示する
bigquery.models.updateMetadata	models.delete API を使用してモデルメタデータを更新する
bigquery.jobs.create bigquery.models.getData	ML.EVALUATE、ML.PREDICT、ML.TRAINING_INFO、ML.WEIGHTS などの関数を使用して、評価、予測、モデル、特徴の検査を行う
bigquery.jobs.create bigquery.models.export	モデルをエクスポートする
bigquery.models.updateTag	モデルの Data Catalog タグを更新する

おしまい。。