google-api-client 0.45.1 → 0.48.0

data/generated/google/apis/bigquery_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryV2
       VERSION = 'V2'
-      REVISION = '20200916'
+      REVISION = '20201022'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

data/generated/google/apis/bigquery_v2/classes.rb

@@ -1443,6 +1443,12 @@ module Google
         # @return [String]
         attr_accessor :location
       
+        # [Output-only] Reserved for future use.
+        # Corresponds to the JSON property `satisfiesPZS`
+        # @return [Boolean]
+        attr_accessor :satisfies_pzs
+        alias_method :satisfies_pzs?, :satisfies_pzs
+      
         # [Output-only] A URL that can be used to access the resource again. You can use
         # this URL in Get or Update requests to the resource.
         # Corresponds to the JSON property `selfLink`
@@ -1469,6 +1475,7 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @last_modified_time = args[:last_modified_time] if args.key?(:last_modified_time)
           @location = args[:location] if args.key?(:location)
+          @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @self_link = args[:self_link] if args.key?(:self_link)
         end
         
@@ -1505,6 +1512,15 @@ module Google
           # @return [String]
           attr_accessor :role
         
+          # [Pick one] A routine from a different dataset to grant access to. Queries
+          # executed against that routine will have read access to views/tables/routines
+          # in this dataset. Only UDF is supported for now. The role field is not required
+          # when this field is set. If that routine is updated by any user, access to the
+          # routine needs to be granted again via an update operation.
+          # Corresponds to the JSON property `routine`
+          # @return [Google::Apis::BigqueryV2::RoutineReference]
+          attr_accessor :routine
+        
           # [Pick one] A special group to grant access to. Possible values include:
           # projectOwners: Owners of the enclosing project. projectReaders: Readers of the
           # enclosing project. projectWriters: Writers of the enclosing project.
@@ -1539,6 +1555,7 @@ module Google
             @group_by_email = args[:group_by_email] if args.key?(:group_by_email)
             @iam_member = args[:iam_member] if args.key?(:iam_member)
             @role = args[:role] if args.key?(:role)
+            @routine = args[:routine] if args.key?(:routine)
             @special_group = args[:special_group] if args.key?(:special_group)
             @user_by_email = args[:user_by_email] if args.key?(:user_by_email)
             @view = args[:view] if args.key?(:view)
@@ -2061,6 +2078,32 @@ module Google
         end
       end
       
+      # Explanation for a single feature.
+      class Explanation
+        include Google::Apis::Core::Hashable
+      
+        # Attribution of feature.
+        # Corresponds to the JSON property `attribution`
+        # @return [Float]
+        attr_accessor :attribution
+      
+        # Full name of the feature. For non-numerical features, will be formatted like ..
+        # Overall size of feature name will always be truncated to first 120 characters.
+        # Corresponds to the JSON property `featureName`
+        # @return [String]
+        attr_accessor :feature_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attribution = args[:attribution] if args.key?(:attribution)
+          @feature_name = args[:feature_name] if args.key?(:feature_name)
+        end
+      end
+      
       # Represents a textual expression in the Common Expression Language (CEL) syntax.
       # CEL is a C-like expression language. The syntax and semantics of CEL are
       # documented at https://github.com/google/cel-spec. Example (Comparison): title:
@@ -2431,6 +2474,34 @@ module Google
         end
       end
       
+      # Global explanations containing the top most important features after training.
+      class GlobalExplanation
+        include Google::Apis::Core::Hashable
+      
+        # Class label for this set of global explanations. Will be empty/null for binary
+        # logistic and linear regression models. Sorted alphabetically in descending
+        # order.
+        # Corresponds to the JSON property `classLabel`
+        # @return [String]
+        attr_accessor :class_label
+      
+        # A list of the top global explanations. Sorted by absolute value of attribution
+        # in descending order.
+        # Corresponds to the JSON property `explanations`
+        # @return [Array<Google::Apis::BigqueryV2::Explanation>]
+        attr_accessor :explanations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @class_label = args[:class_label] if args.key?(:class_label)
+          @explanations = args[:explanations] if args.key?(:explanations)
+        end
+      end
+      
       # 
       class GoogleSheetsOptions
         include Google::Apis::Core::Hashable
@@ -2472,25 +2543,36 @@ module Google
       class HivePartitioningOptions
         include Google::Apis::Core::Hashable
       
-        # [Optional, Trusted Tester] When set, what mode of hive partitioning to use
-        # when reading data. Two modes are supported. (1) AUTO: automatically infer
-        # partition key name(s) and type(s). (2) STRINGS: automatically infer partition
-        # key name(s). All types are interpreted as strings. Not all storage formats
-        # support hive partitioning. Requesting hive partitioning on an unsupported
-        # format will lead to an error. Currently supported types include: AVRO, CSV,
-        # JSON, ORC and Parquet.
+        # [Optional] When set, what mode of hive partitioning to use when reading data.
+        # The following modes are supported. (1) AUTO: automatically infer partition key
+        # name(s) and type(s). (2) STRINGS: automatically infer partition key name(s).
+        # All types are interpreted as strings. (3) CUSTOM: partition key schema is
+        # encoded in the source URI prefix. Not all storage formats support hive
+        # partitioning. Requesting hive partitioning on an unsupported format will lead
+        # to an error. Currently supported types include: AVRO, CSV, JSON, ORC and
+        # Parquet.
         # Corresponds to the JSON property `mode`
         # @return [String]
         attr_accessor :mode
       
-        # [Optional, Trusted Tester] When hive partition detection is requested, a
-        # common prefix for all source uris should be supplied. The prefix must end
-        # immediately before the partition key encoding begins. For example, consider
-        # files following this data layout. gs://bucket/path_to_table/dt=2019-01-01/
-        # country=BR/id=7/file.avro gs://bucket/path_to_table/dt=2018-12-31/country=CA/
-        # id=3/file.avro When hive partitioning is requested with either AUTO or STRINGS
-        # detection, the common prefix can be either of gs://bucket/path_to_table or gs:/
-        # /bucket/path_to_table/ (trailing slash does not matter).
+        # [Optional] If set to true, queries over this table require a partition filter
+        # that can be used for partition elimination to be specified. Note that this
+        # field should only be true when creating a permanent external table or querying
+        # a temporary external table. Hive-partitioned loads with requirePartitionFilter
+        # explicitly set to true will fail.
+        # Corresponds to the JSON property `requirePartitionFilter`
+        # @return [Boolean]
+        attr_accessor :require_partition_filter
+        alias_method :require_partition_filter?, :require_partition_filter
+      
+        # [Optional] When hive partition detection is requested, a common prefix for all
+        # source uris should be supplied. The prefix must end immediately before the
+        # partition key encoding begins. For example, consider files following this data
+        # layout. gs://bucket/path_to_table/dt=2019-01-01/country=BR/id=7/file.avro gs://
+        # bucket/path_to_table/dt=2018-12-31/country=CA/id=3/file.avro When hive
+        # partitioning is requested with either AUTO or STRINGS detection, the common
+        # prefix can be either of gs://bucket/path_to_table or gs://bucket/path_to_table/
+        # (trailing slash does not matter).
         # Corresponds to the JSON property `sourceUriPrefix`
         # @return [String]
         attr_accessor :source_uri_prefix
@@ -2502,6 +2584,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @mode = args[:mode] if args.key?(:mode)
+          @require_partition_filter = args[:require_partition_filter] if args.key?(:require_partition_filter)
           @source_uri_prefix = args[:source_uri_prefix] if args.key?(:source_uri_prefix)
         end
       end
@@ -2739,7 +2822,7 @@ module Google
         attr_accessor :compression
       
         # [Optional] The exported file format. Possible values include CSV,
-        # NEWLINE_DELIMITED_JSON or AVRO for tables and ML_TF_SAVED_MODEL or
+        # NEWLINE_DELIMITED_JSON, PARQUET or AVRO for tables and ML_TF_SAVED_MODEL or
         # ML_XGBOOST_BOOSTER for models. The default value for tables is CSV. Tables
         # with nested or repeated fields cannot be exported as CSV. The default value
         # for models is ML_TF_SAVED_MODEL.
@@ -4050,6 +4133,31 @@ module Google
         end
       end
       
+      # Response message for the ListRowAccessPolicies method.
+      class ListRowAccessPoliciesResponse
+        include Google::Apis::Core::Hashable
+      
+        # A token to request the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Row access policies on the requested table.
+        # Corresponds to the JSON property `rowAccessPolicies`
+        # @return [Array<Google::Apis::BigqueryV2::RowAccessPolicy>]
+        attr_accessor :row_access_policies
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @row_access_policies = args[:row_access_policies] if args.key?(:row_access_policies)
+        end
+      end
+      
       # BigQuery-specific metadata about a location. This will be set on google.cloud.
       # location.Location.metadata in Cloud Location API responses.
       class LocationMetadata
@@ -5275,6 +5383,56 @@ module Google
         end
       end
       
+      # Represents access on a subset of rows on the specified table, defined by its
+      # filter predicate. Access to the subset of rows is controlled by its IAM policy.
+      class RowAccessPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The time when this row access policy was created, in milliseconds
+        # since the epoch.
+        # Corresponds to the JSON property `creationTime`
+        # @return [String]
+        attr_accessor :creation_time
+      
+        # Output only. A hash of this resource.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Required. A SQL boolean expression that represents the rows defined by this
+        # row access policy, similar to the boolean expression in a WHERE clause of a
+        # SELECT query on a table. References to other tables, routines, and temporary
+        # functions are not supported. Examples: region="EU" date_field = CAST('2019-9-
+        # 27' as DATE) nullable_field is not NULL numeric_field BETWEEN 1.0 AND 5.0
+        # Corresponds to the JSON property `filterPredicate`
+        # @return [String]
+        attr_accessor :filter_predicate
+      
+        # Output only. The time when this row access policy was last modified, in
+        # milliseconds since the epoch.
+        # Corresponds to the JSON property `lastModifiedTime`
+        # @return [String]
+        attr_accessor :last_modified_time
+      
+        # Required. Reference describing the ID of this row access policy.
+        # Corresponds to the JSON property `rowAccessPolicyReference`
+        # @return [Google::Apis::BigqueryV2::RowAccessPolicyReference]
+        attr_accessor :row_access_policy_reference
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @creation_time = args[:creation_time] if args.key?(:creation_time)
+          @etag = args[:etag] if args.key?(:etag)
+          @filter_predicate = args[:filter_predicate] if args.key?(:filter_predicate)
+          @last_modified_time = args[:last_modified_time] if args.key?(:last_modified_time)
+          @row_access_policy_reference = args[:row_access_policy_reference] if args.key?(:row_access_policy_reference)
+        end
+      end
+      
       # 
       class RowAccessPolicyReference
         include Google::Apis::Core::Hashable
@@ -5779,11 +5937,11 @@ module Google
         attr_accessor :time_partitioning
       
         # [Output-only] Describes the table type. The following values are supported:
-        # TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. [
-        # TrustedTester] SNAPSHOT: An immutable, read-only table that is a copy of
-        # another table. [TrustedTester] MATERIALIZED_VIEW: SQL query whose result is
-        # persisted. EXTERNAL: A table that references data stored in an external
-        # storage system, such as Google Cloud Storage. The default value is TABLE.
+        # TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query.
+        # SNAPSHOT: An immutable, read-only table that is a copy of another table. [
+        # TrustedTester] MATERIALIZED_VIEW: SQL query whose result is persisted.
+        # EXTERNAL: A table that references data stored in an external storage system,
+        # such as Google Cloud Storage. The default value is TABLE.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -6415,8 +6573,9 @@ module Google
         attr_accessor :require_partition_filter
         alias_method :require_partition_filter?, :require_partition_filter
       
-        # [Required] The only type supported is DAY, which will generate one partition
-        # per day.
+        # [Required] The supported types are DAY, HOUR, MONTH, and YEAR, which will
+        # generate one partition per day, hour, month, and year, respectively. When the
+        # type is not specified, the default behavior is DAY.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -6749,6 +6908,13 @@ module Google
         # @return [Google::Apis::BigqueryV2::EvaluationMetrics]
         attr_accessor :evaluation_metrics
       
+        # Global explanations for important features of the model. For multi-class
+        # models, there is one entry for each label class. For other models, there is
+        # only one entry in the list.
+        # Corresponds to the JSON property `globalExplanations`
+        # @return [Array<Google::Apis::BigqueryV2::GlobalExplanation>]
+        attr_accessor :global_explanations
+      
         # Output of each iteration run, results.size() <= max_iterations.
         # Corresponds to the JSON property `results`
         # @return [Array<Google::Apis::BigqueryV2::IterationResult>]
@@ -6773,6 +6939,7 @@ module Google
         def update!(**args)
           @data_split_result = args[:data_split_result] if args.key?(:data_split_result)
           @evaluation_metrics = args[:evaluation_metrics] if args.key?(:evaluation_metrics)
+          @global_explanations = args[:global_explanations] if args.key?(:global_explanations)
           @results = args[:results] if args.key?(:results)
           @start_time = args[:start_time] if args.key?(:start_time)
           @training_options = args[:training_options] if args.key?(:training_options)

data/generated/google/apis/bigquery_v2/representations.rb

@@ -280,6 +280,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Explanation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Expr
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -322,6 +328,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GlobalExplanation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleSheetsOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -454,6 +466,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListRowAccessPoliciesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LocationMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -604,6 +622,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RowAccessPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RowAccessPolicyReference
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1157,6 +1181,7 @@ module Google
           hash :labels, as: 'labels'
           property :last_modified_time, :numeric_string => true, as: 'lastModifiedTime'
           property :location, as: 'location'
+          property :satisfies_pzs, as: 'satisfiesPZS'
           property :self_link, as: 'selfLink'
         end
         
@@ -1167,6 +1192,8 @@ module Google
             property :group_by_email, as: 'groupByEmail'
             property :iam_member, as: 'iamMember'
             property :role, as: 'role'
+            property :routine, as: 'routine', class: Google::Apis::BigqueryV2::RoutineReference, decorator: Google::Apis::BigqueryV2::RoutineReference::Representation
+        
             property :special_group, as: 'specialGroup'
             property :user_by_email, as: 'userByEmail'
             property :view, as: 'view', class: Google::Apis::BigqueryV2::TableReference, decorator: Google::Apis::BigqueryV2::TableReference::Representation
@@ -1304,6 +1331,14 @@ module Google
         end
       end
       
+      class Explanation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attribution, as: 'attribution'
+          property :feature_name, as: 'featureName'
+        end
+      end
+      
       class Expr
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1392,6 +1427,15 @@ module Google
         end
       end
       
+      class GlobalExplanation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :class_label, as: 'classLabel'
+          collection :explanations, as: 'explanations', class: Google::Apis::BigqueryV2::Explanation, decorator: Google::Apis::BigqueryV2::Explanation::Representation
+      
+        end
+      end
+      
       class GoogleSheetsOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1404,6 +1448,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :mode, as: 'mode'
+          property :require_partition_filter, as: 'requirePartitionFilter'
           property :source_uri_prefix, as: 'sourceUriPrefix'
         end
       end
@@ -1761,6 +1806,15 @@ module Google
         end
       end
       
+      class ListRowAccessPoliciesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :row_access_policies, as: 'rowAccessPolicies', class: Google::Apis::BigqueryV2::RowAccessPolicy, decorator: Google::Apis::BigqueryV2::RowAccessPolicy::Representation
+      
+        end
+      end
+      
       class LocationMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2062,6 +2116,18 @@ module Google
         end
       end
       
+      class RowAccessPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :creation_time, as: 'creationTime'
+          property :etag, as: 'etag'
+          property :filter_predicate, as: 'filterPredicate'
+          property :last_modified_time, as: 'lastModifiedTime'
+          property :row_access_policy_reference, as: 'rowAccessPolicyReference', class: Google::Apis::BigqueryV2::RowAccessPolicyReference, decorator: Google::Apis::BigqueryV2::RowAccessPolicyReference::Representation
+      
+        end
+      end
+      
       class RowAccessPolicyReference
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2438,6 +2504,8 @@ module Google
       
           property :evaluation_metrics, as: 'evaluationMetrics', class: Google::Apis::BigqueryV2::EvaluationMetrics, decorator: Google::Apis::BigqueryV2::EvaluationMetrics::Representation
       
+          collection :global_explanations, as: 'globalExplanations', class: Google::Apis::BigqueryV2::GlobalExplanation, decorator: Google::Apis::BigqueryV2::GlobalExplanation::Representation
+      
           collection :results, as: 'results', class: Google::Apis::BigqueryV2::IterationResult, decorator: Google::Apis::BigqueryV2::IterationResult::Representation
       
           property :start_time, as: 'startTime'