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

data/generated/google/apis/cloudtrace_v1.rb

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

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

@@ -0,0 +1,188 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudtraceV1
+      
+      # The response message for the `ListTraces` method.
+      class ListTracesResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of trace records returned.
+        # Corresponds to the JSON property `traces`
+        # @return [Array<Google::Apis::CloudtraceV1::Trace>]
+        attr_accessor :traces
+      
+        # If defined, indicates that there are more traces that match the request and
+        # that this value should be passed to the next request to continue retrieving
+        # additional traces.
+        # 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)
+          @traces = args[:traces] unless args[:traces].nil?
+          @next_page_token = args[:next_page_token] unless args[:next_page_token].nil?
+        end
+      end
+      
+      # A trace describes how long it takes for an application to perform an operation.
+      # It consists of a set of spans, each of which represent a single timed event
+      # within the operation.
+      class Trace
+        include Google::Apis::Core::Hashable
+      
+        # Project ID of the Cloud project where the trace data is stored.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
+        # Globally unique identifier for the trace. This identifier is a 128-bit numeric
+        # value formatted as a 32-byte hex string.
+        # Corresponds to the JSON property `traceId`
+        # @return [String]
+        attr_accessor :trace_id
+      
+        # Collection of spans in the trace.
+        # Corresponds to the JSON property `spans`
+        # @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
+        attr_accessor :spans
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @project_id = args[:project_id] unless args[:project_id].nil?
+          @trace_id = args[:trace_id] unless args[:trace_id].nil?
+          @spans = args[:spans] unless args[:spans].nil?
+        end
+      end
+      
+      # A span represents a single timed event within a trace. Spans can be nested and
+      # form a trace tree. Often, a trace contains a root span that describes the end-
+      # to-end latency of an operation and, optionally, one or more subspans for its
+      # suboperations. Spans do not need to be contiguous. There may be gaps between
+      # spans in a trace.
+      class TraceSpan
+        include Google::Apis::Core::Hashable
+      
+        # Identifier for the span. This identifier must be unique within a trace.
+        # Corresponds to the JSON property `spanId`
+        # @return [String]
+        attr_accessor :span_id
+      
+        # Distinguishes between spans generated in a particular context. For example,
+        # two spans with the same name may be distinguished using `RPC_CLIENT` and `
+        # RPC_SERVER` to identify queueing latency associated with the span.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Name of the trace. The trace name is sanitized and displayed in the Cloud
+        # Trace tool in the Google Developers Console. The name may be a method name or
+        # some other per-call site name. For the same executable and the same call point,
+        # a best practice is to use a consistent name, which makes it easier to
+        # correlate cross-trace spans.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Start time of the span in nanoseconds from the UNIX epoch.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # End time of the span in nanoseconds from the UNIX epoch.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # ID of the parent span, if any. Optional.
+        # Corresponds to the JSON property `parentSpanId`
+        # @return [String]
+        attr_accessor :parent_span_id
+      
+        # Collection of labels associated with the span.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @span_id = args[:span_id] unless args[:span_id].nil?
+          @kind = args[:kind] unless args[:kind].nil?
+          @name = args[:name] unless args[:name].nil?
+          @start_time = args[:start_time] unless args[:start_time].nil?
+          @end_time = args[:end_time] unless args[:end_time].nil?
+          @parent_span_id = args[:parent_span_id] unless args[:parent_span_id].nil?
+          @labels = args[:labels] unless args[:labels].nil?
+        end
+      end
+      
+      # List of new or updated traces.
+      class Traces
+        include Google::Apis::Core::Hashable
+      
+        # List of traces.
+        # Corresponds to the JSON property `traces`
+        # @return [Array<Google::Apis::CloudtraceV1::Trace>]
+        attr_accessor :traces
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @traces = args[:traces] unless args[:traces].nil?
+        end
+      end
+      
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
+      class Empty
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,92 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudtraceV1
+      
+      class ListTracesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Trace
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class TraceSpan
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Traces
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Empty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListTracesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Trace
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :project_id, as: 'projectId'
+          property :trace_id, as: 'traceId'
+          collection :spans, as: 'spans', class: Google::Apis::CloudtraceV1::TraceSpan, decorator: Google::Apis::CloudtraceV1::TraceSpan::Representation
+      
+        end
+      end
+      
+      class TraceSpan
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :span_id, as: 'spanId'
+          property :kind, as: 'kind'
+          property :name, as: 'name'
+          property :start_time, as: 'startTime'
+          property :end_time, as: 'endTime'
+          property :parent_span_id, as: 'parentSpanId'
+          hash :labels, as: 'labels'
+        end
+      end
+      
+      class Traces
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
+      
+        end
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,190 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudtraceV1
+      # Google Cloud Trace API
+      #
+      # The Cloud Trace API allows you to send traces to and retrieve traces from
+      #  Google Cloud Trace.
+      #
+      # @example
+      #    require 'google/apis/cloudtrace_v1'
+      #
+      #    Cloudtrace = Google::Apis::CloudtraceV1 # Alias the module
+      #    service = Cloudtrace::CloudtraceService.new
+      #
+      # @see https://cloud.google.com/tools/cloud-trace
+      class CloudtraceService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://cloudtrace.googleapis.com/', '')
+        end
+        
+        # Sends new traces to Cloud Trace or updates existing traces. If the ID of a
+        # trace that you send matches that of an existing trace, any fields in the
+        # existing trace and its spans are overwritten by the provided values, and any
+        # new fields provided are merged with the existing trace data. If the ID does
+        # not match, a new trace is created.
+        # @param [String] project_id
+        #   ID of the Cloud project where the trace data is stored.
+        # @param [Google::Apis::CloudtraceV1::Traces] traces_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudtraceV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV1::Empty]
+        #
+        # @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 patch_project_traces(project_id, traces_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/projects/{projectId}/traces', options)
+          command.request_representation = Google::Apis::CloudtraceV1::Traces::Representation
+          command.request_object = traces_object
+          command.response_representation = Google::Apis::CloudtraceV1::Empty::Representation
+          command.response_class = Google::Apis::CloudtraceV1::Empty
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns of a list of traces that match the specified filter conditions.
+        # @param [String] project_id
+        #   ID of the Cloud project where the trace data is stored.
+        # @param [String] view
+        #   Type of data returned for traces in the list. Optional. Default is `MINIMAL`.
+        # @param [Fixnum] page_size
+        #   Maximum number of traces to return. If not specified or <= 0, the
+        #   implementation selects a reasonable value. The implementation may return fewer
+        #   traces than the requested page size. Optional.
+        # @param [String] page_token
+        #   Token identifying the page of results to return. If provided, use the value of
+        #   the `next_page_token` field from a previous request. Optional.
+        # @param [String] start_time
+        #   End of the time interval (inclusive) during which the trace data was collected
+        #   from the application.
+        # @param [String] end_time
+        #   Start of the time interval (inclusive) during which the trace data was
+        #   collected from the application.
+        # @param [String] filter
+        #   An optional filter for the request.
+        # @param [String] order_by
+        #   Field used to sort the returned traces. Optional. Can be one of the following:
+        #   * `trace_id` * `name` (`name` field of root span in the trace) * `duration` (
+        #   difference between `end_time` and `start_time` fields of the root span) * `
+        #   start` (`start_time` field of the root span) Descending order can be specified
+        #   by appending `desc` to the sort field (for example, `name desc`). Only one
+        #   sort field is permitted.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudtraceV1::ListTracesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV1::ListTracesResponse]
+        #
+        # @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_project_traces(project_id, view: nil, page_size: nil, page_token: nil, start_time: nil, end_time: nil, filter: nil, order_by: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/projects/{projectId}/traces', options)
+          command.response_representation = Google::Apis::CloudtraceV1::ListTracesResponse::Representation
+          command.response_class = Google::Apis::CloudtraceV1::ListTracesResponse
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a single trace by its ID.
+        # @param [String] project_id
+        #   ID of the Cloud project where the trace data is stored.
+        # @param [String] trace_id
+        #   ID of the trace to return.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudtraceV1::Trace] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV1::Trace]
+        #
+        # @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_project_trace(project_id, trace_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/projects/{projectId}/traces/{traceId}', options)
+          command.response_representation = Google::Apis::CloudtraceV1::Trace::Representation
+          command.response_class = Google::Apis::CloudtraceV1::Trace
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.params['traceId'] = trace_id unless trace_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end