google-api-client 0.32.1 → 0.40.0

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

@@ -0,0 +1,143 @@
+# 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 CloudtraceV2beta1
+      
+      # 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
+      
+      # Result returned from `ListTraceSinks`.
+      class ListTraceSinksResponse
+        include Google::Apis::Core::Hashable
+      
+        # If there might be more results than appear in this response, then
+        # `nextPageToken` is included.  To get the next set of results, call the same
+        # method again using the value of `nextPageToken` as `pageToken`.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A list of sinks.
+        # Corresponds to the JSON property `sinks`
+        # @return [Array<Google::Apis::CloudtraceV2beta1::TraceSink>]
+        attr_accessor :sinks
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @sinks = args[:sinks] if args.key?(:sinks)
+        end
+      end
+      
+      # OutputConfig contains a destination for writing trace data.
+      class OutputConfig
+        include Google::Apis::Core::Hashable
+      
+        # The destination for writing trace data. Currently only BigQuery is
+        # supported. E.g.:
+        # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+        # Corresponds to the JSON property `destination`
+        # @return [String]
+        attr_accessor :destination
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @destination = args[:destination] if args.key?(:destination)
+        end
+      end
+      
+      # Describes a sink used to export traces to a BigQuery dataset. The sink must
+      # be created within a project.
+      class TraceSink
+        include Google::Apis::Core::Hashable
+      
+        # Required. The canonical sink resource name, unique within the project. Must be
+        # of the
+        # form:
+        # project/[PROJECT_NUMBER]/traceSinks/[SINK_ID].
+        # E.g.:
+        # `"projects/12345/traceSinks/my-project-trace-sink"`.
+        # Sink identifiers are limited to 256 characters and can include only the
+        # following characters: upper and lower-case alphanumeric characters,
+        # underscores, hyphens, and periods.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # OutputConfig contains a destination for writing trace data.
+        # Corresponds to the JSON property `outputConfig`
+        # @return [Google::Apis::CloudtraceV2beta1::OutputConfig]
+        attr_accessor :output_config
+      
+        # Output only. A service account name for exporting the data. This field is
+        # set by sinks.create and sinks.update. The service account will need to be
+        # granted write access to the destination specified in the output
+        # configuration, see [Granting access for a
+        # resource](/iam/docs/granting-roles-to-service-accounts#
+        # granting_access_to_a_service_account_for_a_resource).
+        # To create tables and write data this account will need the dataEditor role.
+        # Read more about roles in the [BigQuery
+        # documentation](https://cloud.google.com/bigquery/docs/access-control).
+        # E.g.:
+        # "service-00000001@00000002.iam.gserviceaccount.com"
+        # Corresponds to the JSON property `writerIdentity`
+        # @return [String]
+        attr_accessor :writer_identity
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @output_config = args[:output_config] if args.key?(:output_config)
+          @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/{oauth2_v1 → cloudtrace_v2beta1}/representations.rb

@@ -20,52 +20,61 @@ require 'google/apis/errors'
 
 module Google
   module Apis
-    module Oauth2V1
+    module CloudtraceV2beta1
       
-      class Tokeninfo
+      class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Userinfoplus
+      class ListTraceSinksResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Tokeninfo
+      class OutputConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TraceSink
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class ListTraceSinksResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :access_type, as: 'access_type'
-          property :audience, as: 'audience'
-          property :email, as: 'email'
-          property :email_verified, as: 'email_verified'
-          property :expires_in, as: 'expires_in'
-          property :issued_at, as: 'issued_at'
-          property :issued_to, as: 'issued_to'
-          property :issuer, as: 'issuer'
-          property :nonce, as: 'nonce'
-          property :scope, as: 'scope'
-          property :user_id, as: 'user_id'
-          property :verified_email, as: 'verified_email'
+          property :next_page_token, as: 'nextPageToken'
+          collection :sinks, as: 'sinks', class: Google::Apis::CloudtraceV2beta1::TraceSink, decorator: Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+      
         end
       end
       
-      class Userinfoplus
+      class OutputConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :destination, as: 'destination'
+        end
+      end
+      
+      class TraceSink
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :email, as: 'email'
-          property :family_name, as: 'family_name'
-          property :gender, as: 'gender'
-          property :given_name, as: 'given_name'
-          property :hd, as: 'hd'
-          property :id, as: 'id'
-          property :link, as: 'link'
-          property :locale, as: 'locale'
           property :name, as: 'name'
-          property :picture, as: 'picture'
-          property :verified_email, as: 'verified_email'
+          property :output_config, as: 'outputConfig', class: Google::Apis::CloudtraceV2beta1::OutputConfig, decorator: Google::Apis::CloudtraceV2beta1::OutputConfig::Representation
+      
+          property :writer_identity, as: 'writerIdentity'
         end
       end
     end

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

@@ -0,0 +1,258 @@
+# 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 CloudtraceV2beta1
+      # Cloud Trace API
+      #
+      # Sends application trace data to Cloud Trace for viewing. Trace data is
+      #  collected for all App Engine applications by default. Trace data from other
+      #  applications can be provided using this API. This library is used to interact
+      #  with the Cloud Trace API directly. If you are looking to instrument your
+      #  application for Cloud Trace, we recommend using OpenCensus.
+      #
+      # @example
+      #    require 'google/apis/cloudtrace_v2beta1'
+      #
+      #    Cloudtrace = Google::Apis::CloudtraceV2beta1 # Alias the module
+      #    service = Cloudtrace::CloudTraceService.new
+      #
+      # @see https://cloud.google.com/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/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Creates a sink that exports trace spans to a destination.  The
+        # export of newly-ingested traces begins immediately, unless the sink's
+        # `writer_identity` is not permitted to write to the destination.  A sink can
+        # export traces only from the resource owning the sink (the 'parent').
+        # @param [String] parent
+        #   Required. The resource in which to create the sink (currently only project
+        #   sinks are supported):
+        #   "projects/[PROJECT_ID]"
+        #   Examples: `"projects/my-trace-project"`, `"projects/123456789"`.
+        # @param [Google::Apis::CloudtraceV2beta1::TraceSink] trace_sink_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::CloudtraceV2beta1::TraceSink] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV2beta1::TraceSink]
+        #
+        # @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 create_project_trace_sink(parent, trace_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2beta1/{+parent}/traceSinks', options)
+          command.request_representation = Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+          command.request_object = trace_sink_object
+          command.response_representation = Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+          command.response_class = Google::Apis::CloudtraceV2beta1::TraceSink
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a sink.
+        # @param [String] name
+        #   Required. The full resource name of the sink to delete, including the
+        #   parent resource and the sink identifier:
+        #   "projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]"
+        #   Example: `"projects/12345/traceSinks/my-sink-id"`.
+        # @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::CloudtraceV2beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV2beta1::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 delete_project_trace_sink(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v2beta1/{+name}', options)
+          command.response_representation = Google::Apis::CloudtraceV2beta1::Empty::Representation
+          command.response_class = Google::Apis::CloudtraceV2beta1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Get a trace sink by name under the parent resource (GCP project).
+        # @param [String] name
+        #   Required. The resource name of the sink:
+        #   "projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]"
+        #   Example: `"projects/12345/traceSinks/my-sink-id"`.
+        # @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::CloudtraceV2beta1::TraceSink] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV2beta1::TraceSink]
+        #
+        # @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_sink(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2beta1/{+name}', options)
+          command.response_representation = Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+          command.response_class = Google::Apis::CloudtraceV2beta1::TraceSink
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List all sinks for the parent resource (GCP project).
+        # @param [String] parent
+        #   Required. The parent resource whose sinks are to be listed (currently only
+        #   project parent resources are supported):
+        #   "projects/[PROJECT_ID]"
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request.
+        #   Non-positive values are ignored.  The presence of `nextPageToken` in the
+        #   response indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method.  `pageToken` must be the value of
+        #   `nextPageToken` from the previous response.  The values of other method
+        #   parameters should be identical to those in the previous call.
+        # @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::CloudtraceV2beta1::ListTraceSinksResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV2beta1::ListTraceSinksResponse]
+        #
+        # @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_trace_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2beta1/{+parent}/traceSinks', options)
+          command.response_representation = Google::Apis::CloudtraceV2beta1::ListTraceSinksResponse::Representation
+          command.response_class = Google::Apis::CloudtraceV2beta1::ListTraceSinksResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a sink.  This method updates fields in the existing sink according
+        # to the provided update mask. The sink's name cannot be changed nor any
+        # output-only fields (e.g. the writer_identity).
+        # @param [String] name
+        #   Required. The full resource name of the sink to update, including the
+        #   parent resource and the sink identifier:
+        #   "projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]"
+        #   Example: `"projects/12345/traceSinks/my-sink-id"`.
+        # @param [Google::Apis::CloudtraceV2beta1::TraceSink] trace_sink_object
+        # @param [String] update_mask
+        #   Required. Field mask that specifies the fields in `trace_sink` that are to
+        #   be updated. A sink field is overwritten if, and only if, it is
+        #   in the update mask.  `name` and `writer_identity` fields cannot be updated.
+        #   An empty updateMask is considered an error.
+        #   For a detailed `FieldMask` definition, see
+        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   fieldmask
+        #   Example: `updateMask=output_config`.
+        # @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::CloudtraceV2beta1::TraceSink] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtraceV2beta1::TraceSink]
+        #
+        # @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_trace_sink(name, trace_sink_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2beta1/{+name}', options)
+          command.request_representation = Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+          command.request_object = trace_sink_object
+          command.response_representation = Google::Apis::CloudtraceV2beta1::TraceSink::Representation
+          command.response_class = Google::Apis::CloudtraceV2beta1::TraceSink
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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

data/generated/google/apis/cloudtrace_v2beta1.rb

@@ -0,0 +1,44 @@
+# 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_v2beta1/service.rb'
+require 'google/apis/cloudtrace_v2beta1/classes.rb'
+require 'google/apis/cloudtrace_v2beta1/representations.rb'
+
+module Google
+  module Apis
+    # Cloud Trace API
+    #
+    # Sends application trace data to Cloud Trace for viewing. Trace data is
+    # collected for all App Engine applications by default. Trace data from other
+    # applications can be provided using this API. This library is used to interact
+    # with the Cloud Trace API directly. If you are looking to instrument your
+    # application for Cloud Trace, we recommend using OpenCensus.
+    #
+    # @see https://cloud.google.com/trace
+    module CloudtraceV2beta1
+      VERSION = 'V2beta1'
+      REVISION = '20200330'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # Write Trace data for a project or application
+      AUTH_TRACE_APPEND = 'https://www.googleapis.com/auth/trace.append'
+
+      # Read Trace data for a project or application
+      AUTH_TRACE_READONLY = 'https://www.googleapis.com/auth/trace.readonly'
+    end
+  end
+end