google-api-client 0.18.0 → 0.18.1

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

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TimeSpan
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Volume
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -195,6 +201,8 @@ module Google
           hash :substitutions, as: 'substitutions'
           collection :tags, as: 'tags'
           property :timeout, as: 'timeout'
+          hash :timing, as: 'timing', class: Google::Apis::CloudbuildV1::TimeSpan, decorator: Google::Apis::CloudbuildV1::TimeSpan::Representation
+      
         end
       end
       
@@ -228,6 +236,8 @@ module Google
           property :id, as: 'id'
           property :name, as: 'name'
           collection :secret_env, as: 'secretEnv'
+          property :timing, as: 'timing', class: Google::Apis::CloudbuildV1::TimeSpan, decorator: Google::Apis::CloudbuildV1::TimeSpan::Representation
+      
           collection :volumes, as: 'volumes', class: Google::Apis::CloudbuildV1::Volume, decorator: Google::Apis::CloudbuildV1::Volume::Representation
       
           collection :wait_for, as: 'waitFor'
@@ -255,6 +265,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :digest, as: 'digest'
           property :name, as: 'name'
+          property :push_timing, as: 'pushTiming', class: Google::Apis::CloudbuildV1::TimeSpan, decorator: Google::Apis::CloudbuildV1::TimeSpan::Representation
+      
         end
       end
       
@@ -405,6 +417,14 @@ module Google
         end
       end
       
+      class TimeSpan
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+        end
+      end
+      
       class Volume
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/cloudfunctions_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/functions
     module CloudfunctionsV1
       VERSION = 'V1'
-      REVISION = '20171101'
+      REVISION = '20171206'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -199,20 +199,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The type of event to observe. For example:
-        # `google.storage.object.finalized` and
-        # `google.firebase.analytics.event.log`.
-        # Event type consists of three parts:
-        # 1. namespace: The domain name of the organization in reverse-domain
-        # notation (e.g. `acme.net` appears as `net.acme`) and any orginization
-        # specific subdivisions. If the organization's top-level domain is `com`,
-        # the top-level domain is ommited (e.g. `google.com` appears as
-        # `google`). For example, `google.storage` and
+        # `providers/cloud.storage/eventTypes/object.change` and
+        # `providers/cloud.pubsub/eventTypes/topic.publish`.
+        # Event types match pattern `providers/*/eventTypes/*.*`.
+        # The pattern contains:
+        # 1. namespace: For example, `cloud.storage` and
         # `google.firebase.analytics`.
-        # 2. resource type: The type of resource on which event ocurs. For
+        # 2. resource type: The type of resource on which event occurs. For
         # example, the Google Cloud Storage API includes the type `object`.
-        # 3. action: The action that generates the event. For example, actions for
-        # a Google Cloud Storage Object include 'finalize' and 'delete'.
-        # These parts are lower case and joined by '.'.
+        # 3. action: The action that generates the event. For example, action for
+        # a Google Cloud Storage Object is 'change'.
+        # These parts are lower case.
         # Corresponds to the JSON property `eventType`
         # @return [String]
         attr_accessor :event_type

data/generated/google/apis/cloudresourcemanager_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV1
       VERSION = 'V1'
-      REVISION = '20171206'
+      REVISION = '20171211'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -318,6 +318,14 @@ module Google
       class Constraint
         include Google::Apis::Core::Hashable
       
+        # A `Constraint` that is either enforced or not.
+        # For example a constraint `constraints/compute.disableSerialPortAccess`.
+        # If it is enforced on a VM instance, serial port connections will not be
+        # opened to that instance.
+        # Corresponds to the JSON property `booleanConstraint`
+        # @return [Google::Apis::CloudresourcemanagerV1::BooleanConstraint]
+        attr_accessor :boolean_constraint
+      
         # The evaluation behavior of this constraint in the absense of 'Policy'.
         # Corresponds to the JSON property `constraintDefault`
         # @return [String]
@@ -359,6 +367,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @boolean_constraint = args[:boolean_constraint] if args.key?(:boolean_constraint)
           @constraint_default = args[:constraint_default] if args.key?(:constraint_default)
           @description = args[:description] if args.key?(:description)
           @display_name = args[:display_name] if args.key?(:display_name)
@@ -1066,6 +1075,21 @@ module Google
         # @return [Google::Apis::CloudresourcemanagerV1::ListPolicy]
         attr_accessor :list_policy
       
+        # Ignores policies set above this resource and restores the
+        # `constraint_default` enforcement behavior of the specific `Constraint` at
+        # this resource.
+        # Suppose that `constraint_default` is set to `ALLOW` for the
+        # `Constraint` `constraints/serviceuser.services`. Suppose that organization
+        # foo.com sets a `Policy` at their Organization resource node that restricts
+        # the allowed service activations to deny all service activations. They
+        # could then set a `Policy` with the `policy_type` `restore_default` on
+        # several experimental projects, restoring the `constraint_default`
+        # enforcement of the `Constraint` for only those projects, allowing those
+        # projects to have all services activated.
+        # Corresponds to the JSON property `restoreDefault`
+        # @return [Google::Apis::CloudresourcemanagerV1::RestoreDefault]
+        attr_accessor :restore_default
+      
         # The time stamp the `Policy` was previously updated. This is set by the
         # server, not specified by the caller, and represents the last time a call to
         # `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
@@ -1089,6 +1113,7 @@ module Google
           @constraint = args[:constraint] if args.key?(:constraint)
           @etag = args[:etag] if args.key?(:etag)
           @list_policy = args[:list_policy] if args.key?(:list_policy)
+          @restore_default = args[:restore_default] if args.key?(:restore_default)
           @update_time = args[:update_time] if args.key?(:update_time)
           @version = args[:version] if args.key?(:version)
         end

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

@@ -331,6 +331,8 @@ module Google
       class Constraint
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :boolean_constraint, as: 'booleanConstraint', class: Google::Apis::CloudresourcemanagerV1::BooleanConstraint, decorator: Google::Apis::CloudresourcemanagerV1::BooleanConstraint::Representation
+      
           property :constraint_default, as: 'constraintDefault'
           property :description, as: 'description'
           property :display_name, as: 'displayName'
@@ -501,6 +503,8 @@ module Google
           property :etag, :base64 => true, as: 'etag'
           property :list_policy, as: 'listPolicy', class: Google::Apis::CloudresourcemanagerV1::ListPolicy, decorator: Google::Apis::CloudresourcemanagerV1::ListPolicy::Representation
       
+          property :restore_default, as: 'restoreDefault', class: Google::Apis::CloudresourcemanagerV1::RestoreDefault, decorator: Google::Apis::CloudresourcemanagerV1::RestoreDefault::Representation
+      
           property :update_time, as: 'updateTime'
           property :version, as: 'version'
         end

data/generated/google/apis/cloudresourcemanager_v1/service.rb

@@ -1080,7 +1080,11 @@ module Google
         
         # Lists Projects that are visible to the user and satisfy the
         # specified filter. This method returns Projects in an unspecified order.
-        # New Projects do not necessarily appear at the end of the list.
+        # This method is eventually consistent with project mutations; this means
+        # that a newly created project may not appear in the results or recent
+        # updates to an existing project may not be reflected in the results. To
+        # retrieve the latest state of a project, use the
+        # GetProject method.
         # @param [String] filter
         #   An expression for filtering the results of the request.  Filter rules are
         #   case insensitive. The fields eligible for filtering are:
@@ -1211,7 +1215,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM access control policy for the specified Project. Replaces
+        # Sets the IAM access control policy for the specified Project. Overwrites
         # any existing policy.
         # The following constraints apply when using `setIamPolicy()`:
         # + Project does not support `allUsers` and `allAuthenticatedUsers` as
@@ -1235,7 +1239,8 @@ module Google
         # projects that no longer have owners who have accepted the ToS. Edits to
         # IAM policies will be rejected until the lack of a ToS-accepting owner is
         # rectified.
-        # + Calling this method requires enabling the App Engine Admin API.
+        # + This method will replace the existing policy, and cannot be used to
+        # append additional IAM settings.
         # Note: Removing service accounts from policies or changing their roles
         # can render services completely inoperable. It is important to understand
         # how the service account is being used before removing or updating its

data/generated/google/apis/cloudresourcemanager_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20170821'
+      REVISION = '20171211'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb

@@ -468,7 +468,10 @@ module Google
         
         # Lists Projects that are visible to the user and satisfy the
         # specified filter. This method returns Projects in an unspecified order.
-        # New Projects do not necessarily appear at the end of the list.
+        # This method is eventually consistent with project mutations; this means
+        # that a newly created project may not appear in the results or recent
+        # updates to an existing project may not be reflected in the results. To
+        # retrieve the latest state of a project, use the GetProjectmethod.
         # @param [String] filter
         #   An expression for filtering the results of the request.  Filter rules are
         #   case insensitive. The fields eligible for filtering are:
@@ -533,7 +536,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM access control policy for the specified Project. Replaces
+        # Sets the IAM access control policy for the specified Project. Overwrites
         # any existing policy.
         # The following constraints apply when using `setIamPolicy()`:
         # + Project does not support `allUsers` and `allAuthenticatedUsers` as
@@ -556,7 +559,8 @@ module Google
         # projects that no longer have owners who have accepted the ToS. Edits to
         # IAM policies will be rejected until the lack of a ToS-accepting owner is
         # rectified.
-        # + Calling this method requires enabling the App Engine Admin API.
+        # + This method will replace the existing policy, and cannot be used to
+        # append additional IAM settings.
         # Note: Removing service accounts from policies or changing their roles
         # can render services completely inoperable. It is important to understand
         # how the service account is being used before removing or updating its

data/generated/google/apis/cloudresourcemanager_v2beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20170828'
+      REVISION = '20171211'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -202,7 +202,8 @@ module Google
       
         # Output only.  The lifecycle state of the folder.
         # Updates to the lifecycle_state must be performed via
-        # [DeleteFolder] and [UndeleteFolder].
+        # DeleteFolder and
+        # UndeleteFolder.
         # Corresponds to the JSON property `lifecycleState`
         # @return [String]
         attr_accessor :lifecycle_state
@@ -214,7 +215,8 @@ module Google
         attr_accessor :name
       
         # The Folder’s parent's resource name.
-        # Updates to the folder's parent must be performed via [MoveFolders].
+        # Updates to the folder's parent must be performed via
+        # MoveFolder.
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
@@ -583,13 +585,13 @@ module Google
         # lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR`
         # can be used along with the suffix wildcard symbol `*`.
         # Some example queries are:
-        # |Query|Description|
-        # |------|-----------|
+        # |Query | Description|
+        # |----- | -----------|
         # |displayName=Test*|Folders whose display name starts with "Test".|
         # |lifecycleState=ACTIVE|Folders whose lifecycleState is ACTIVE.|
         # |parent=folders/123|Folders whose parent is "folders/123".|
-        # |parent=folders/123 AND lifecycleState=ACTIVE|Active folders whose
-        # parent is "folders/123".|
+        # |parent=folders/123 AND lifecycleState=ACTIVE|Active folders whose parent is "
+        # folders/123".|
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query

data/generated/google/apis/cloudresourcemanager_v2beta1/service.rb

@@ -105,10 +105,12 @@ module Google
         end
         
         # Requests deletion of a Folder. The Folder is moved into the
-        # [DELETE_REQUESTED] state immediately, and is deleted approximately 30 days
-        # later. This method may only be called on an empty Folder in the [ACTIVE]
-        # state, where a Folder is empty if it doesn't contain any Folders or
-        # Projects in the [ACTIVE] state.
+        # DELETE_REQUESTED state
+        # immediately, and is deleted approximately 30 days later. This method may
+        # only be called on an empty Folder in the
+        # ACTIVE state, where a Folder is empty if
+        # it doesn't contain any Folders or Projects in the
+        # ACTIVE state.
         # The caller must have `resourcemanager.folders.delete` permission on the
         # identified folder.
         # @param [String] name
@@ -235,8 +237,9 @@ module Google
         #   Access to this method is controlled by checking the
         #   `resourcemanager.folders.list` permission on the `parent`.
         # @param [Boolean] show_deleted
-        #   Controls whether Folders in the [DELETE_REQUESTED` state should
-        #   be returned.
+        #   Controls whether Folders in the
+        #   DELETE_REQUESTED
+        #   state should be returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -280,7 +283,8 @@ module Google
         # In addition, the Operation.metadata field will be populated with a
         # FolderOperation message as an aid to stateless clients.
         # Folder moves will be rejected if they violate either the naming, height
-        # or fanout constraints described in the [CreateFolder] documentation.
+        # or fanout constraints described in the
+        # CreateFolder documentation.
         # The caller must have `resourcemanager.folders.move` permission on the
         # folder's current and proposed new parent.
         # @param [String] name
@@ -318,9 +322,9 @@ module Google
         
         # Updates a Folder, changing its display_name.
         # Changes to the folder display_name will be rejected if they violate either
-        # the display_name formatting rules or naming constraints described in
-        # the [CreateFolder] documentation.
-        # + The Folder's display name must start and end with a letter or digit,
+        # the display_name formatting rules or naming constraints described in the
+        # CreateFolder documentation.
+        # The Folder's display name must start and end with a letter or digit,
         # may contain letters, digits, spaces, hyphens and underscores and can be
         # no longer than 30 characters. This is captured by the regular expression:
         # [\p`L`\p`N`](`\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?.
@@ -476,11 +480,13 @@ module Google
         end
         
         # Cancels the deletion request for a Folder. This method may only be
-        # called on a Folder in the [DELETE_REQUESTED] state.
-        # In order to succeed, the Folder's parent must be in the [ACTIVE] state.
+        # called on a Folder in the
+        # DELETE_REQUESTED state.
+        # In order to succeed, the Folder's parent must be in the
+        # ACTIVE state.
         # In addition, reintroducing the folder into the tree must not violate
         # folder naming, height and fanout constraints described in the
-        # [CreateFolder] documentation.
+        # CreateFolder documentation.
         # The caller must have `resourcemanager.folders.undelete` permission on the
         # identified folder.
         # @param [String] name

data/generated/google/apis/cloudshell_v1.rb

@@ -0,0 +1,35 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/cloudshell_v1/service.rb'
+require 'google/apis/cloudshell_v1/classes.rb'
+require 'google/apis/cloudshell_v1/representations.rb'
+
+module Google
+  module Apis
+    # Cloud Shell API
+    #
+    # Allows users to start, configure, and connect to interactive shell sessions
+    # running in the cloud.
+    #
+    # @see https://cloud.google.com/shell/docs/
+    module CloudshellV1
+      VERSION = 'V1'
+      REVISION = '20171211'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+    end
+  end
+end

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

@@ -0,0 +1,409 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudshellV1
+      
+      # The request message for Operations.CancelOperation.
+      class CancelOperationRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      # service Foo `
+      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `
+      # The JSON representation for `Empty` is empty JSON object ````.
+      class Empty
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A Cloud Shell environment, which is defined as the combination of a Docker
+      # image specifying what is installed on the environment and a home directory
+      # containing the user's data that will remain across sessions. Each user has a
+      # single environment with the ID "default".
+      class Environment
+        include Google::Apis::Core::Hashable
+      
+        # Required. Full path to the Docker image used to run this environment, e.g.
+        # "gcr.io/dev-con/cloud-devshell:latest".
+        # Corresponds to the JSON property `dockerImage`
+        # @return [String]
+        attr_accessor :docker_image
+      
+        # Output only. The environment's identifier, which is always "default".
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Output only. Full name of this resource, in the format
+        # `users/`owner_email`/environments/`environment_id``. ``owner_email`` is the
+        # email address of the user to whom this environment belongs, and
+        # ``environment_id`` is the identifier of this environment. For example,
+        # `users/someone@example.com/environments/default`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. Public keys associated with the environment. Clients can
+        # connect to this environment via SSH only if they possess a private key
+        # corresponding to at least one of these public keys. Keys can be added to or
+        # removed from the environment using the CreatePublicKey and DeletePublicKey
+        # methods.
+        # Corresponds to the JSON property `publicKeys`
+        # @return [Array<Google::Apis::CloudshellV1::PublicKey>]
+        attr_accessor :public_keys
+      
+        # Output only. Host to which clients can connect to initiate SSH sessions
+        # with the environment.
+        # Corresponds to the JSON property `sshHost`
+        # @return [String]
+        attr_accessor :ssh_host
+      
+        # Output only. Port to which clients can connect to initiate SSH sessions
+        # with the environment.
+        # Corresponds to the JSON property `sshPort`
+        # @return [Fixnum]
+        attr_accessor :ssh_port
+      
+        # Output only. Username that clients should use when initiating SSH sessions
+        # with the environment.
+        # Corresponds to the JSON property `sshUsername`
+        # @return [String]
+        attr_accessor :ssh_username
+      
+        # Output only. Current execution state of this environment.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @docker_image = args[:docker_image] if args.key?(:docker_image)
+          @id = args[:id] if args.key?(:id)
+          @name = args[:name] if args.key?(:name)
+          @public_keys = args[:public_keys] if args.key?(:public_keys)
+          @ssh_host = args[:ssh_host] if args.key?(:ssh_host)
+          @ssh_port = args[:ssh_port] if args.key?(:ssh_port)
+          @ssh_username = args[:ssh_username] if args.key?(:ssh_username)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # The response message for Operations.ListOperations.
+      class ListOperationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The standard List next-page token.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A list of operations that matches the specified filter in the request.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::CloudshellV1::Operation>]
+        attr_accessor :operations
+      
+        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)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      end
+      
+      # This resource represents a long-running operation that is the result of a
+      # network API call.
+      class Operation
+        include Google::Apis::Core::Hashable
+      
+        # If the value is `false`, it means the operation is still in progress.
+        # If `true`, the operation is completed, and either `error` or `response` is
+        # available.
+        # Corresponds to the JSON property `done`
+        # @return [Boolean]
+        attr_accessor :done
+        alias_method :done?, :done
+      
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by
+        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        # # Overview
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` that can be used for common error conditions.
+        # # Language mapping
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        # # Other uses
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        # Example uses of this error model include:
+        # - Partial errors. If a service needs to return partial errors to the client,
+        # it may embed the `Status` in the normal response to indicate the partial
+        # errors.
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        # have a `Status` message for error reporting.
+        # - Batch operations. If a client uses batch request and batch response, the
+        # `Status` message should be used directly inside batch response, one for
+        # each error sub-response.
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        # results in its response, the status of those operations should be
+        # represented directly using the `Status` message.
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        # be used directly after any stripping needed for security/privacy reasons.
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::CloudshellV1::Status]
+        attr_accessor :error
+      
+        # Service-specific metadata associated with the operation.  It typically
+        # contains progress information and common metadata such as create time.
+        # Some services might not provide such metadata.  Any method that returns a
+        # long-running operation should document the metadata type, if any.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the
+        # `name` should have the format of `operations/some/unique/name`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The normal response of the operation in case of success.  If the original
+        # method returns no data on success, such as `Delete`, the response is
+        # `google.protobuf.Empty`.  If the original method is standard
+        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # is the original method name.  For example, if the original method name
+        # is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
+        # Corresponds to the JSON property `response`
+        # @return [Hash<String,Object>]
+        attr_accessor :response
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @done = args[:done] if args.key?(:done)
+          @error = args[:error] if args.key?(:error)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @response = args[:response] if args.key?(:response)
+        end
+      end
+      
+      # A public SSH key, corresponding to a private SSH key held by the client.
+      class PublicKey
+        include Google::Apis::Core::Hashable
+      
+        # Required. Format of this key's content.
+        # Corresponds to the JSON property `format`
+        # @return [String]
+        attr_accessor :format
+      
+        # Required. Content of this key.
+        # Corresponds to the JSON property `key`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :key
+      
+        # Output only. Full name of this resource, in the format
+        # `users/`owner_email`/environments/`environment_id`/publicKeys/`key_id``.
+        # ``owner_email`` is the email address of the user to whom the key belongs.
+        # ``environment_id`` is the identifier of the environment to which the key
+        # grants access. ``key_id`` is the unique identifier of the key. For example,
+        # `users/someone@example.com/environments/default/publicKeys/myKey`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @format = args[:format] if args.key?(:format)
+          @key = args[:key] if args.key?(:key)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Message included in the metadata field of operations returned from
+      # StartEnvironment.
+      class StartEnvironmentMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Current state of the environment being started.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Message included in the response field of operations returned from
+      # StartEnvironment once the
+      # operation is complete.
+      class StartEnvironmentResponse
+        include Google::Apis::Core::Hashable
+      
+        # A Cloud Shell environment, which is defined as the combination of a Docker
+        # image specifying what is installed on the environment and a home directory
+        # containing the user's data that will remain across sessions. Each user has a
+        # single environment with the ID "default".
+        # Corresponds to the JSON property `environment`
+        # @return [Google::Apis::CloudshellV1::Environment]
+        attr_accessor :environment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @environment = args[:environment] if args.key?(:environment)
+        end
+      end
+      
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by
+      # [gRPC](https://github.com/grpc). The error model is designed to be:
+      # - Simple to use and understand for most users
+      # - Flexible enough to meet unexpected needs
+      # # Overview
+      # The `Status` message contains three pieces of data: error code, error message,
+      # and error details. The error code should be an enum value of
+      # google.rpc.Code, but it may accept additional error codes if needed.  The
+      # error message should be a developer-facing English message that helps
+      # developers *understand* and *resolve* the error. If a localized user-facing
+      # error message is needed, put the localized message in the error details or
+      # localize it in the client. The optional error details may contain arbitrary
+      # information about the error. There is a predefined set of error detail types
+      # in the package `google.rpc` that can be used for common error conditions.
+      # # Language mapping
+      # The `Status` message is the logical representation of the error model, but it
+      # is not necessarily the actual wire format. When the `Status` message is
+      # exposed in different client libraries and different wire protocols, it can be
+      # mapped differently. For example, it will likely be mapped to some exceptions
+      # in Java, but more likely mapped to some error codes in C.
+      # # Other uses
+      # The error model and the `Status` message can be used in a variety of
+      # environments, either with or without APIs, to provide a
+      # consistent developer experience across different environments.
+      # Example uses of this error model include:
+      # - Partial errors. If a service needs to return partial errors to the client,
+      # it may embed the `Status` in the normal response to indicate the partial
+      # errors.
+      # - Workflow errors. A typical workflow has multiple steps. Each step may
+      # have a `Status` message for error reporting.
+      # - Batch operations. If a client uses batch request and batch response, the
+      # `Status` message should be used directly inside batch response, one for
+      # each error sub-response.
+      # - Asynchronous operations. If an API call embeds asynchronous operation
+      # results in its response, the status of those operations should be
+      # represented directly using the `Status` message.
+      # - Logging. If some API errors are stored in logs, the message `Status` could
+      # be used directly after any stripping needed for security/privacy reasons.
+      class Status
+        include Google::Apis::Core::Hashable
+      
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # A list of messages that carry the error details.  There is a common set of
+        # message types for APIs to use.
+        # Corresponds to the JSON property `details`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :details
+      
+        # A developer-facing error message, which should be in English. Any
+        # user-facing error message should be localized and sent in the
+        # google.rpc.Status.details field, or localized by the client.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @details = args[:details] if args.key?(:details)
+          @message = args[:message] if args.key?(:message)
+        end
+      end
+    end
+  end
+end