google-api-client 0.9.8 → 0.10.2

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

@@ -660,6 +660,61 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Uploads the deobfuscation file of the specified APK. If a deobfuscation file
+        # already exists, it will be replaced.
+        # @param [String] package_name
+        #   Unique identifier of the Android app for which the deobfuscatiuon files are
+        #   being uploaded; for example, "com.spiffygame".
+        # @param [String] edit_id
+        #   Unique identifier for this edit.
+        # @param [Fixnum] apk_version_code
+        #   The version code of the APK whose deobfuscation file is being uploaded.
+        # @param [String] deobfuscation_file_type
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [IO, String] upload_source
+        #   IO stream or filename containing content to upload
+        # @param [String] content_type
+        #   Content type of the uploaded content.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AndroidpublisherV2::DeobfuscationFilesUploadResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidpublisherV2::DeobfuscationFilesUploadResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def upload_edit_deobfuscationfile(package_name, edit_id, apk_version_code, deobfuscation_file_type, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
+          if upload_source.nil?
+            command =  make_simple_command(:post, '{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}', options)
+          else
+            command = make_upload_command(:post, '{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}', options)
+            command.upload_source = upload_source
+            command.upload_content_type = content_type
+          end
+          command.response_representation = Google::Apis::AndroidpublisherV2::DeobfuscationFilesUploadResponse::Representation
+          command.response_class = Google::Apis::AndroidpublisherV2::DeobfuscationFilesUploadResponse
+          command.params['packageName'] = package_name unless package_name.nil?
+          command.params['editId'] = edit_id unless edit_id.nil?
+          command.params['apkVersionCode'] = apk_version_code unless apk_version_code.nil?
+          command.params['deobfuscationFileType'] = deobfuscation_file_type unless deobfuscation_file_type.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Fetches app details for this edit. This includes the default language and
         # developer support contact information.
         # @param [String] package_name
@@ -2325,11 +2380,66 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists the purchases that were cancelled, refunded or charged-back.
+        # @param [String] package_name
+        #   The package name of the application for which voided purchases need to be
+        #   returned (for example, 'com.some.thing').
+        # @param [String] end_time
+        #   The time, in milliseconds since the Epoch, of the newest voided in-app product
+        #   purchase that you want to see in the response. The value of this parameter
+        #   cannot be greater than the current time and is ignored if a pagination token
+        #   is set. Default value is current time.
+        # @param [Fixnum] max_results
+        # @param [Fixnum] start_index
+        # @param [String] start_time
+        #   The time, in milliseconds since the Epoch, of the oldest voided in-app product
+        #   purchase that you want to see in the response. The value of this parameter
+        #   cannot be older than 30 days and is ignored if a pagination token is set.
+        #   Default value is current time minus 30 days.
+        # @param [String] token
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AndroidpublisherV2::VoidedPurchasesListResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidpublisherV2::VoidedPurchasesListResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_purchase_voidedpurchases(package_name, end_time: nil, max_results: nil, start_index: nil, start_time: nil, token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, '{packageName}/purchases/voidedpurchases', options)
+          command.response_representation = Google::Apis::AndroidpublisherV2::VoidedPurchasesListResponse::Representation
+          command.response_class = Google::Apis::AndroidpublisherV2::VoidedPurchasesListResponse
+          command.params['packageName'] = package_name unless package_name.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['startIndex'] = start_index unless start_index.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['token'] = token unless token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns a single review.
         # @param [String] package_name
         #   Unique identifier for the Android app for which we want reviews; for example, "
         #   com.spiffygame".
         # @param [String] review_id
+        # @param [String] translation_language
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2351,25 +2461,27 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_review(package_name, review_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_review(package_name, review_id, translation_language: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, '{packageName}/reviews/{reviewId}', options)
           command.response_representation = Google::Apis::AndroidpublisherV2::Review::Representation
           command.response_class = Google::Apis::AndroidpublisherV2::Review
           command.params['packageName'] = package_name unless package_name.nil?
           command.params['reviewId'] = review_id unless review_id.nil?
+          command.query['translationLanguage'] = translation_language unless translation_language.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of reviews.
+        # Returns a list of reviews. Only reviews from last week will be returned.
         # @param [String] package_name
         #   Unique identifier for the Android app for which we want reviews; for example, "
         #   com.spiffygame".
         # @param [Fixnum] max_results
         # @param [Fixnum] start_index
         # @param [String] token
+        # @param [String] translation_language
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2391,7 +2503,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_reviews(package_name, max_results: nil, start_index: nil, token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_reviews(package_name, max_results: nil, start_index: nil, token: nil, translation_language: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, '{packageName}/reviews', options)
           command.response_representation = Google::Apis::AndroidpublisherV2::ReviewsListResponse::Representation
           command.response_class = Google::Apis::AndroidpublisherV2::ReviewsListResponse
@@ -2399,6 +2511,7 @@ module Google
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['startIndex'] = start_index unless start_index.nil?
           command.query['token'] = token unless token.nil?
+          command.query['translationLanguage'] = translation_language unless translation_language.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?

data/generated/google/apis/appengine_v1beta5.rb

@@ -25,10 +25,16 @@ module Google
     # @see https://cloud.google.com/appengine/docs/admin-api/
     module AppengineV1beta5
       VERSION = 'V1beta5'
-      REVISION = '20160407'
+      REVISION = '20170324'
+
+      # View and manage your applications deployed on Google App Engine
+      AUTH_APPENGINE_ADMIN = 'https://www.googleapis.com/auth/appengine.admin'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # View your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
     end
   end
 end

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

@@ -22,14 +22,39 @@ module Google
   module Apis
     module AppengineV1beta5
       
+      # The response message for Operations.ListOperations.
+      class ListOperationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of operations that matches the specified filter in the request.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::AppengineV1beta5::Operation>]
+        attr_accessor :operations
+      
+        # The standard List next-page token.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @operations = args[:operations] if args.key?(:operations)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        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
       
         # 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`.
+        # 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
@@ -42,56 +67,55 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
-        # 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.
+        # 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` which 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 purpose. - 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.
+        # 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
+        # needsOverviewThe 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 which can be used for common error conditions.Language mappingThe 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 usesThe 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 purpose. 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::AppengineV1beta5::Status]
         attr_accessor :error
       
         # 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`.
+        # 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
@@ -110,38 +134,37 @@ module Google
         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` which 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 purpose. - 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.
+      # 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
+      # needsOverviewThe 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 which can be used for common error conditions.Language mappingThe 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 usesThe 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 purpose. 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
       
@@ -175,93 +198,72 @@ module Google
         end
       end
       
-      # The response message for Operations.ListOperations.
-      class ListOperationsResponse
-        include Google::Apis::Core::Hashable
-      
-        # A list of operations that matches the specified filter in the request.
-        # Corresponds to the JSON property `operations`
-        # @return [Array<Google::Apis::AppengineV1beta5::Operation>]
-        attr_accessor :operations
-      
-        # The standard List next-page token.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @operations = args[:operations] if args.key?(:operations)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-        end
-      end
-      
-      # An Application contains the top-level configuration of an App Engine
+      # An Application resource contains the top-level configuration of an App Engine
       # application.
       class Application
         include Google::Apis::Core::Hashable
       
-        # The full path to the application in the API. Example: "apps/myapp". @
+        # Full path to the Application resource in the API. Example: apps/myapp.@
         # OutputOnly
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The relative name/path of the application. Example: "myapp".
+        # Identifier of the Application resource. This identifier is equivalent to the
+        # project ID of the Google Cloud Platform project where you want to deploy your
+        # application. Example: myapp.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # HTTP path dispatch rules for requests to the app that do not explicitly target
-        # a service or version. The rules are order-dependent. @OutputOnly
+        # HTTP path dispatch rules for requests to the application that do not
+        # explicitly target a service or version. Rules are order-dependent.@OutputOnly
         # Corresponds to the JSON property `dispatchRules`
         # @return [Array<Google::Apis::AppengineV1beta5::UrlDispatchRule>]
         attr_accessor :dispatch_rules
       
-        # If set, only users from the specified Google Apps authentication domain may
-        # access the application. If not set, any Google Account may access the
-        # application.
+        # Google Apps authentication domain that controls which users can access this
+        # application.Defaults to open access for any Google Account.
         # Corresponds to the JSON property `authDomain`
         # @return [String]
         attr_accessor :auth_domain
       
-        # The location from which the application will be run. Application instances
-        # will run out of data centers in the chosen location and all of the application'
-        # s End User Content will be stored at rest. The default is "us-central".
-        # Choices are: "us-central" - Central US "europe-west" - Western Europe "us-
-        # east1" - Eastern US
+        # Location from which this application will be run. Application instances will
+        # run out of data centers in the chosen location, which is also where all of the
+        # application's end user content is stored.Defaults to us-central.Options are:us-
+        # central - Central USeurope-west - Western Europeus-east1 - Eastern US
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # A Google Cloud Storage bucket which can be used for storing files associated
-        # with an application. This bucket is associated with the application and can be
-        # used by the gcloud deployment commands. @OutputOnly
+        # A Google Cloud Storage bucket that can be used for storing files associated
+        # with this application. This bucket is associated with the application and can
+        # be used by the gcloud deployment commands.@OutputOnly
         # Corresponds to the JSON property `codeBucket`
         # @return [String]
         attr_accessor :code_bucket
       
-        # Determines the cookie expiration policy for the application. @OutputOnly
+        # Cookie expiration policy for this application.
         # Corresponds to the JSON property `defaultCookieExpiration`
         # @return [String]
         attr_accessor :default_cookie_expiration
       
-        # The hostname used to reach the application, as resolved by App Engine. @
-        # OutputOnly
+        # Hostname used to reach the application, as resolved by App Engine.@OutputOnly
         # Corresponds to the JSON property `defaultHostname`
         # @return [String]
         attr_accessor :default_hostname
       
-        # A Google Cloud Storage bucket which can be used by the application to store
-        # content. @OutputOnly
+        # A Google Cloud Storage bucket that can be used by the application to store
+        # content.@OutputOnly
         # Corresponds to the JSON property `defaultBucket`
         # @return [String]
         attr_accessor :default_bucket
       
+        # Identity-Aware Proxy
+        # Corresponds to the JSON property `iap`
+        # @return [Google::Apis::AppengineV1beta5::IdentityAwareProxy]
+        attr_accessor :iap
+      
         def initialize(**args)
            update!(**args)
         end
@@ -277,6 +279,7 @@ module Google
           @default_cookie_expiration = args[:default_cookie_expiration] if args.key?(:default_cookie_expiration)
           @default_hostname = args[:default_hostname] if args.key?(:default_hostname)
           @default_bucket = args[:default_bucket] if args.key?(:default_bucket)
+          @iap = args[:iap] if args.key?(:iap)
         end
       end
       
@@ -284,21 +287,21 @@ module Google
       class UrlDispatchRule
         include Google::Apis::Core::Hashable
       
-        # The domain name to match on. Supports '*' (glob) wildcarding on the left-hand
-        # side of a '.'. If empty, all domains will be matched (the same as '*').
+        # Domain name to match against. The wildcard "*" is supported if specified
+        # before a period: "*.".Defaults to matching all domains: "*".
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
       
-        # The pathname within the host. This must start with a '/'. A single '*' (glob)
-        # can be included at the end of the path. The sum of the lengths of the domain
-        # and path may not exceed 100 characters.
+        # Pathname within the host. Must start with a "/". A single "*" can be included
+        # at the end of the path. The sum of the lengths of the domain and path may not
+        # exceed 100 characters.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
       
-        # The resource id of a Service in this application that should service the
-        # matched request. The Service must already exist. Example: "default".
+        # Resource id of a service in this application that should serve the matched
+        # request. The service must already exist. Example: default.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -315,27 +318,67 @@ module Google
         end
       end
       
-      # A Version is a specific set of source code and configuration files deployed to
-      # a service.
+      # Identity-Aware Proxy
+      class IdentityAwareProxy
+        include Google::Apis::Core::Hashable
+      
+        # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests.If true, the oauth2_client_id and oauth2_client_secret
+        # fields must be non-empty.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # OAuth2 client ID to use for the authentication flow.
+        # Corresponds to the JSON property `oauth2ClientId`
+        # @return [String]
+        attr_accessor :oauth2_client_id
+      
+        # For security reasons, this value cannot be retrieved via the API. Instead, the
+        # SHA-256 hash of the value is returned in the oauth2_client_secret_sha256 field.
+        # @InputOnly
+        # Corresponds to the JSON property `oauth2ClientSecret`
+        # @return [String]
+        attr_accessor :oauth2_client_secret
+      
+        # Hex-encoded SHA-256 hash of the client secret.@OutputOnly
+        # Corresponds to the JSON property `oauth2ClientSecretSha256`
+        # @return [String]
+        attr_accessor :oauth2_client_secret_sha256
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @oauth2_client_id = args[:oauth2_client_id] if args.key?(:oauth2_client_id)
+          @oauth2_client_secret = args[:oauth2_client_secret] if args.key?(:oauth2_client_secret)
+          @oauth2_client_secret_sha256 = args[:oauth2_client_secret_sha256] if args.key?(:oauth2_client_secret_sha256)
+        end
+      end
+      
+      # A Version resource is a specific set of source code and configuration files
+      # that are deployed into a service.
       class Version
         include Google::Apis::Core::Hashable
       
-        # The full path to the Version resource in the API. Example: "apps/myapp/
-        # services/default/versions/v1". @OutputOnly
+        # Full path to the Version resource in the API. Example: apps/myapp/services/
+        # default/versions/v1.@OutputOnly
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The relative name/path of the Version within the service. Example: "v1".
-        # Version specifiers can contain lowercase letters, digits, and hyphens. It
-        # cannot begin with the prefix `ah-` and the names `default` and `latest` are
-        # reserved and cannot be used.
+        # Relative name of the version within the module. Example: v1. Version names can
+        # contain only lowercase letters, numbers, or hyphens. Reserved names: "default",
+        # "latest", and any name with the prefix "ah-".
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Automatic scaling is the scaling policy that App Engine has used since its
-        # inception. It is based on request rate, response latencies, and other
+        # Automatic scaling is based on request rate, response latencies, and other
         # application metrics.
         # Corresponds to the JSON property `automaticScaling`
         # @return [Google::Apis::AppengineV1beta5::AutomaticScaling]
@@ -361,125 +404,123 @@ module Google
         # @return [Array<String>]
         attr_accessor :inbound_services
       
-        # The instance class to use to run this app. Valid values for AutomaticScaling
-        # are `[F1, F2, F4, F4_1G]`. Valid values for ManualScaling and BasicScaling are
-        # `[B1, B2, B4, B8, B4_1G]`. Default: "F1" for AutomaticScaling, "B1" for
-        # ManualScaling and BasicScaling
+        # Instance class that is used to run this version. Valid values are:
+        # AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4,
+        # B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or
+        # BasicScaling.
         # Corresponds to the JSON property `instanceClass`
         # @return [String]
         attr_accessor :instance_class
       
-        # Used to specify extra network settings (for VM runtimes only).
+        # Extra network settings. Only applicable for VM runtimes.
         # Corresponds to the JSON property `network`
         # @return [Google::Apis::AppengineV1beta5::Network]
         attr_accessor :network
       
-        # Used to specify how many machine resources an app version needs.
+        # Machine resources for a version.
         # Corresponds to the JSON property `resources`
         # @return [Google::Apis::AppengineV1beta5::Resources]
         attr_accessor :resources
       
-        # The desired runtime. Values can include python27, java7, go, etc.
+        # Desired runtime. Example: python27.
         # Corresponds to the JSON property `runtime`
         # @return [String]
         attr_accessor :runtime
       
-        # If true, multiple requests can be dispatched to the app at once.
+        # Whether multiple requests can be dispatched to this version at once.
         # Corresponds to the JSON property `threadsafe`
         # @return [Boolean]
         attr_accessor :threadsafe
         alias_method :threadsafe?, :threadsafe
       
-        # Whether to deploy this app in a VM container.
+        # Whether to deploy this version in a container on a virtual machine.
         # Corresponds to the JSON property `vm`
         # @return [Boolean]
         attr_accessor :vm
         alias_method :vm?, :vm
       
-        # Beta settings supplied to the application via metadata.
+        # Metadata settings that are supplied to this version to enable beta runtime
+        # features.
         # Corresponds to the JSON property `betaSettings`
         # @return [Hash<String,String>]
         attr_accessor :beta_settings
       
-        # The App Engine execution environment to use for this version. Default: "1"
+        # App Engine execution environment to use for this version.Defaults to 1.
         # Corresponds to the JSON property `env`
         # @return [String]
         attr_accessor :env
       
-        # The current serving status of this version. Only `SERVING` versions will have
-        # instances created or billed for. If this field is unset when a version is
-        # created, `SERVING` status will be assumed. It is an error to explicitly set
-        # this field to `SERVING_STATUS_UNSPECIFIED`.
+        # Current serving status of this version. Only the versions with a SERVING
+        # status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an
+        # invalid value. Defaults to SERVING.
         # Corresponds to the JSON property `servingStatus`
         # @return [String]
         attr_accessor :serving_status
       
-        # The email address of the user who created this version. @OutputOnly
+        # Email address of the user who created this version.@OutputOnly
         # Corresponds to the JSON property `deployer`
         # @return [String]
         attr_accessor :deployer
       
-        # Creation time of this version. This will be between the start and end times of
-        # the operation that creates this version. @OutputOnly
+        # Time that this version was created.@OutputOnly
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+        # Total size of version files hosted on App Engine disk in bytes.@OutputOnly
         # Corresponds to the JSON property `diskUsageBytes`
         # @return [String]
         attr_accessor :disk_usage_bytes
       
-        # An ordered list of URL Matching patterns that should be applied to incoming
-        # requests. The first matching URL consumes the request, and subsequent handlers
-        # are not attempted. Only returned in `GET` requests if `view=FULL` is set. May
-        # only be set on create requests; once created, is immutable.
+        # An ordered list of URL-matching patterns that should be applied to incoming
+        # requests. The first matching URL handles the request and other request
+        # handlers are not attempted.Only returned in GET requests if view=FULL is set.
         # Corresponds to the JSON property `handlers`
         # @return [Array<Google::Apis::AppengineV1beta5::UrlMap>]
         attr_accessor :handlers
       
-        # Custom static error pages instead of these generic error pages, (limit 10 KB/
-        # page) Only returned in `GET` requests if `view=FULL` is set. May only be set
-        # on create requests; once created, is immutable.
+        # Custom static error pages. Limited to 10KB per page.Only returned in GET
+        # requests if view=FULL is set.
         # Corresponds to the JSON property `errorHandlers`
         # @return [Array<Google::Apis::AppengineV1beta5::ErrorHandler>]
         attr_accessor :error_handlers
       
-        # Configuration for Python runtime third-party libraries required by the
-        # application. Only returned in `GET` requests if `view=FULL` is set. May only
-        # be set on create requests; once created, is immutable.
+        # Configuration for third-party Python runtime libraries required by the
+        # application.Only returned in GET requests if view=FULL is set.
         # Corresponds to the JSON property `libraries`
         # @return [Array<Google::Apis::AppengineV1beta5::Library>]
         attr_accessor :libraries
       
-        # API Serving configuration for Cloud Endpoints.
+        # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/
+        # endpoints/) configuration for API handlers.
         # Corresponds to the JSON property `apiConfig`
         # @return [Google::Apis::AppengineV1beta5::ApiConfigHandler]
         attr_accessor :api_config
       
-        # Environment variables made available to the application. Only returned in `GET`
-        # requests if `view=FULL` is set. May only be set on create requests; once
-        # created, is immutable.
+        # Environment variables made available to the application.Only returned in GET
+        # requests if view=FULL is set.
         # Corresponds to the JSON property `envVariables`
         # @return [Hash<String,String>]
         attr_accessor :env_variables
       
-        # The length of time a static file served by a static file handler ought to be
-        # cached by web proxies and browsers, if the handler does not specify its own
-        # expiration. Only returned in `GET` requests if `view=FULL` is set. May only be
-        # set on create requests; once created, is immutable.
+        # Duration that static files should be cached by web proxies and browsers. Only
+        # applicable if the corresponding StaticFilesHandler (https://cloud.google.com/
+        # appengine/docs/admin-api/reference/rest/v1/apps.services.versions#
+        # staticfileshandler) does not specify its own expiration time.Only returned in
+        # GET requests if view=FULL is set.
         # Corresponds to the JSON property `defaultExpiration`
         # @return [String]
         attr_accessor :default_expiration
       
-        # Configure health checking for the VM instances. Unhealthy VM instances will be
-        # killed and replaced with new instances.
+        # Health checking configuration for VM instances. Unhealthy instances are killed
+        # and replaced with new instances. Only applicable for instances in App Engine
+        # flexible environment.
         # Corresponds to the JSON property `healthCheck`
         # @return [Google::Apis::AppengineV1beta5::HealthCheck]
         attr_accessor :health_check
       
-        # Go only. Files that match this pattern will not be built into the app. May
-        # only be set on create requests.
+        # Files that match this pattern will not be built into this version. Only
+        # applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
         # Corresponds to the JSON property `nobuildFilesRegex`
         # @return [String]
         attr_accessor :nobuild_files_regex
@@ -489,6 +530,15 @@ module Google
         # @return [Google::Apis::AppengineV1beta5::Deployment]
         attr_accessor :deployment
       
+        # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The
+        # Endpoints API Service provides tooling for serving Open API and gRPC endpoints
+        # via an NGINX proxy.The fields here refer to the name and configuration id of a
+        # "service" resource in the Service Management API (https://cloud.google.com/
+        # service-management/overview).
+        # Corresponds to the JSON property `endpointsApiService`
+        # @return [Google::Apis::AppengineV1beta5::EndpointsApiService]
+        attr_accessor :endpoints_api_service
+      
         def initialize(**args)
            update!(**args)
         end
@@ -522,18 +572,18 @@ module Google
           @health_check = args[:health_check] if args.key?(:health_check)
           @nobuild_files_regex = args[:nobuild_files_regex] if args.key?(:nobuild_files_regex)
           @deployment = args[:deployment] if args.key?(:deployment)
+          @endpoints_api_service = args[:endpoints_api_service] if args.key?(:endpoints_api_service)
         end
       end
       
-      # Automatic scaling is the scaling policy that App Engine has used since its
-      # inception. It is based on request rate, response latencies, and other
+      # Automatic scaling is based on request rate, response latencies, and other
       # application metrics.
       class AutomaticScaling
         include Google::Apis::Core::Hashable
       
-        # The amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/
+        # Amount of time that the Autoscaler (https://cloud.google.com/compute/docs/
         # autoscaler/) should wait between changes to the number of virtual machines.
-        # Applies only to the VM runtime.
+        # Only applicable for VM runtimes.
         # Corresponds to the JSON property `coolDownPeriod`
         # @return [String]
         attr_accessor :cool_down_period
@@ -543,59 +593,56 @@ module Google
         # @return [Google::Apis::AppengineV1beta5::CpuUtilization]
         attr_accessor :cpu_utilization
       
-        # The number of concurrent requests an automatic scaling instance can accept
-        # before the scheduler spawns a new instance. Default value is chosen based on
-        # the runtime.
+        # Number of concurrent requests an automatic scaling instance can accept before
+        # the scheduler spawns a new instance.Defaults to a runtime-specific value.
         # Corresponds to the JSON property `maxConcurrentRequests`
         # @return [Fixnum]
         attr_accessor :max_concurrent_requests
       
-        # The maximum number of idle instances that App Engine should maintain for this
-        # version.
+        # Maximum number of idle instances that should be maintained for this version.
         # Corresponds to the JSON property `maxIdleInstances`
         # @return [Fixnum]
         attr_accessor :max_idle_instances
       
-        # Max number of instances that App Engine should start to handle requests.
+        # Maximum number of instances that should be started to handle requests.
         # Corresponds to the JSON property `maxTotalInstances`
         # @return [Fixnum]
         attr_accessor :max_total_instances
       
-        # The maximum amount of time that App Engine should allow a request to wait in
-        # the pending queue before starting a new instance to handle it.
+        # Maximum amount of time that a request should wait in the pending queue before
+        # starting a new instance to handle it.
         # Corresponds to the JSON property `maxPendingLatency`
         # @return [String]
         attr_accessor :max_pending_latency
       
-        # The minimum number of idle instances that App Engine should maintain for this
-        # version. Only applies to the default version of a service, since other
-        # versions are not expected to receive significant traffic.
+        # Minimum number of idle instances that should be maintained for this version.
+        # Only applicable for the default version of a module.
         # Corresponds to the JSON property `minIdleInstances`
         # @return [Fixnum]
         attr_accessor :min_idle_instances
       
-        # Minimum number of instances that App Engine should maintain.
+        # Minimum number of instances that should be maintained for this version.
         # Corresponds to the JSON property `minTotalInstances`
         # @return [Fixnum]
         attr_accessor :min_total_instances
       
-        # The minimum amount of time that App Engine should allow a request to wait in
-        # the pending queue before starting a new instance to handle it.
+        # Minimum amount of time a request should wait in the pending queue before
+        # starting a new instance to handle it.
         # Corresponds to the JSON property `minPendingLatency`
         # @return [String]
         attr_accessor :min_pending_latency
       
-        # Target scaling by request utilization (for VM runtimes only).
+        # Target scaling by request utilization. Only applicable for VM runtimes.
         # Corresponds to the JSON property `requestUtilization`
         # @return [Google::Apis::AppengineV1beta5::RequestUtilization]
         attr_accessor :request_utilization
       
-        # Target scaling by disk usage (for VM runtimes only).
+        # Target scaling by disk usage. Only applicable for VM runtimes.
         # Corresponds to the JSON property `diskUtilization`
         # @return [Google::Apis::AppengineV1beta5::DiskUtilization]
         attr_accessor :disk_utilization
       
-        # Target scaling by network usage (for VM runtimes only).
+        # Target scaling by network usage. Only applicable for VM runtimes.
         # Corresponds to the JSON property `networkUtilization`
         # @return [Google::Apis::AppengineV1beta5::NetworkUtilization]
         attr_accessor :network_utilization
@@ -625,12 +672,12 @@ module Google
       class CpuUtilization
         include Google::Apis::Core::Hashable
       
-        # The period of time over which CPU utilization is calculated.
+        # Period of time over which CPU utilization is calculated.
         # Corresponds to the JSON property `aggregationWindowLength`
         # @return [String]
         attr_accessor :aggregation_window_length
       
-        # Target (0-1) CPU utilization ratio to maintain when scaling.
+        # Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.
         # Corresponds to the JSON property `targetUtilization`
         # @return [Float]
         attr_accessor :target_utilization
@@ -646,7 +693,7 @@ module Google
         end
       end
       
-      # Target scaling by request utilization (for VM runtimes only).
+      # Target scaling by request utilization. Only applicable for VM runtimes.
       class RequestUtilization
         include Google::Apis::Core::Hashable
       
@@ -671,26 +718,26 @@ module Google
         end
       end
       
-      # Target scaling by disk usage (for VM runtimes only).
+      # Target scaling by disk usage. Only applicable for VM runtimes.
       class DiskUtilization
         include Google::Apis::Core::Hashable
       
-        # Target bytes per second written.
+        # Target bytes written per second.
         # Corresponds to the JSON property `targetWriteBytesPerSec`
         # @return [Fixnum]
         attr_accessor :target_write_bytes_per_sec
       
-        # Target ops per second written.
+        # Target ops written per second.
         # Corresponds to the JSON property `targetWriteOpsPerSec`
         # @return [Fixnum]
         attr_accessor :target_write_ops_per_sec
       
-        # Target bytes per second read.
+        # Target bytes read per second.
         # Corresponds to the JSON property `targetReadBytesPerSec`
         # @return [Fixnum]
         attr_accessor :target_read_bytes_per_sec
       
-        # Target ops per second read.
+        # Target ops read per second.
         # Corresponds to the JSON property `targetReadOpsPerSec`
         # @return [Fixnum]
         attr_accessor :target_read_ops_per_sec
@@ -708,26 +755,26 @@ module Google
         end
       end
       
-      # Target scaling by network usage (for VM runtimes only).
+      # Target scaling by network usage. Only applicable for VM runtimes.
       class NetworkUtilization
         include Google::Apis::Core::Hashable
       
-        # Target bytes per second sent.
+        # Target bytes sent per second.
         # Corresponds to the JSON property `targetSentBytesPerSec`
         # @return [Fixnum]
         attr_accessor :target_sent_bytes_per_sec
       
-        # Target packets per second sent.
+        # Target packets sent per second.
         # Corresponds to the JSON property `targetSentPacketsPerSec`
         # @return [Fixnum]
         attr_accessor :target_sent_packets_per_sec
       
-        # Target bytes per second received.
+        # Target bytes received per second.
         # Corresponds to the JSON property `targetReceivedBytesPerSec`
         # @return [Fixnum]
         attr_accessor :target_received_bytes_per_sec
       
-        # Target packets per second received.
+        # Target packets received per second.
         # Corresponds to the JSON property `targetReceivedPacketsPerSec`
         # @return [Fixnum]
         attr_accessor :target_received_packets_per_sec
@@ -752,13 +799,13 @@ module Google
       class BasicScaling
         include Google::Apis::Core::Hashable
       
-        # The instance will be shut down this amount of time after receiving its last
-        # request.
+        # Duration of time after the last request that an instance must wait before the
+        # instance is shut down.
         # Corresponds to the JSON property `idleTimeout`
         # @return [String]
         attr_accessor :idle_timeout
       
-        # The maximum number of instances for App Engine to create for this version.
+        # Maximum number of instances to create for this version.
         # Corresponds to the JSON property `maxInstances`
         # @return [Fixnum]
         attr_accessor :max_instances
@@ -779,9 +826,9 @@ module Google
       class ManualScaling
         include Google::Apis::Core::Hashable
       
-        # The number of instances to assign to the service at the start. This number can
-        # later be altered by using the [Modules API](https://cloud.google.com/appengine/
-        # docs/python/modules/functions) `set_num_instances()` function.
+        # Number of instances to assign to the service at the start. This number can
+        # later be altered by using the Modules API (https://cloud.google.com/appengine/
+        # docs/python/modules/functions) set_num_instances() function.
         # Corresponds to the JSON property `instances`
         # @return [Fixnum]
         attr_accessor :instances
@@ -796,27 +843,43 @@ module Google
         end
       end
       
-      # Used to specify extra network settings (for VM runtimes only).
+      # Extra network settings. Only applicable for VM runtimes.
       class Network
         include Google::Apis::Core::Hashable
       
-        # A list of ports (or port pairs) to forward from the VM into the app container.
+        # List of ports, or port pairs, to forward from the virtual machine to the
+        # application container.
         # Corresponds to the JSON property `forwardedPorts`
         # @return [Array<String>]
         attr_accessor :forwarded_ports
       
-        # A tag to apply to the VM instance during creation.
+        # Tag to apply to the VM instance during creation.
         # Corresponds to the JSON property `instanceTag`
         # @return [String]
         attr_accessor :instance_tag
       
-        # The Google Compute Engine network where the VMs will be created. If not
-        # specified, or empty, the network named "default" will be used. (The short name
-        # should be specified, not the resource path.)
+        # Google Cloud Platform network where the virtual machines are created. Specify
+        # the short name, not the resource path.Defaults to default.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
+        # Google Cloud Platform sub-network where the virtual machines are created.
+        # Specify the short name, not the resource path.If a subnetwork name is
+        # specified, a network name will also be required unless it is for the default
+        # network. If the network the VM instance is being created in is a Legacy
+        # network, then the IP address is allocated from the IPv4Range. If the network
+        # the VM instance is being created in is an auto Subnet Mode Network, then only
+        # network name should be specified (not the subnetwork_name) and the IP address
+        # is created from the IPCidrRange of the subnetwork that exists in that zone for
+        # that network. If the network the VM instance is being created in is a custom
+        # Subnet Mode Network, then the subnetwork_name must be specified and the IP
+        # address is created from the IPCidrRange of the subnetwork.If specified, the
+        # subnetwork must exist in the same region as the Flex app.
+        # Corresponds to the JSON property `subnetworkName`
+        # @return [String]
+        attr_accessor :subnetwork_name
+      
         def initialize(**args)
            update!(**args)
         end
@@ -826,28 +889,34 @@ module Google
           @forwarded_ports = args[:forwarded_ports] if args.key?(:forwarded_ports)
           @instance_tag = args[:instance_tag] if args.key?(:instance_tag)
           @name = args[:name] if args.key?(:name)
+          @subnetwork_name = args[:subnetwork_name] if args.key?(:subnetwork_name)
         end
       end
       
-      # Used to specify how many machine resources an app version needs.
+      # Machine resources for a version.
       class Resources
         include Google::Apis::Core::Hashable
       
-        # How many CPU cores an app version needs.
+        # Number of CPU cores needed.
         # Corresponds to the JSON property `cpu`
         # @return [Float]
         attr_accessor :cpu
       
-        # How much disk size, in GB, an app version needs.
+        # Disk size (GB) needed.
         # Corresponds to the JSON property `diskGb`
         # @return [Float]
         attr_accessor :disk_gb
       
-        # How much memory, in GB, an app version needs.
+        # Memory (GB) needed.
         # Corresponds to the JSON property `memoryGb`
         # @return [Float]
         attr_accessor :memory_gb
       
+        # Volumes mounted within the app container.
+        # Corresponds to the JSON property `volumes`
+        # @return [Array<Google::Apis::AppengineV1beta5::Volume>]
+        attr_accessor :volumes
+      
         def initialize(**args)
            update!(**args)
         end
@@ -857,19 +926,51 @@ module Google
           @cpu = args[:cpu] if args.key?(:cpu)
           @disk_gb = args[:disk_gb] if args.key?(:disk_gb)
           @memory_gb = args[:memory_gb] if args.key?(:memory_gb)
+          @volumes = args[:volumes] if args.key?(:volumes)
         end
       end
       
-      # A URL pattern and description of how it should be handled. App Engine can
+      # Volumes mounted within the app container. Only applicable for VM runtimes.
+      class Volume
+        include Google::Apis::Core::Hashable
+      
+        # Unique name for the volume.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Underlying volume type, e.g. 'tmpfs'.
+        # Corresponds to the JSON property `volumeType`
+        # @return [String]
+        attr_accessor :volume_type
+      
+        # Volume size in gigabytes.
+        # Corresponds to the JSON property `sizeGb`
+        # @return [Float]
+        attr_accessor :size_gb
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @volume_type = args[:volume_type] if args.key?(:volume_type)
+          @size_gb = args[:size_gb] if args.key?(:size_gb)
+        end
+      end
+      
+      # URL pattern and description of how the URL should be handled. App Engine can
       # handle URLs by executing application code, or by serving static files uploaded
-      # with the code, such as images, CSS or JavaScript.
+      # with the version, such as images, CSS, or JavaScript.
       class UrlMap
         include Google::Apis::Core::Hashable
       
-        # A URL prefix. This value uses regular expression syntax (and so regexp special
-        # characters must be escaped), but it should not contain groupings. All URLs
-        # that begin with this prefix are handled by this handler, using the portion of
-        # the URL after the prefix as part of the file path. This is always required.
+        # A URL prefix. Uses regular expression syntax, which means regexp special
+        # characters must be escaped, but should not contain groupings. All URLs that
+        # begin with this prefix are handled by this handler, using the portion of the
+        # URL after the prefix as part of the file path.
         # Corresponds to the JSON property `urlRegex`
         # @return [String]
         attr_accessor :url_regex
@@ -886,29 +987,29 @@ module Google
         # @return [Google::Apis::AppengineV1beta5::ScriptHandler]
         attr_accessor :script
       
-        # Use Google Cloud Endpoints to handle requests.
+        # Uses Google Cloud Endpoints to handle requests.
         # Corresponds to the JSON property `apiEndpoint`
         # @return [Google::Apis::AppengineV1beta5::ApiEndpointHandler]
         attr_accessor :api_endpoint
       
-        # Configures whether security (HTTPS) should be enforced for this URL.
+        # Security (HTTPS) enforcement for this URL.
         # Corresponds to the JSON property `securityLevel`
         # @return [String]
         attr_accessor :security_level
       
-        # What level of login is required to access this resource.
+        # Level of login required to access this resource.
         # Corresponds to the JSON property `login`
         # @return [String]
         attr_accessor :login
       
-        # For users not logged in, how to handle access to resources with required login.
-        # Defaults to "redirect".
+        # Action to take when users access resources that require authentication.
+        # Defaults to redirect.
         # Corresponds to the JSON property `authFailAction`
         # @return [String]
         attr_accessor :auth_fail_action
       
-        # `30x` code to use when performing redirects for the `secure` field. A `302` is
-        # used by default.
+        # 30x code to use when performing redirects for the secure field. Defaults to
+        # 302.
         # Corresponds to the JSON property `redirectHttpResponseCode`
         # @return [String]
         attr_accessor :redirect_http_response_code
@@ -936,14 +1037,13 @@ module Google
       class StaticFilesHandler
         include Google::Apis::Core::Hashable
       
-        # The path to the static files matched by the URL pattern, from the application
-        # root directory. The path can refer to text matched in groupings in the URL
-        # pattern.
+        # Path to the static files matched by the URL pattern, from the application root
+        # directory. The path can refer to text matched in groupings in the URL pattern.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
       
-        # A regular expression that matches the file paths for all files that will be
+        # Regular expression that matches the file paths for all files that should be
         # referenced by this handler.
         # Corresponds to the JSON property `uploadPathRegex`
         # @return [String]
@@ -954,32 +1054,28 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :http_headers
       
-        # If specified, all files served by this handler will be served using the
-        # specified MIME type. If not specified, the MIME type for a file will be
-        # derived from the file's filename extension.
+        # MIME type used to serve all files served by this handler. Defaults to file-
+        # specific MIME types, which are derived from each file's filename extension.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
       
-        # The length of time a static file served by this handler ought to be cached by
-        # web proxies and browsers.
+        # Time a static file served by this handler should be cached.
         # Corresponds to the JSON property `expiration`
         # @return [String]
         attr_accessor :expiration
       
-        # If true, this UrlMap entry does not match the request unless the file
-        # referenced by the handler also exists. If no such file exists, processing will
-        # continue with the next UrlMap that matches the requested URL.
+        # Whether this handler should match the request if the file referenced by the
+        # handler does not exist.
         # Corresponds to the JSON property `requireMatchingFile`
         # @return [Boolean]
         attr_accessor :require_matching_file
         alias_method :require_matching_file?, :require_matching_file
       
-        # By default, files declared in static file handlers are uploaded as static data
-        # and are only served to end users, they cannot be read by an application. If
-        # this field is set to true, the files are also uploaded as code data so your
-        # application can read them. Both uploads are charged against your code and
-        # static data storage resource quotas.
+        # Whether files should also be uploaded as code data. By default, files declared
+        # in static file handlers are uploaded as static data and are only served to end
+        # users; they cannot be read by the application. If enabled, uploads are charged
+        # against both your code and static data storage resource quotas.
         # Corresponds to the JSON property `applicationReadable`
         # @return [Boolean]
         attr_accessor :application_readable
@@ -1005,7 +1101,7 @@ module Google
       class ScriptHandler
         include Google::Apis::Core::Hashable
       
-        # Specifies the path to the script from the application root directory.
+        # Path to the script from the application root directory.
         # Corresponds to the JSON property `scriptPath`
         # @return [String]
         attr_accessor :script_path
@@ -1020,11 +1116,11 @@ module Google
         end
       end
       
-      # Use Google Cloud Endpoints to handle requests.
+      # Uses Google Cloud Endpoints to handle requests.
       class ApiEndpointHandler
         include Google::Apis::Core::Hashable
       
-        # Specifies the path to the script from the application root directory.
+        # Path to the script from the application root directory.
         # Corresponds to the JSON property `scriptPath`
         # @return [String]
         attr_accessor :script_path
@@ -1039,11 +1135,11 @@ module Google
         end
       end
       
-      # A custom static error page to be served when an error occurs.
+      # Custom static error page to be served when an error occurs.
       class ErrorHandler
         include Google::Apis::Core::Hashable
       
-        # The error condition this handler applies to.
+        # Error condition this handler applies to.
         # Corresponds to the JSON property `errorCode`
         # @return [String]
         attr_accessor :error_code
@@ -1053,7 +1149,7 @@ module Google
         # @return [String]
         attr_accessor :static_file
       
-        # MIME type of file. If unspecified, "text/html" is assumed.
+        # MIME type of file. Defaults to text/html.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
@@ -1070,16 +1166,16 @@ module Google
         end
       end
       
-      # A Python runtime third-party library required by the application.
+      # Third-party Python runtime library that is required by the application.
       class Library
         include Google::Apis::Core::Hashable
       
-        # The name of the library, e.g. "PIL" or "django".
+        # Name of the library. Example: "django".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The version of the library to select, or "latest".
+        # Version of the library to select, or "latest".
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -1095,27 +1191,28 @@ module Google
         end
       end
       
-      # API Serving configuration for Cloud Endpoints.
+      # Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/
+      # endpoints/) configuration for API handlers.
       class ApiConfigHandler
         include Google::Apis::Core::Hashable
       
-        # For users not logged in, how to handle access to resources with required login.
-        # Defaults to "redirect".
+        # Action to take when users access resources that require authentication.
+        # Defaults to redirect.
         # Corresponds to the JSON property `authFailAction`
         # @return [String]
         attr_accessor :auth_fail_action
       
-        # What level of login is required to access this resource. Default is "optional".
+        # Level of login required to access this resource. Defaults to optional.
         # Corresponds to the JSON property `login`
         # @return [String]
         attr_accessor :login
       
-        # Specifies the path to the script from the application root directory.
+        # Path to the script from the application root directory.
         # Corresponds to the JSON property `script`
         # @return [String]
         attr_accessor :script
       
-        # Configures whether security (HTTPS) should be enforced for this URL.
+        # Security (HTTPS) enforcement for this URL.
         # Corresponds to the JSON property `securityLevel`
         # @return [String]
         attr_accessor :security_level
@@ -1139,8 +1236,9 @@ module Google
         end
       end
       
-      # Configure health checking for the VM instances. Unhealthy VM instances will be
-      # killed and replaced with new instances.
+      # Health checking configuration for VM instances. Unhealthy instances are killed
+      # and replaced with new instances. Only applicable for instances in App Engine
+      # flexible environment.
       class HealthCheck
         include Google::Apis::Core::Hashable
       
@@ -1150,33 +1248,35 @@ module Google
         attr_accessor :disable_health_check
         alias_method :disable_health_check?, :disable_health_check
       
-        # The host header to send when performing an HTTP health check (e.g. myapp.
-        # appspot.com)
+        # Host header to send when performing an HTTP health check. Example: "myapp.
+        # appspot.com"
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # The number of consecutive successful health checks before receiving traffic.
+        # Number of consecutive successful health checks required before receiving
+        # traffic.
         # Corresponds to the JSON property `healthyThreshold`
         # @return [Fixnum]
         attr_accessor :healthy_threshold
       
-        # The number of consecutive failed health checks before removing traffic.
+        # Number of consecutive failed health checks required before removing traffic.
         # Corresponds to the JSON property `unhealthyThreshold`
         # @return [Fixnum]
         attr_accessor :unhealthy_threshold
       
-        # The number of consecutive failed health checks before an instance is restarted.
+        # Number of consecutive failed health checks required before an instance is
+        # restarted.
         # Corresponds to the JSON property `restartThreshold`
         # @return [Fixnum]
         attr_accessor :restart_threshold
       
-        # The interval between health checks.
+        # Interval between health checks.
         # Corresponds to the JSON property `checkInterval`
         # @return [String]
         attr_accessor :check_interval
       
-        # The amount of time before the health check is considered failed.
+        # Time before the health check is considered failed.
         # Corresponds to the JSON property `timeout`
         # @return [String]
         attr_accessor :timeout
@@ -1201,20 +1301,22 @@ module Google
       class Deployment
         include Google::Apis::Core::Hashable
       
-        # A manifest of files stored in Google Cloud Storage which should be included as
-        # part of this application. All files must be readable using the credentials
-        # supplied with this call.
+        # Manifest of the files stored in Google Cloud Storage that are included as part
+        # of this version. All files must be readable using the credentials supplied
+        # with this call.
         # Corresponds to the JSON property `files`
         # @return [Hash<String,Google::Apis::AppengineV1beta5::FileInfo>]
         attr_accessor :files
       
-        # A Docker (container) image which should be used to start the application.
+        # Docker image that is used to create a container and start a VM instance for
+        # the version that you deploy. Only applicable for instances running in the App
+        # Engine flexible environment.
         # Corresponds to the JSON property `container`
         # @return [Google::Apis::AppengineV1beta5::ContainerInfo]
         attr_accessor :container
       
-        # The origin of the source code for this deployment. There can be more than one
-        # source reference per Version if source code is distributed among multiple
+        # Origin of the source code for this deployment. There can be more than one
+        # source reference per version if source code is distributed among multiple
         # repositories.
         # Corresponds to the JSON property `sourceReferences`
         # @return [Array<Google::Apis::AppengineV1beta5::SourceReference>]
@@ -1232,23 +1334,23 @@ module Google
         end
       end
       
-      # A single source file which is part of the application to be deployed.
+      # Single source file that is part of the version to be deployed. Each source
+      # file that is deployed must be specified separately.
       class FileInfo
         include Google::Apis::Core::Hashable
       
-        # The URL source to use to fetch this file. Must be a URL to a resource in
-        # Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+        # URL source to use to fetch this file. Must be a URL to a resource in Google
+        # Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
         # Corresponds to the JSON property `sourceUrl`
         # @return [String]
         attr_accessor :source_url
       
-        # The SHA1 (160 bits) hash of the file in hex.
+        # The SHA1 hash of the file, in hex.
         # Corresponds to the JSON property `sha1Sum`
         # @return [String]
         attr_accessor :sha1_sum
       
-        # The MIME type of the file; if unspecified, the value from Google Cloud Storage
-        # will be used.
+        # The MIME type of the file.Defaults to the value from Google Cloud Storage.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
@@ -1265,13 +1367,15 @@ module Google
         end
       end
       
-      # A Docker (container) image which should be used to start the application.
+      # Docker image that is used to create a container and start a VM instance for
+      # the version that you deploy. Only applicable for instances running in the App
+      # Engine flexible environment.
       class ContainerInfo
         include Google::Apis::Core::Hashable
       
-        # Reference to a hosted container image. Must be a URI to a resource in a Docker
-        # repository. Must be fully qualified, including tag or digest. e.g. gcr.io/my-
-        # project/image:tag or gcr.io/my-project/image@digest
+        # URI to the hosted container image in Google Container Registry. The URI must
+        # be fully qualified and include a tag or digest. Examples: "gcr.io/my-project/
+        # image:tag" or "gcr.io/my-project/image@digest"
         # Corresponds to the JSON property `image`
         # @return [String]
         attr_accessor :image
@@ -1286,20 +1390,20 @@ module Google
         end
       end
       
-      # A reference to a particular snapshot of the source tree used to build and
-      # deploy the application.
+      # Reference to a particular snapshot of the source tree used to build and deploy
+      # the application.
       class SourceReference
         include Google::Apis::Core::Hashable
       
-        # Optional. A URI string identifying the repository. Example: "https://source.
-        # developers.google.com/p/app-123/r/default"
+        # URI string identifying the repository. Example: "https://source.developers.
+        # google.com/p/app-123/r/default"
         # Corresponds to the JSON property `repository`
         # @return [String]
         attr_accessor :repository
       
-        # The canonical (and persistent) identifier of the deployed revision, i.e. any
-        # kind of aliases including tags or branch names are not allowed. Example (git):
-        # "2198322f89e0bb2e25021667c2ed489d1fd34e6b"
+        # The canonical, persistent identifier of the deployed revision. Aliases that
+        # include tags or branch names are not allowed. Example (git): "
+        # 2198322f89e0bb2e25021667c2ed489d1fd34e6b"
         # Corresponds to the JSON property `revisionId`
         # @return [String]
         attr_accessor :revision_id
@@ -1315,11 +1419,42 @@ module Google
         end
       end
       
-      # Response message for `Versions.ListVersions`.
+      # Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The
+      # Endpoints API Service provides tooling for serving Open API and gRPC endpoints
+      # via an NGINX proxy.The fields here refer to the name and configuration id of a
+      # "service" resource in the Service Management API (https://cloud.google.com/
+      # service-management/overview).
+      class EndpointsApiService
+        include Google::Apis::Core::Hashable
+      
+        # Endpoints service name which is the name of the "service" resource in the
+        # Service Management API. For example "myapi.endpoints.myproject.cloud.goog"
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Endpoints service configuration id as specified by the Service Management API.
+        # For example "2016-09-19r1"
+        # Corresponds to the JSON property `configId`
+        # @return [String]
+        attr_accessor :config_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @config_id = args[:config_id] if args.key?(:config_id)
+        end
+      end
+      
+      # Response message for Versions.ListVersions.
       class ListVersionsResponse
         include Google::Apis::Core::Hashable
       
-        # The versions belonging to the requested application service.
+        # The versions belonging to the requested service.
         # Corresponds to the JSON property `versions`
         # @return [Array<Google::Apis::AppengineV1beta5::Version>]
         attr_accessor :versions
@@ -1340,8 +1475,8 @@ module Google
         end
       end
       
-      # A service is a logical component of an application that can share state and
-      # communicate in a secure fashion with other services. For example, an
+      # A Service resource is a logical component of an application that can share
+      # state and communicate in a secure fashion with other services. For example, an
       # application that handles customer requests might include separate services to
       # handle other tasks such as API requests from mobile devices or backend data
       # analysis. Each service has a collection of versions that define a specific set
@@ -1349,22 +1484,20 @@ module Google
       class Service
         include Google::Apis::Core::Hashable
       
-        # The full path to the Service resource in the API. Example: "apps/myapp/
-        # services/default" @OutputOnly
+        # Full path to the Service resource in the API. Example: apps/myapp/services/
+        # default.@OutputOnly
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The relative name/path of the service within the application. Example: "
-        # default" @OutputOnly
+        # Relative name of the service within the application. Example: default.@
+        # OutputOnly
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Configuration for traffic splitting for versions within a single service.
-        # Traffic splitting allows traffic directed to the service to be assigned to one
-        # of several versions in a fractional way, enabling experiments and canarying
-        # new builds, for example.
+        # Traffic routing configuration for versions within a single service. Traffic
+        # splits define how traffic directed to the service is assigned to versions.
         # Corresponds to the JSON property `split`
         # @return [Google::Apis::AppengineV1beta5::TrafficSplit]
         attr_accessor :split
@@ -1381,27 +1514,25 @@ module Google
         end
       end
       
-      # Configuration for traffic splitting for versions within a single service.
-      # Traffic splitting allows traffic directed to the service to be assigned to one
-      # of several versions in a fractional way, enabling experiments and canarying
-      # new builds, for example.
+      # Traffic routing configuration for versions within a single service. Traffic
+      # splits define how traffic directed to the service is assigned to versions.
       class TrafficSplit
         include Google::Apis::Core::Hashable
       
-        # Which mechanism should be used as a selector when choosing a version to send a
-        # request to. The traffic selection algorithm will be stable for either type
-        # until allocations are changed.
+        # Mechanism used to determine which version a request is sent to. The traffic
+        # selection algorithm will be stable for either type until allocations are
+        # changed.
         # Corresponds to the JSON property `shardBy`
         # @return [String]
         attr_accessor :shard_by
       
-        # Mapping from service version IDs within the service to fractional (0.000, 1]
-        # allocations of traffic for that version. Each version may only be specified
+        # Mapping from version IDs within the service to fractional (0.000, 1]
+        # allocations of traffic for that version. Each version can be specified only
         # once, but some versions in the service may not have any traffic allocation.
-        # Services that have traffic allocated in this field may not be deleted until
-        # the service is deleted, or their traffic allocation is removed. Allocations
-        # must sum to 1. Supports precision up to two decimal places for IP-based splits
-        # and up to three decimal places for cookie-based splits.
+        # Services that have traffic allocated cannot be deleted until either the
+        # service is deleted or their traffic allocation is removed. Allocations must
+        # sum to 1. Up to two decimal place precision is supported for IP-based splits
+        # and up to three decimal places is supported for cookie-based splits.
         # Corresponds to the JSON property `allocations`
         # @return [Hash<String,Float>]
         attr_accessor :allocations
@@ -1417,7 +1548,7 @@ module Google
         end
       end
       
-      # Response message for `Services.ListServices`.
+      # Response message for Services.ListServices.
       class ListServicesResponse
         include Google::Apis::Core::Hashable
       
@@ -1442,116 +1573,100 @@ module Google
         end
       end
       
-      # Response message for `Instances.ListInstances`.
-      class ListInstancesResponse
-        include Google::Apis::Core::Hashable
-      
-        # The instances belonging to the requested version.
-        # Corresponds to the JSON property `instances`
-        # @return [Array<Google::Apis::AppengineV1beta5::Instance>]
-        attr_accessor :instances
-      
-        # Continuation token for fetching the next page of results.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @instances = args[:instances] if args.key?(:instances)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-        end
-      end
-      
-      # Instances are the computing units that App Engine uses to automatically scale
-      # an application.
+      # An Instance resource is the computing unit that App Engine uses to
+      # automatically scale an application.
       class Instance
         include Google::Apis::Core::Hashable
       
-        # The full path to the Instance resource in the API. Example: "apps/myapp/
-        # services/default/versions/v1/instances/instance-1" @OutputOnly
+        # Full path to the Instance resource in the API. Example: apps/myapp/services/
+        # default/versions/v1/instances/instance-1.@OutputOnly
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The relative name/path of the instance within the version. Example: "instance-
-        # 1" @OutputOnly
+        # Relative name of the instance within the version. Example: instance-1.@
+        # OutputOnly
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # The App Engine release the instance is running on. @OutputOnly
+        # App Engine release this instance is running on.@OutputOnly
         # Corresponds to the JSON property `appEngineRelease`
         # @return [String]
         attr_accessor :app_engine_release
       
-        # Availability of instance. @OutputOnly
+        # Availability of the instance.@OutputOnly
         # Corresponds to the JSON property `availability`
         # @return [String]
         attr_accessor :availability
       
-        # For VMEngines instances, the name of GCE VM where the instance lives. @
-        # OutputOnly
+        # Name of the virtual machine where this instance lives. Only applicable for
+        # instances in App Engine flexible environment.@OutputOnly
         # Corresponds to the JSON property `vmName`
         # @return [String]
         attr_accessor :vm_name
       
-        # For VMEngines instances, the zone where the GCE VM is located. @OutputOnly
+        # Zone where the virtual machine is located. Only applicable for instances in
+        # App Engine flexible environment.@OutputOnly
         # Corresponds to the JSON property `vmZoneName`
         # @return [String]
         attr_accessor :vm_zone_name
       
-        # For VMEngines instances, the GCE VM ID of the instance. @OutputOnly
+        # Virtual machine ID of this instance. Only applicable for instances in App
+        # Engine flexible environment.@OutputOnly
         # Corresponds to the JSON property `vmId`
         # @return [String]
         attr_accessor :vm_id
       
-        # Time when instance was started. @OutputOnly
+        # Time that this instance was started.@OutputOnly
         # Corresponds to the JSON property `startTimestamp`
         # @return [String]
         attr_accessor :start_timestamp
       
-        # Number of requests (since the clone was started). @OutputOnly
+        # Number of requests since this instance was started.@OutputOnly
         # Corresponds to the JSON property `requests`
         # @return [Fixnum]
         attr_accessor :requests
       
-        # Number of errors since the instance was started. @OutputOnly
+        # Number of errors since this instance was started.@OutputOnly
         # Corresponds to the JSON property `errors`
         # @return [Fixnum]
         attr_accessor :errors
       
-        # QPS for this instance (averaged over the last minute). @OutputOnly
+        # Average queries per second (QPS) over the last minute.@OutputOnly
         # Corresponds to the JSON property `qps`
         # @return [Float]
         attr_accessor :qps
       
-        # Latency in milliseconds (averaged over the last minute). @OutputOnly
+        # Average latency (ms) over the last minute.@OutputOnly
         # Corresponds to the JSON property `averageLatency`
         # @return [Fixnum]
         attr_accessor :average_latency
       
-        # Memory usage (in bytes). @OutputOnly
+        # Total memory in use (bytes).@OutputOnly
         # Corresponds to the JSON property `memoryUsage`
         # @return [String]
         attr_accessor :memory_usage
       
-        # For VMEngines instances, the status of GCE VM where the instance lives. @
-        # OutputOnly
+        # Status of the virtual machine where this instance lives. Only applicable for
+        # instances in App Engine flexible environment.@OutputOnly
         # Corresponds to the JSON property `vmStatus`
         # @return [String]
         attr_accessor :vm_status
       
-        # For VMEngines instances, whether the instance has been unlocked. @OutputOnly
+        # Whether this instance is in debug mode. Only applicable for instances in App
+        # Engine flexible environment.@OutputOnly
         # Corresponds to the JSON property `vmUnlocked`
         # @return [Boolean]
         attr_accessor :vm_unlocked
         alias_method :vm_unlocked?, :vm_unlocked
       
+        # The IP address of this instance. Only applicable for instances in App Engine
+        # flexible environment.@OutputOnly
+        # Corresponds to the JSON property `vmIp`
+        # @return [String]
+        attr_accessor :vm_ip
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1573,6 +1688,165 @@ module Google
           @memory_usage = args[:memory_usage] if args.key?(:memory_usage)
           @vm_status = args[:vm_status] if args.key?(:vm_status)
           @vm_unlocked = args[:vm_unlocked] if args.key?(:vm_unlocked)
+          @vm_ip = args[:vm_ip] if args.key?(:vm_ip)
+        end
+      end
+      
+      # Response message for Instances.ListInstances.
+      class ListInstancesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The instances belonging to the requested version.
+        # Corresponds to the JSON property `instances`
+        # @return [Array<Google::Apis::AppengineV1beta5::Instance>]
+        attr_accessor :instances
+      
+        # Continuation token for fetching the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @instances = args[:instances] if args.key?(:instances)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # Request message for Instances.DebugInstance.
+      class DebugInstanceRequest
+        include Google::Apis::Core::Hashable
+      
+        # Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa [KEY_VALUE]
+        # [USERNAME] [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh `"userName":"[USERNAME]",
+        # "expireOn":"[EXPIRE_TIME]"`For more information, see Adding and Removing SSH
+        # Keys (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys)
+        # .
+        # Corresponds to the JSON property `sshKey`
+        # @return [String]
+        attr_accessor :ssh_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ssh_key = args[:ssh_key] if args.key?(:ssh_key)
+        end
+      end
+      
+      # The response message for Locations.ListLocations.
+      class ListLocationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of locations that matches the specified filter in the request.
+        # Corresponds to the JSON property `locations`
+        # @return [Array<Google::Apis::AppengineV1beta5::Location>]
+        attr_accessor :locations
+      
+        # The standard List next-page token.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @locations = args[:locations] if args.key?(:locations)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # A resource that represents Google Cloud Platform location.
+      class Location
+        include Google::Apis::Core::Hashable
+      
+        # Resource name for the location, which may vary between implementations. For
+        # example: "projects/example-project/locations/us-east1"
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The canonical id for this location. For example: "us-east1".
+        # Corresponds to the JSON property `locationId`
+        # @return [String]
+        attr_accessor :location_id
+      
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
+        # region": "us-east1"`
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # Service-specific metadata. For example the available capacity at the given
+        # location.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @location_id = args[:location_id] if args.key?(:location_id)
+          @labels = args[:labels] if args.key?(:labels)
+          @metadata = args[:metadata] if args.key?(:metadata)
+        end
+      end
+      
+      # Metadata for the given google.longrunning.Operation.
+      class OperationMetadataExperimental
+        include Google::Apis::Core::Hashable
+      
+        # API method that initiated this operation. Example: google.appengine.
+        # experimental.CustomDomains.CreateCustomDomain.@OutputOnly
+        # Corresponds to the JSON property `method`
+        # @return [String]
+        attr_accessor :method_prop
+      
+        # Time that this operation was created.@OutputOnly
+        # Corresponds to the JSON property `insertTime`
+        # @return [String]
+        attr_accessor :insert_time
+      
+        # Time that this operation completed.@OutputOnly
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # User who requested this operation.@OutputOnly
+        # Corresponds to the JSON property `user`
+        # @return [String]
+        attr_accessor :user
+      
+        # Name of the resource that this operation is acting on. Example: apps/myapp/
+        # customDomains/example.com.@OutputOnly
+        # Corresponds to the JSON property `target`
+        # @return [String]
+        attr_accessor :target
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @method_prop = args[:method_prop] if args.key?(:method_prop)
+          @insert_time = args[:insert_time] if args.key?(:insert_time)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @user = args[:user] if args.key?(:user)
+          @target = args[:target] if args.key?(:target)
         end
       end
       
@@ -1580,36 +1854,35 @@ module Google
       class OperationMetadata
         include Google::Apis::Core::Hashable
       
-        # The type of the operation (deprecated, use method field instead). Example: "
-        # create_version". @OutputOnly
+        # Type of this operation. Deprecated, use method field instead. Example: "
+        # create_version".@OutputOnly
         # Corresponds to the JSON property `operationType`
         # @return [String]
         attr_accessor :operation_type
       
-        # Timestamp that this operation was received. @OutputOnly
+        # Timestamp that this operation was created.@OutputOnly
         # Corresponds to the JSON property `insertTime`
         # @return [String]
         attr_accessor :insert_time
       
-        # Timestamp that this operation was completed. (Not present if the operation is
-        # still in progress.) @OutputOnly
+        # Timestamp that this operation completed.@OutputOnly
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
       
-        # The user who requested this operation. @OutputOnly
+        # User who requested this operation.@OutputOnly
         # Corresponds to the JSON property `user`
         # @return [String]
         attr_accessor :user
       
-        # Resource that this operation is acting on. Example: "apps/myapp/modules/
-        # default". @OutputOnly
+        # Name of the resource that this operation is acting on. Example: apps/myapp/
+        # modules/default.@OutputOnly
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
       
-        # API method name that initiated the operation. Example: "google.appengine.
-        # v1beta4.Version.CreateVersion". @OutputOnly
+        # API method that initiated this operation. Example: google.appengine.v1beta4.
+        # Version.CreateVersion.@OutputOnly
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
@@ -1633,30 +1906,29 @@ module Google
       class OperationMetadataV1Beta5
         include Google::Apis::Core::Hashable
       
-        # API method name that initiated the operation. Example: "google.appengine.
-        # v1beta5.Version.CreateVersion". @OutputOnly
+        # API method name that initiated this operation. Example: google.appengine.
+        # v1beta5.Version.CreateVersion.@OutputOnly
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
       
-        # Timestamp that this operation was received. @OutputOnly
+        # Timestamp that this operation was created.@OutputOnly
         # Corresponds to the JSON property `insertTime`
         # @return [String]
         attr_accessor :insert_time
       
-        # Timestamp that this operation was completed. (Not present if the operation is
-        # still in progress.) @OutputOnly
+        # Timestamp that this operation completed.@OutputOnly
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
       
-        # The user who requested this operation. @OutputOnly
+        # User who requested this operation.@OutputOnly
         # Corresponds to the JSON property `user`
         # @return [String]
         attr_accessor :user
       
-        # Resource that this operation is acting on. Example: "apps/myapp/services/
-        # default". @OutputOnly
+        # Name of the resource that this operation is acting on. Example: apps/myapp/
+        # services/default.@OutputOnly
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -1674,6 +1946,149 @@ module Google
           @target = args[:target] if args.key?(:target)
         end
       end
+      
+      # Metadata for the given google.longrunning.Operation.
+      class OperationMetadataV1Beta
+        include Google::Apis::Core::Hashable
+      
+        # API method that initiated this operation. Example: google.appengine.v1beta.
+        # Versions.CreateVersion.@OutputOnly
+        # Corresponds to the JSON property `method`
+        # @return [String]
+        attr_accessor :method_prop
+      
+        # Time that this operation was created.@OutputOnly
+        # Corresponds to the JSON property `insertTime`
+        # @return [String]
+        attr_accessor :insert_time
+      
+        # Time that this operation completed.@OutputOnly
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # User who requested this operation.@OutputOnly
+        # Corresponds to the JSON property `user`
+        # @return [String]
+        attr_accessor :user
+      
+        # Name of the resource that this operation is acting on. Example: apps/myapp/
+        # services/default.@OutputOnly
+        # Corresponds to the JSON property `target`
+        # @return [String]
+        attr_accessor :target
+      
+        # Ephemeral message that may change every time the operation is polled. @
+        # OutputOnly
+        # Corresponds to the JSON property `ephemeralMessage`
+        # @return [String]
+        attr_accessor :ephemeral_message
+      
+        # Durable messages that persist on every operation poll. @OutputOnly
+        # Corresponds to the JSON property `warning`
+        # @return [Array<String>]
+        attr_accessor :warning
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @method_prop = args[:method_prop] if args.key?(:method_prop)
+          @insert_time = args[:insert_time] if args.key?(:insert_time)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @user = args[:user] if args.key?(:user)
+          @target = args[:target] if args.key?(:target)
+          @ephemeral_message = args[:ephemeral_message] if args.key?(:ephemeral_message)
+          @warning = args[:warning] if args.key?(:warning)
+        end
+      end
+      
+      # Metadata for the given google.longrunning.Operation.
+      class OperationMetadataV1
+        include Google::Apis::Core::Hashable
+      
+        # API method that initiated this operation. Example: google.appengine.v1.
+        # Versions.CreateVersion.@OutputOnly
+        # Corresponds to the JSON property `method`
+        # @return [String]
+        attr_accessor :method_prop
+      
+        # Time that this operation was created.@OutputOnly
+        # Corresponds to the JSON property `insertTime`
+        # @return [String]
+        attr_accessor :insert_time
+      
+        # Time that this operation completed.@OutputOnly
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # User who requested this operation.@OutputOnly
+        # Corresponds to the JSON property `user`
+        # @return [String]
+        attr_accessor :user
+      
+        # Name of the resource that this operation is acting on. Example: apps/myapp/
+        # services/default.@OutputOnly
+        # Corresponds to the JSON property `target`
+        # @return [String]
+        attr_accessor :target
+      
+        # Ephemeral message that may change every time the operation is polled. @
+        # OutputOnly
+        # Corresponds to the JSON property `ephemeralMessage`
+        # @return [String]
+        attr_accessor :ephemeral_message
+      
+        # Durable messages that persist on every operation poll. @OutputOnly
+        # Corresponds to the JSON property `warning`
+        # @return [Array<String>]
+        attr_accessor :warning
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @method_prop = args[:method_prop] if args.key?(:method_prop)
+          @insert_time = args[:insert_time] if args.key?(:insert_time)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @user = args[:user] if args.key?(:user)
+          @target = args[:target] if args.key?(:target)
+          @ephemeral_message = args[:ephemeral_message] if args.key?(:ephemeral_message)
+          @warning = args[:warning] if args.key?(:warning)
+        end
+      end
+      
+      # Metadata for the given google.cloud.location.Location.
+      class LocationMetadata
+        include Google::Apis::Core::Hashable
+      
+        # App Engine Standard Environment is available in the given location.@OutputOnly
+        # Corresponds to the JSON property `standardEnvironmentAvailable`
+        # @return [Boolean]
+        attr_accessor :standard_environment_available
+        alias_method :standard_environment_available?, :standard_environment_available
+      
+        # App Engine Flexible Environment is available in the given location.@OutputOnly
+        # Corresponds to the JSON property `flexibleEnvironmentAvailable`
+        # @return [Boolean]
+        attr_accessor :flexible_environment_available
+        alias_method :flexible_environment_available?, :flexible_environment_available
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @standard_environment_available = args[:standard_environment_available] if args.key?(:standard_environment_available)
+          @flexible_environment_available = args[:flexible_environment_available] if args.key?(:flexible_environment_available)
+        end
+      end
     end
   end
 end