google-api-client 0.9.pre3 → 0.9.pre4

data/generated/google/apis/licensing_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/google-apps/licensing/
     module LicensingV1
       VERSION = 'V1'
-      REVISION = '20150525'
+      REVISION = '20150901'
 
       # View and manage Google Apps licenses for your domain
       AUTH_APPS_LICENSING = 'https://www.googleapis.com/auth/apps.licensing'

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

@@ -81,8 +81,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_license_assignment(product_id, sku_id, user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/user/{userId}'
-          command =  make_simple_command(:delete, path, options)
+          command =  make_simple_command(:delete, '{productId}/sku/{skuId}/user/{userId}', options)
           command.params['productId'] = product_id unless product_id.nil?
           command.params['skuId'] = sku_id unless sku_id.nil?
           command.params['userId'] = user_id unless user_id.nil?
@@ -121,8 +120,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_license_assignment(product_id, sku_id, user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/user/{userId}'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, '{productId}/sku/{skuId}/user/{userId}', options)
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation
           command.response_class = Google::Apis::LicensingV1::LicenseAssignment
           command.params['productId'] = product_id unless product_id.nil?
@@ -162,8 +160,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def insert_license_assignment(product_id, sku_id, license_assignment_insert_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/user'
-          command =  make_simple_command(:post, path, options)
+          command =  make_simple_command(:post, '{productId}/sku/{skuId}/user', options)
           command.request_representation = Google::Apis::LicensingV1::LicenseAssignmentInsert::Representation
           command.request_object = license_assignment_insert_object
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation
@@ -209,8 +206,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_license_assignment_for_product(product_id, customer_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/users'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, '{productId}/users', options)
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignmentList::Representation
           command.response_class = Google::Apis::LicensingV1::LicenseAssignmentList
           command.params['productId'] = product_id unless product_id.nil?
@@ -258,8 +254,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_license_assignment_for_product_and_sku(product_id, sku_id, customer_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/users'
-          command =  make_simple_command(:get, path, options)
+          command =  make_simple_command(:get, '{productId}/sku/{skuId}/users', options)
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignmentList::Representation
           command.response_class = Google::Apis::LicensingV1::LicenseAssignmentList
           command.params['productId'] = product_id unless product_id.nil?
@@ -303,8 +298,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_license_assignment(product_id, sku_id, user_id, license_assignment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/user/{userId}'
-          command =  make_simple_command(:patch, path, options)
+          command =  make_simple_command(:patch, '{productId}/sku/{skuId}/user/{userId}', options)
           command.request_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation
           command.request_object = license_assignment_object
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation
@@ -348,8 +342,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def update_license_assignment(product_id, sku_id, user_id, license_assignment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          path = '{productId}/sku/{skuId}/user/{userId}'
-          command =  make_simple_command(:put, path, options)
+          command =  make_simple_command(:put, '{productId}/sku/{skuId}/user/{userId}', options)
           command.request_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation
           command.request_object = license_assignment_object
           command.response_representation = Google::Apis::LicensingV1::LicenseAssignment::Representation

data/generated/google/apis/logging_v1beta3.rb

@@ -20,16 +20,28 @@ module Google
   module Apis
     # Google Cloud Logging API
     #
-    # Google Cloud Logging API lets you create logs, ingest log entries, and manage
-    # log sinks.
+    # The Google Cloud Logging API lets you write log entries and manage your logs,
+    # log sinks and logs-based metrics.
     #
-    # @see 
+    # @see https://cloud.google.com/logging/docs/
     module LoggingV1beta3
       VERSION = 'V1beta3'
-      REVISION = '20150326'
+      REVISION = '20151117'
 
       # 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'
+
+      # Administrate log data for your projects
+      AUTH_LOGGING_ADMIN = 'https://www.googleapis.com/auth/logging.admin'
+
+      # View log data for your projects
+      AUTH_LOGGING_READ = 'https://www.googleapis.com/auth/logging.read'
+
+      # Submit log data for your projects
+      AUTH_LOGGING_WRITE = 'https://www.googleapis.com/auth/logging.write'
     end
   end
 end

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

@@ -26,7 +26,7 @@ module Google
       class ListLogsResponse
         include Google::Apis::Core::Hashable
       
-        # A list of log resources.
+        # A list of log descriptions matching the criteria.
         # Corresponds to the JSON property `logs`
         # @return [Array<Google::Apis::LoggingV1beta3::Log>]
         attr_accessor :logs
@@ -50,23 +50,26 @@ module Google
         end
       end
       
-      # A log object.
+      # _Output only._ Describes a log, which is a named stream of log entries.
       class Log
         include Google::Apis::Core::Hashable
       
-        # REQUIRED: The log's name name. Example: `"compute.googleapis.com/activity_log"`
-        # .
+        # The resource name of the log. Example: `"/projects/my-gcp-project-id/logs/
+        # LOG_NAME"`, where `LOG_NAME` is the URL-encoded given name of the log. The log
+        # includes those log entries whose `LogEntry.log` field contains this given name.
+        # To avoid name collisions, it is a best practice to prefix the given log name
+        # with the service name, but this is not required. Examples of log given names: `
+        # "appengine.googleapis.com/request_log"`, `"apache-access"`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Name used when displaying the log to the user (for example, in a UI). Example:
-        # `"activity_log"`
+        # _Optional._ The common name of the log. Example: `"request_log"`.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Type URL describing the expected payload type for the log.
+        # _Optional_. A URI representing the expected payload type for log entries.
         # Corresponds to the JSON property `payloadType`
         # @return [String]
         attr_accessor :payload_type
@@ -86,7 +89,8 @@ module Google
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # protobuf.Empty) returns (google.protobuf.Empty); `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -103,9 +107,11 @@ module Google
       class WriteLogEntriesRequest
         include Google::Apis::Core::Hashable
       
-        # Metadata labels that apply to all entries in this request. If one of the log
-        # entries contains a (key, value) with the same key that is in `commonLabels`,
-        # then the entry's (key, value) overrides the one in `commonLabels`.
+        # Metadata labels that apply to all log entries in this request, so that you don'
+        # t have to repeat them in each log entry's `metadata.labels` field. If any of
+        # the log entries contains a (key, value) with the same key that is in `
+        # commonLabels`, then the entry's (key, value) overrides the one in `
+        # commonLabels`.
         # Corresponds to the JSON property `commonLabels`
         # @return [Hash<String,String>]
         attr_accessor :common_labels
@@ -143,7 +149,7 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :proto_payload
       
-        # The log entry payload, represented as a text string.
+        # The log entry payload, represented as a Unicode string (UTF-8).
         # Corresponds to the JSON property `textPayload`
         # @return [String]
         attr_accessor :text_payload
@@ -167,6 +173,11 @@ module Google
         # @return [String]
         attr_accessor :log
       
+        # A common proto for logging HTTP requests.
+        # Corresponds to the JSON property `httpRequest`
+        # @return [Google::Apis::LoggingV1beta3::HttpRequest]
+        attr_accessor :http_request
+      
         def initialize(**args)
            update!(**args)
         end
@@ -179,6 +190,7 @@ module Google
           @struct_payload = args[:struct_payload] unless args[:struct_payload].nil?
           @insert_id = args[:insert_id] unless args[:insert_id].nil?
           @log = args[:log] unless args[:log].nil?
+          @http_request = args[:http_request] unless args[:http_request].nil?
         end
       end
       
@@ -259,6 +271,88 @@ module Google
         end
       end
       
+      # A common proto for logging HTTP requests.
+      class HttpRequest
+        include Google::Apis::Core::Hashable
+      
+        # Request method, such as `GET`, `HEAD`, `PUT` or `POST`.
+        # Corresponds to the JSON property `requestMethod`
+        # @return [String]
+        attr_accessor :request_method
+      
+        # Contains the scheme (http|https), the host name, the path and the query
+        # portion of the URL that was requested.
+        # Corresponds to the JSON property `requestUrl`
+        # @return [String]
+        attr_accessor :request_url
+      
+        # Size of the HTTP request message in bytes, including request headers and the
+        # request body.
+        # Corresponds to the JSON property `requestSize`
+        # @return [String]
+        attr_accessor :request_size
+      
+        # A response code indicates the status of response, e.g., 200.
+        # Corresponds to the JSON property `status`
+        # @return [Fixnum]
+        attr_accessor :status
+      
+        # Size of the HTTP response message in bytes sent back to the client, including
+        # response headers and response body.
+        # Corresponds to the JSON property `responseSize`
+        # @return [String]
+        attr_accessor :response_size
+      
+        # User agent sent by the client, e.g., "Mozilla/4.0 (compatible; MSIE 6.0;
+        # Windows 98; Q312461; .NET CLR 1.0.3705)".
+        # Corresponds to the JSON property `userAgent`
+        # @return [String]
+        attr_accessor :user_agent
+      
+        # IP address of the client who issues the HTTP request. Could be either IPv4 or
+        # IPv6.
+        # Corresponds to the JSON property `remoteIp`
+        # @return [String]
+        attr_accessor :remote_ip
+      
+        # Referer (a.k.a. referrer) URL of request, as defined in http://www.w3.org/
+        # Protocols/rfc2616/rfc2616-sec14.html.
+        # Corresponds to the JSON property `referer`
+        # @return [String]
+        attr_accessor :referer
+      
+        # Whether or not an entity was served from cache (with or without validation).
+        # Corresponds to the JSON property `cacheHit`
+        # @return [Boolean]
+        attr_accessor :cache_hit
+        alias_method :cache_hit?, :cache_hit
+      
+        # Whether or not the response was validated with the origin server before being
+        # served from cache. This field is only meaningful if cache_hit is True.
+        # Corresponds to the JSON property `validatedWithOriginServer`
+        # @return [Boolean]
+        attr_accessor :validated_with_origin_server
+        alias_method :validated_with_origin_server?, :validated_with_origin_server
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @request_method = args[:request_method] unless args[:request_method].nil?
+          @request_url = args[:request_url] unless args[:request_url].nil?
+          @request_size = args[:request_size] unless args[:request_size].nil?
+          @status = args[:status] unless args[:status].nil?
+          @response_size = args[:response_size] unless args[:response_size].nil?
+          @user_agent = args[:user_agent] unless args[:user_agent].nil?
+          @remote_ip = args[:remote_ip] unless args[:remote_ip].nil?
+          @referer = args[:referer] unless args[:referer].nil?
+          @cache_hit = args[:cache_hit] unless args[:cache_hit].nil?
+          @validated_with_origin_server = args[:validated_with_origin_server] unless args[:validated_with_origin_server].nil?
+        end
+      end
+      
       # Result returned from WriteLogEntries. empty
       class WriteLogEntriesResponse
         include Google::Apis::Core::Hashable
@@ -300,17 +394,24 @@ module Google
         end
       end
       
-      # A log service object.
+      # _Output only._ Describes a service that writes log entries.
       class LogService
         include Google::Apis::Core::Hashable
       
-        # The service's name.
+        # The service's name. Example: `"appengine.googleapis.com"`. Log names beginning
+        # with this string are reserved for this service. This value can appear in the `
+        # LogEntry.metadata.serviceName` field of log entries associated with this log
+        # service.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Label keys used when labeling log entries for this service. The order of the
-        # keys is significant, with higher priority keys coming earlier in the list.
+        # A list of the names of the keys used to index and label individual log entries
+        # from this service. The first two keys are used as the primary and secondary
+        # index, respectively. Additional keys may be used to label the entries. For
+        # example, App Engine indexes its entries by module and by version, so its `
+        # indexKeys` field is the following: [ "appengine.googleapis.com/module_id", "
+        # appengine.googleapis.com/version_id" ]
         # Corresponds to the JSON property `indexKeys`
         # @return [Array<String>]
         attr_accessor :index_keys
@@ -330,14 +431,16 @@ module Google
       class ListLogServiceIndexesResponse
         include Google::Apis::Core::Hashable
       
-        # A list of log service index prefixes.
+        # A list of log service index values. Each index value has the form `"/value1/
+        # value2/..."`, where `value1` is a value in the primary index, `value2` is a
+        # value in the secondary index, and so forth.
         # Corresponds to the JSON property `serviceIndexPrefixes`
         # @return [Array<String>]
         attr_accessor :service_index_prefixes
       
         # If there are more results, then `nextPageToken` is returned in the response.
         # To get the next batch of indexes, use the value of `nextPageToken` as `
-        # pageToken` in the next call of `ListLogServiceIndexess`. If `nextPageToken` is
+        # pageToken` in the next call of `ListLogServiceIndexes`. If `nextPageToken` is
         # empty, then there are no more results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
@@ -358,9 +461,9 @@ module Google
       class ListLogSinksResponse
         include Google::Apis::Core::Hashable
       
-        # The requested log sinks. If any of the returned `LogSink` objects have an
-        # empty `destination` field, then call `logServices.sinks.get` to retrieve the
-        # complete `LogSink` object.
+        # The requested log sinks. If a returned `LogSink` object has an empty `
+        # destination` field, the client can retrieve the complete `LogSink` object by
+        # calling `log.sinks.get`.
         # Corresponds to the JSON property `sinks`
         # @return [Array<Google::Apis::LoggingV1beta3::LogSink>]
         attr_accessor :sinks
@@ -375,26 +478,32 @@ module Google
         end
       end
       
-      # An object that describes where a log may be written.
+      # Describes where log entries are written outside of Cloud Logging.
       class LogSink
         include Google::Apis::Core::Hashable
       
-        # The name of this sink. This is a client-assigned identifier for the resource.
-        # This is ignored by UpdateLogSink and UpdateLogServicesSink.
+        # The client-assigned name of this sink. For example, `"my-syslog-sink"`. The
+        # name must be unique among the sinks of a similar kind in the project.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The resource to send log entries to. The supported sink resource types are: +
-        # Google Cloud Storage: `storage.googleapis.com/BUCKET` or `BUCKET.storage.
-        # googleapis.com/` + Google BigQuery: `bigquery.googleapis.com/projects/PROJECT/
-        # datasets/DATASET` Currently the Cloud Logging API supports at most one sink
-        # for each resource type per log or log service resource.
+        # The resource name of the destination. Cloud Logging writes designated log
+        # entries to this destination. For example, `"storage.googleapis.com/my-output-
+        # bucket"`.
         # Corresponds to the JSON property `destination`
         # @return [String]
         attr_accessor :destination
       
-        # _Output only._ All active errors found for this sink.
+        # An advanced logs filter. If present, only log entries matching the filter are
+        # written. Only project sinks use this field; log sinks and log service sinks
+        # must not include a filter.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        # _Output only._ If any errors occur when invoking a sink method, then this
+        # field contains descriptions of the errors.
         # Corresponds to the JSON property `errors`
         # @return [Array<Google::Apis::LoggingV1beta3::LogError>]
         attr_accessor :errors
@@ -407,28 +516,59 @@ module Google
         def update!(**args)
           @name = args[:name] unless args[:name].nil?
           @destination = args[:destination] unless args[:destination].nil?
+          @filter = args[:filter] unless args[:filter].nil?
           @errors = args[:errors] unless args[:errors].nil?
         end
       end
       
-      # A problem in a sink or the sink's configuration.
+      # Describes a problem with a logging resource or operation.
       class LogError
         include Google::Apis::Core::Hashable
       
-        # The resource associated with the error. It may be different from the sink
-        # destination. For example, the sink may point to a BigQuery dataset, but the
-        # error may refer to a table resource inside the dataset.
+        # A resource name associated with this error. For example, the name of a Cloud
+        # Storage bucket that has insufficient permissions to be a destination for log
+        # entries.
         # Corresponds to the JSON property `resource`
         # @return [String]
         attr_accessor :resource
       
-        # Represents the RPC error status for Google APIs. See http://go/errormodel for
-        # details.
+        # 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.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::LoggingV1beta3::Status]
         attr_accessor :status
       
-        # The last time the error was observed, in nanoseconds since the Unix epoch.
+        # The time the error was observed, in nanoseconds since the Unix epoch.
         # Corresponds to the JSON property `timeNanos`
         # @return [String]
         attr_accessor :time_nanos
@@ -445,19 +585,49 @@ module Google
         end
       end
       
-      # Represents the RPC error status for Google APIs. See http://go/errormodel for
-      # details.
+      # 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.
       class Status
         include Google::Apis::Core::Hashable
       
-        # The status code, which should be an enum value of [google.rpc.Code][].
+        # The status code, which should be an enum value of google.rpc.Code.
         # Corresponds to the JSON property `code`
         # @return [Fixnum]
         attr_accessor :code
       
-        # A developer-facing error message, which should be in English. The user-facing
-        # error message should be localized and stored in the [google.rpc.Status.details]
-        # [google.rpc.Status.details] field.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -484,9 +654,9 @@ module Google
       class ListLogServiceSinksResponse
         include Google::Apis::Core::Hashable
       
-        # The requested log service sinks. If any of the returned `LogSink` objects have
-        # an empty `destination` field, then call `logServices.sinks.get` to retrieve
-        # the complete `LogSink` object.
+        # The requested log service sinks. If a returned `LogSink` object has an empty `
+        # destination` field, the client can retrieve the complete `LogSink` object by
+        # calling `logServices.sinks.get`.
         # Corresponds to the JSON property `sinks`
         # @return [Array<Google::Apis::LoggingV1beta3::LogSink>]
         attr_accessor :sinks
@@ -500,6 +670,410 @@ module Google
           @sinks = args[:sinks] unless args[:sinks].nil?
         end
       end
+      
+      # Result returned from `ListSinks`.
+      class ListSinksResponse
+        include Google::Apis::Core::Hashable
+      
+        # The requested sinks. If a returned `LogSink` object has an empty `destination`
+        # field, the client can retrieve the complete `LogSink` object by calling `
+        # projects.sinks.get`.
+        # Corresponds to the JSON property `sinks`
+        # @return [Array<Google::Apis::LoggingV1beta3::LogSink>]
+        attr_accessor :sinks
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sinks = args[:sinks] unless args[:sinks].nil?
+        end
+      end
+      
+      # Result returned from ListLogMetrics.
+      class ListLogMetricsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of metrics that was requested.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::LoggingV1beta3::LogMetric>]
+        attr_accessor :metrics
+      
+        # If there are more results, then `nextPageToken` is returned in the response.
+        # To get the next batch of entries, use the value of `nextPageToken` as `
+        # pageToken` in the next call of `ListLogMetrics`. If `nextPageToken` is empty,
+        # then there are no more 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)
+          @metrics = args[:metrics] unless args[:metrics].nil?
+          @next_page_token = args[:next_page_token] unless args[:next_page_token].nil?
+        end
+      end
+      
+      # Describes a logs-based metric. The value of the metric is the number of log
+      # entries in your project that match a logs filter.
+      class LogMetric
+        include Google::Apis::Core::Hashable
+      
+        # The client-assigned name for this metric, such as `"severe_errors"`. Metric
+        # names are limited to 1000 characters and can include only the following
+        # characters: `A-Z`, `a-z`, `0-9`, and the special characters `_-.,+!*',()%/\`.
+        # The slash character (`/`) denotes a hierarchy of name pieces, and it cannot be
+        # the first character of the name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A description of this metric.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # An [advanced logs filter](/logging/docs/view/advanced_filters). Example: `"log:
+        # syslog AND metadata.severity>=ERROR"`.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] unless args[:name].nil?
+          @description = args[:description] unless args[:description].nil?
+          @filter = args[:filter] unless args[:filter].nil?
+        end
+      end
+      
+      # Complete log information about a single request to an application.
+      class RequestLog
+        include Google::Apis::Core::Hashable
+      
+        # Identifies the application that handled this request.
+        # Corresponds to the JSON property `appId`
+        # @return [String]
+        attr_accessor :app_id
+      
+        # Identifies the module of the application that handled this request.
+        # Corresponds to the JSON property `moduleId`
+        # @return [String]
+        attr_accessor :module_id
+      
+        # Version of the application that handled this request.
+        # Corresponds to the JSON property `versionId`
+        # @return [String]
+        attr_accessor :version_id
+      
+        # Globally unique identifier for a request, based on request start time. Request
+        # IDs for requests which started later will compare greater as strings than
+        # those for requests which started earlier.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        # Origin IP address.
+        # Corresponds to the JSON property `ip`
+        # @return [String]
+        attr_accessor :ip
+      
+        # Time at which request was known to have begun processing.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # Time at which request was known to end processing.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Latency of the request.
+        # Corresponds to the JSON property `latency`
+        # @return [String]
+        attr_accessor :latency
+      
+        # Number of CPU megacycles used to process request.
+        # Corresponds to the JSON property `megaCycles`
+        # @return [String]
+        attr_accessor :mega_cycles
+      
+        # Request method, such as `GET`, `HEAD`, `PUT`, `POST`, or `DELETE`.
+        # Corresponds to the JSON property `method`
+        # @return [String]
+        attr_accessor :method_prop
+      
+        # Contains the path and query portion of the URL that was requested. For example,
+        # if the URL was "http://example.com/app?name=val", the resource would be "/app?
+        # name=val". Any trailing fragment (separated by a '#' character) will not be
+        # included.
+        # Corresponds to the JSON property `resource`
+        # @return [String]
+        attr_accessor :resource
+      
+        # HTTP version of request.
+        # Corresponds to the JSON property `httpVersion`
+        # @return [String]
+        attr_accessor :http_version
+      
+        # Response status of request.
+        # Corresponds to the JSON property `status`
+        # @return [Fixnum]
+        attr_accessor :status
+      
+        # Size in bytes sent back to client by request.
+        # Corresponds to the JSON property `responseSize`
+        # @return [String]
+        attr_accessor :response_size
+      
+        # Referrer URL of request.
+        # Corresponds to the JSON property `referrer`
+        # @return [String]
+        attr_accessor :referrer
+      
+        # User agent used for making request.
+        # Corresponds to the JSON property `userAgent`
+        # @return [String]
+        attr_accessor :user_agent
+      
+        # A string that identifies a logged-in user who made this request, or empty if
+        # the user is not logged in. Most likely, this is the part of the user's email
+        # before the '@' sign. The field value is the same for different requests from
+        # the same user, but different users may have a similar name. This information
+        # is also available to the application via Users API. This field will be
+        # populated starting with App Engine 1.9.21.
+        # Corresponds to the JSON property `nickname`
+        # @return [String]
+        attr_accessor :nickname
+      
+        # File or class within URL mapping used for request. Useful for tracking down
+        # the source code which was responsible for managing request. Especially for
+        # multiply mapped handlers.
+        # Corresponds to the JSON property `urlMapEntry`
+        # @return [String]
+        attr_accessor :url_map_entry
+      
+        # The Internet host and port number of the resource being requested.
+        # Corresponds to the JSON property `host`
+        # @return [String]
+        attr_accessor :host
+      
+        # An indication of the relative cost of serving this request.
+        # Corresponds to the JSON property `cost`
+        # @return [Float]
+        attr_accessor :cost
+      
+        # Queue name of the request (for an offline request).
+        # Corresponds to the JSON property `taskQueueName`
+        # @return [String]
+        attr_accessor :task_queue_name
+      
+        # Task name of the request (for an offline request).
+        # Corresponds to the JSON property `taskName`
+        # @return [String]
+        attr_accessor :task_name
+      
+        # Was this request a loading request for this instance?
+        # Corresponds to the JSON property `wasLoadingRequest`
+        # @return [Boolean]
+        attr_accessor :was_loading_request
+        alias_method :was_loading_request?, :was_loading_request
+      
+        # Time this request spent in the pending request queue, if it was pending at all.
+        # Corresponds to the JSON property `pendingTime`
+        # @return [String]
+        attr_accessor :pending_time
+      
+        # If the instance that processed this request was individually addressable (i.e.
+        # belongs to a manually scaled module), this is the index of the instance.
+        # Corresponds to the JSON property `instanceIndex`
+        # @return [Fixnum]
+        attr_accessor :instance_index
+      
+        # If true, represents a finished request. Otherwise, the request is active.
+        # Corresponds to the JSON property `finished`
+        # @return [Boolean]
+        attr_accessor :finished
+        alias_method :finished?, :finished
+      
+        # An opaque identifier for the instance that handled the request.
+        # Corresponds to the JSON property `instanceId`
+        # @return [String]
+        attr_accessor :instance_id
+      
+        # List of log lines emitted by the application while serving this request, if
+        # requested.
+        # Corresponds to the JSON property `line`
+        # @return [Array<Google::Apis::LoggingV1beta3::LogLine>]
+        attr_accessor :line
+      
+        # App Engine release version string.
+        # Corresponds to the JSON property `appEngineRelease`
+        # @return [String]
+        attr_accessor :app_engine_release
+      
+        # Cloud Trace identifier of the trace for this request.
+        # Corresponds to the JSON property `traceId`
+        # @return [String]
+        attr_accessor :trace_id
+      
+        # Source code for the application that handled this request. There can be more
+        # than one source reference per deployed application if source code is
+        # distributed among multiple repositories.
+        # Corresponds to the JSON property `sourceReference`
+        # @return [Array<Google::Apis::LoggingV1beta3::SourceReference>]
+        attr_accessor :source_reference
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @app_id = args[:app_id] unless args[:app_id].nil?
+          @module_id = args[:module_id] unless args[:module_id].nil?
+          @version_id = args[:version_id] unless args[:version_id].nil?
+          @request_id = args[:request_id] unless args[:request_id].nil?
+          @ip = args[:ip] unless args[:ip].nil?
+          @start_time = args[:start_time] unless args[:start_time].nil?
+          @end_time = args[:end_time] unless args[:end_time].nil?
+          @latency = args[:latency] unless args[:latency].nil?
+          @mega_cycles = args[:mega_cycles] unless args[:mega_cycles].nil?
+          @method_prop = args[:method_prop] unless args[:method_prop].nil?
+          @resource = args[:resource] unless args[:resource].nil?
+          @http_version = args[:http_version] unless args[:http_version].nil?
+          @status = args[:status] unless args[:status].nil?
+          @response_size = args[:response_size] unless args[:response_size].nil?
+          @referrer = args[:referrer] unless args[:referrer].nil?
+          @user_agent = args[:user_agent] unless args[:user_agent].nil?
+          @nickname = args[:nickname] unless args[:nickname].nil?
+          @url_map_entry = args[:url_map_entry] unless args[:url_map_entry].nil?
+          @host = args[:host] unless args[:host].nil?
+          @cost = args[:cost] unless args[:cost].nil?
+          @task_queue_name = args[:task_queue_name] unless args[:task_queue_name].nil?
+          @task_name = args[:task_name] unless args[:task_name].nil?
+          @was_loading_request = args[:was_loading_request] unless args[:was_loading_request].nil?
+          @pending_time = args[:pending_time] unless args[:pending_time].nil?
+          @instance_index = args[:instance_index] unless args[:instance_index].nil?
+          @finished = args[:finished] unless args[:finished].nil?
+          @instance_id = args[:instance_id] unless args[:instance_id].nil?
+          @line = args[:line] unless args[:line].nil?
+          @app_engine_release = args[:app_engine_release] unless args[:app_engine_release].nil?
+          @trace_id = args[:trace_id] unless args[:trace_id].nil?
+          @source_reference = args[:source_reference] unless args[:source_reference].nil?
+        end
+      end
+      
+      # Application log line emitted while processing a request.
+      class LogLine
+        include Google::Apis::Core::Hashable
+      
+        # Time when log entry was made. May be inaccurate.
+        # Corresponds to the JSON property `time`
+        # @return [String]
+        attr_accessor :time
+      
+        # Severity of log.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # App provided log message.
+        # Corresponds to the JSON property `logMessage`
+        # @return [String]
+        attr_accessor :log_message
+      
+        # Specifies a location in a source file.
+        # Corresponds to the JSON property `sourceLocation`
+        # @return [Google::Apis::LoggingV1beta3::SourceLocation]
+        attr_accessor :source_location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @time = args[:time] unless args[:time].nil?
+          @severity = args[:severity] unless args[:severity].nil?
+          @log_message = args[:log_message] unless args[:log_message].nil?
+          @source_location = args[:source_location] unless args[:source_location].nil?
+        end
+      end
+      
+      # Specifies a location in a source file.
+      class SourceLocation
+        include Google::Apis::Core::Hashable
+      
+        # Source file name. May or may not be a fully qualified name, depending on the
+        # runtime environment.
+        # Corresponds to the JSON property `file`
+        # @return [String]
+        attr_accessor :file
+      
+        # Line within the source file.
+        # Corresponds to the JSON property `line`
+        # @return [String]
+        attr_accessor :line
+      
+        # Human-readable name of the function or method being invoked, with optional
+        # context such as the class or package name, for use in contexts such as the
+        # logs viewer where file:line number is less meaningful. This may vary by
+        # language, for example: in Java: qual.if.ied.Class.method in Go: dir/package.
+        # func in Python: function ...
+        # Corresponds to the JSON property `functionName`
+        # @return [String]
+        attr_accessor :function_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @file = args[:file] unless args[:file].nil?
+          @line = args[:line] unless args[:line].nil?
+          @function_name = args[:function_name] unless args[:function_name].nil?
+        end
+      end
+      
+      # A reference to a particular snapshot of the source tree used to build and
+      # deploy an application.
+      class SourceReference
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A URI string identifying the repository. Example: "https://github.
+        # com/GoogleCloudPlatform/kubernetes.git"
+        # Corresponds to the JSON property `repository`
+        # @return [String]
+        attr_accessor :repository
+      
+        # The canonical (and persistent) identifier of the deployed revision. Example (
+        # git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
+        # Corresponds to the JSON property `revisionId`
+        # @return [String]
+        attr_accessor :revision_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @repository = args[:repository] unless args[:repository].nil?
+          @revision_id = args[:revision_id] unless args[:revision_id].nil?
+        end
+      end
     end
   end
 end