BigQuery Access Control Settings

[blowmage]

Display and update the access rules on a BigQuery table. The proposed API is:

• Dataset#access getter
• Dataset#access= setter
• Dataset#access DSL with block
• Project#create_dataset with access DSL block
• Updated documentation

The access getter/setter will return and set the raw data as represented in the API. The access block will yield an access object that will enable easy configuration of the access rules:

dataset.access do |acl|
  acl.add_owner_group "owners@example.com"
  acl.add_writer_user "writer@example.com"
  acl.remove_writer_user "readers@example.com"
  acl.add_reader_special :all
  acl.add_reader_view other_dataset_view_object
end # All changes made in a single API call at the end of the block

The same DSL can be used when creating a new dataset:

bigquery.create_dataset "new-dataset" do |acl|
  acl.add_owner_group "owners@example.com"
  acl.add_writer_user "writer@example.com"
  acl.remove_writer_user "readers@example.com"
  acl.add_reader_special :all
  acl.add_reader_view other_dataset_view_object
end #=> New dataset object created with the access rules