classes.rb in google-api-client-0.21.0

- old
+ new

@@ -192,10 +192,11 @@
         # are one hour old. Because of this, Cloud Spanner cannot perform reads
         # at read timestamps more than one hour in the past. This
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `options`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :options
       
         def initialize(**args)
@@ -467,10 +468,11 @@
         # are one hour old. Because of this, Cloud Spanner cannot perform reads
         # at read timestamps more than one hour in the past. This
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `singleUseTransaction`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :single_use_transaction
       
         # Commit a previously-started transaction.
@@ -735,25 +737,25 @@
       
         # It is not always possible for Cloud Spanner to infer the right SQL type
         # from a JSON value.  For example, values of type `BYTES` and values
         # of type `STRING` both appear in params as JSON strings.
         # In these cases, `param_types` can be used to specify the exact
-        # SQL type for some or all of the SQL query parameters. See the
+        # SQL type for some or all of the SQL statement parameters. See the
         # definition of Type for more information
         # about SQL types.
         # Corresponds to the JSON property `paramTypes`
         # @return [Hash<String,Google::Apis::SpannerV1::Type>]
         attr_accessor :param_types
       
-        # The SQL query string can contain parameter placeholders. A parameter
+        # The SQL string can contain parameter placeholders. A parameter
         # placeholder consists of `'@'` followed by the parameter
         # name. Parameter names consist of any combination of letters,
         # numbers, and underscores.
         # Parameters can appear anywhere that a literal value is expected.  The same
         # parameter name can be used more than once, for example:
         # `"WHERE id > @msg_id AND id < @msg_id + 100"`
-        # It is an error to execute an SQL query with unbound parameters.
+        # It is an error to execute an SQL statement with unbound parameters.
         # Parameter values are specified using `params`, which is a JSON
         # object whose keys are parameter names, and whose values are the
         # corresponding parameter values.
         # Corresponds to the JSON property `params`
         # @return [Hash<String,Object>]
@@ -773,22 +775,22 @@
         # be set to QueryMode.NORMAL.
         # Corresponds to the JSON property `queryMode`
         # @return [String]
         attr_accessor :query_mode
       
-        # If this request is resuming a previously interrupted SQL query
+        # If this request is resuming a previously interrupted SQL statement
         # execution, `resume_token` should be copied from the last
         # PartialResultSet yielded before the interruption. Doing this
-        # enables the new SQL query execution to resume where the last one left
+        # enables the new SQL statement execution to resume where the last one left
         # off. The rest of the request parameters must exactly match the
         # request that yielded this token.
         # Corresponds to the JSON property `resumeToken`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :resume_token
       
-        # Required. The SQL query string.
+        # Required. The SQL string.
         # Corresponds to the JSON property `sql`
         # @return [String]
         attr_accessor :sql
       
         # This message is used to select the transaction in which a
@@ -1804,32 +1806,43 @@
         end
       end
       
       # Defines an Identity and Access Management (IAM) policy. It is used to
       # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
       # `members` to a `role`, where the members can be user accounts, Google groups,
       # Google domains, and service accounts. A `role` is a named list of permissions
       # defined by IAM.
-      # **Example**
+      # **JSON Example**
       # `
       # "bindings": [
       # `
       # "role": "roles/owner",
       # "members": [
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
       # "role": "roles/viewer",
       # "members": ["user:sean@example.com"]
       # `
       # ]
       # `
+      # **YAML Example**
+      # bindings:
+      # - members:
+      # - user:mike@example.com
+      # - group:admins@example.com
+      # - domain:google.com
+      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+      # role: roles/owner
+      # - members:
+      # - user:sean@example.com
+      # role: roles/viewer
       # For a description of IAM and its features, see the
       # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class Policy
         include Google::Apis::Core::Hashable
       
@@ -2239,32 +2252,43 @@
       class SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
         # Defines an Identity and Access Management (IAM) policy. It is used to
         # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
         # `members` to a `role`, where the members can be user accounts, Google groups,
         # Google domains, and service accounts. A `role` is a named list of permissions
         # defined by IAM.
-        # **Example**
+        # **JSON Example**
         # `
         # "bindings": [
         # `
         # "role": "roles/owner",
         # "members": [
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
         # "role": "roles/viewer",
         # "members": ["user:sean@example.com"]
         # `
         # ]
         # `
+        # **YAML Example**
+        # bindings:
+        # - members:
+        # - user:mike@example.com
+        # - group:admins@example.com
+        # - domain:google.com
+        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+        # role: roles/owner
+        # - members:
+        # - user:sean@example.com
+        # role: roles/viewer
         # For a description of IAM and its features, see the
         # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::SpannerV1::Policy]
         attr_accessor :policy
@@ -2648,10 +2672,11 @@
       # are one hour old. Because of this, Cloud Spanner cannot perform reads
       # at read timestamps more than one hour in the past. This
       # restriction also applies to in-progress reads and/or SQL queries whose
       # timestamp become too old while executing. Reads and SQL queries with
       # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+      # ##
       class TransactionOptions
         include Google::Apis::Core::Hashable
       
         # Message type to initiate a read-only transaction.
         # Corresponds to the JSON property `readOnly`
@@ -2848,10 +2873,11 @@
         # are one hour old. Because of this, Cloud Spanner cannot perform reads
         # at read timestamps more than one hour in the past. This
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `begin`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :begin
       
         # Execute the read or SQL query in a previously-started transaction.
@@ -3026,9 +3052,10 @@
         # are one hour old. Because of this, Cloud Spanner cannot perform reads
         # at read timestamps more than one hour in the past. This
         # restriction also applies to in-progress reads and/or SQL queries whose
         # timestamp become too old while executing. Reads and SQL queries with
         # too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+        # ##
         # Corresponds to the JSON property `singleUse`
         # @return [Google::Apis::SpannerV1::TransactionOptions]
         attr_accessor :single_use
       
         def initialize(**args)