google-api-client 0.42.0 → 0.43.0

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

@@ -0,0 +1,405 @@
+# 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 ServicecontrolV2
+      
+      class Api
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AttributeContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AuditLog
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Auth
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AuthenticationInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AuthorizationInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CheckRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CheckResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FirstPartyPrincipal
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Peer
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ReportRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ReportResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Request
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RequestMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Resource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ResourceInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ResourceLocation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Response
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ServiceAccountDelegationInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SpanContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Status
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ThirdPartyPrincipal
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Api
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :operation, as: 'operation'
+          property :protocol, as: 'protocol'
+          property :service, as: 'service'
+          property :version, as: 'version'
+        end
+      end
+      
+      class AttributeContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :api, as: 'api', class: Google::Apis::ServicecontrolV2::Api, decorator: Google::Apis::ServicecontrolV2::Api::Representation
+      
+          property :destination, as: 'destination', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation
+      
+          collection :extensions, as: 'extensions'
+          property :origin, as: 'origin', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation
+      
+          property :request, as: 'request', class: Google::Apis::ServicecontrolV2::Request, decorator: Google::Apis::ServicecontrolV2::Request::Representation
+      
+          property :resource, as: 'resource', class: Google::Apis::ServicecontrolV2::Resource, decorator: Google::Apis::ServicecontrolV2::Resource::Representation
+      
+          property :response, as: 'response', class: Google::Apis::ServicecontrolV2::Response, decorator: Google::Apis::ServicecontrolV2::Response::Representation
+      
+          property :source, as: 'source', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation
+      
+        end
+      end
+      
+      class AuditLog
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :authentication_info, as: 'authenticationInfo', class: Google::Apis::ServicecontrolV2::AuthenticationInfo, decorator: Google::Apis::ServicecontrolV2::AuthenticationInfo::Representation
+      
+          collection :authorization_info, as: 'authorizationInfo', class: Google::Apis::ServicecontrolV2::AuthorizationInfo, decorator: Google::Apis::ServicecontrolV2::AuthorizationInfo::Representation
+      
+          hash :metadata, as: 'metadata'
+          property :method_name, as: 'methodName'
+          property :num_response_items, :numeric_string => true, as: 'numResponseItems'
+          hash :request, as: 'request'
+          property :request_metadata, as: 'requestMetadata', class: Google::Apis::ServicecontrolV2::RequestMetadata, decorator: Google::Apis::ServicecontrolV2::RequestMetadata::Representation
+      
+          property :resource_location, as: 'resourceLocation', class: Google::Apis::ServicecontrolV2::ResourceLocation, decorator: Google::Apis::ServicecontrolV2::ResourceLocation::Representation
+      
+          property :resource_name, as: 'resourceName'
+          hash :resource_original_state, as: 'resourceOriginalState'
+          hash :response, as: 'response'
+          hash :service_data, as: 'serviceData'
+          property :service_name, as: 'serviceName'
+          property :status, as: 'status', class: Google::Apis::ServicecontrolV2::Status, decorator: Google::Apis::ServicecontrolV2::Status::Representation
+      
+        end
+      end
+      
+      class Auth
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :access_levels, as: 'accessLevels'
+          collection :audiences, as: 'audiences'
+          hash :claims, as: 'claims'
+          property :presenter, as: 'presenter'
+          property :principal, as: 'principal'
+        end
+      end
+      
+      class AuthenticationInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :authority_selector, as: 'authoritySelector'
+          property :principal_email, as: 'principalEmail'
+          property :principal_subject, as: 'principalSubject'
+          collection :service_account_delegation_info, as: 'serviceAccountDelegationInfo', class: Google::Apis::ServicecontrolV2::ServiceAccountDelegationInfo, decorator: Google::Apis::ServicecontrolV2::ServiceAccountDelegationInfo::Representation
+      
+          property :service_account_key_name, as: 'serviceAccountKeyName'
+          hash :third_party_principal, as: 'thirdPartyPrincipal'
+        end
+      end
+      
+      class AuthorizationInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :granted, as: 'granted'
+          property :permission, as: 'permission'
+          property :resource, as: 'resource'
+          property :resource_attributes, as: 'resourceAttributes', class: Google::Apis::ServicecontrolV2::Resource, decorator: Google::Apis::ServicecontrolV2::Resource::Representation
+      
+        end
+      end
+      
+      class CheckRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attributes, as: 'attributes', class: Google::Apis::ServicecontrolV2::AttributeContext, decorator: Google::Apis::ServicecontrolV2::AttributeContext::Representation
+      
+          collection :resources, as: 'resources', class: Google::Apis::ServicecontrolV2::ResourceInfo, decorator: Google::Apis::ServicecontrolV2::ResourceInfo::Representation
+      
+          property :service_config_id, as: 'serviceConfigId'
+        end
+      end
+      
+      class CheckResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :headers, as: 'headers'
+          property :status, as: 'status', class: Google::Apis::ServicecontrolV2::Status, decorator: Google::Apis::ServicecontrolV2::Status::Representation
+      
+        end
+      end
+      
+      class FirstPartyPrincipal
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :principal_email, as: 'principalEmail'
+          hash :service_metadata, as: 'serviceMetadata'
+        end
+      end
+      
+      class Peer
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ip, as: 'ip'
+          hash :labels, as: 'labels'
+          property :port, :numeric_string => true, as: 'port'
+          property :principal, as: 'principal'
+          property :region_code, as: 'regionCode'
+        end
+      end
+      
+      class ReportRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :operations, as: 'operations', class: Google::Apis::ServicecontrolV2::AttributeContext, decorator: Google::Apis::ServicecontrolV2::AttributeContext::Representation
+      
+          property :service_config_id, as: 'serviceConfigId'
+        end
+      end
+      
+      class ReportResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class Request
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :auth, as: 'auth', class: Google::Apis::ServicecontrolV2::Auth, decorator: Google::Apis::ServicecontrolV2::Auth::Representation
+      
+          hash :headers, as: 'headers'
+          property :host, as: 'host'
+          property :id, as: 'id'
+          property :method_prop, as: 'method'
+          property :path, as: 'path'
+          property :protocol, as: 'protocol'
+          property :query, as: 'query'
+          property :reason, as: 'reason'
+          property :scheme, as: 'scheme'
+          property :size, :numeric_string => true, as: 'size'
+          property :time, as: 'time'
+        end
+      end
+      
+      class RequestMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :caller_ip, as: 'callerIp'
+          property :caller_network, as: 'callerNetwork'
+          property :caller_supplied_user_agent, as: 'callerSuppliedUserAgent'
+          property :destination_attributes, as: 'destinationAttributes', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation
+      
+          property :request_attributes, as: 'requestAttributes', class: Google::Apis::ServicecontrolV2::Request, decorator: Google::Apis::ServicecontrolV2::Request::Representation
+      
+        end
+      end
+      
+      class Resource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :labels, as: 'labels'
+          property :name, as: 'name'
+          property :service, as: 'service'
+          property :type, as: 'type'
+        end
+      end
+      
+      class ResourceInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :permission, as: 'permission'
+          property :type, as: 'type'
+        end
+      end
+      
+      class ResourceLocation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :current_locations, as: 'currentLocations'
+          collection :original_locations, as: 'originalLocations'
+        end
+      end
+      
+      class Response
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, :numeric_string => true, as: 'code'
+          hash :headers, as: 'headers'
+          property :size, :numeric_string => true, as: 'size'
+          property :time, as: 'time'
+        end
+      end
+      
+      class ServiceAccountDelegationInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :first_party_principal, as: 'firstPartyPrincipal', class: Google::Apis::ServicecontrolV2::FirstPartyPrincipal, decorator: Google::Apis::ServicecontrolV2::FirstPartyPrincipal::Representation
+      
+          property :third_party_principal, as: 'thirdPartyPrincipal', class: Google::Apis::ServicecontrolV2::ThirdPartyPrincipal, decorator: Google::Apis::ServicecontrolV2::ThirdPartyPrincipal::Representation
+      
+        end
+      end
+      
+      class SpanContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :span_name, as: 'spanName'
+        end
+      end
+      
+      class Status
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          collection :details, as: 'details'
+          property :message, as: 'message'
+        end
+      end
+      
+      class ThirdPartyPrincipal
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :third_party_claims, as: 'thirdPartyClaims'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,165 @@
+# 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 ServicecontrolV2
+      # Service Control API
+      #
+      # Provides control plane functionality to managed services, such as logging,
+      #  monitoring, and status checks.
+      #
+      # @example
+      #    require 'google/apis/servicecontrol_v2'
+      #
+      #    Servicecontrol = Google::Apis::ServicecontrolV2 # Alias the module
+      #    service = Servicecontrol::ServiceControlService.new
+      #
+      # @see https://cloud.google.com/service-control/
+      class ServiceControlService < 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://servicecontrol.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Private Preview. This feature is only available for approved services.
+        # This method provides admission control for services that are integrated
+        # with [Service Infrastructure](/service-infrastructure). It checks whether
+        # an operation should be allowed based on the service configuration and
+        # relevant policies. It must be called before the operation is executed.
+        # For more information, see
+        # [Admission Control](/service-infrastructure/docs/admission-control).
+        # NOTE: The admission control has an expected policy propagation delay of
+        # 60s. The caller **must** not depend on the most recent policy changes.
+        # NOTE: The admission control has a hard limit of 1 referenced resources
+        # per call. If an operation refers to more than 1 resources, the caller
+        # must call the Check method multiple times.
+        # This method requires the `servicemanagement.services.check` permission
+        # on the specified service. For more information, see
+        # [Service Control API Access
+        # Control](https://cloud.google.com/service-infrastructure/docs/service-control/
+        # access-control).
+        # @param [String] service_name
+        #   The service name as specified in its service configuration. For example,
+        #   `"pubsub.googleapis.com"`.
+        #   See
+        #   [google.api.Service](https://cloud.google.com/service-management/reference/rpc/
+        #   google.api#google.api.Service)
+        #   for the definition of a service name.
+        # @param [Google::Apis::ServicecontrolV2::CheckRequest] check_request_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::ServicecontrolV2::CheckResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicecontrolV2::CheckResponse]
+        #
+        # @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 check_service(service_name, check_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/services/{serviceName}:check', options)
+          command.request_representation = Google::Apis::ServicecontrolV2::CheckRequest::Representation
+          command.request_object = check_request_object
+          command.response_representation = Google::Apis::ServicecontrolV2::CheckResponse::Representation
+          command.response_class = Google::Apis::ServicecontrolV2::CheckResponse
+          command.params['serviceName'] = service_name unless service_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
+        
+        # Private Preview. This feature is only available for approved services.
+        # This method provides telemetry reporting for services that are integrated
+        # with [Service Infrastructure](/service-infrastructure). It reports a list
+        # of operations that have occurred on a service. It must be called after the
+        # operations have been executed. For more information, see
+        # [Telemetry Reporting](/service-infrastructure/docs/telemetry-reporting).
+        # NOTE: The telemetry reporting has a hard limit of 1000 operations and 1MB
+        # per Report call. It is recommended to have no more than 100 operations per
+        # call.
+        # This method requires the `servicemanagement.services.report` permission
+        # on the specified service. For more information, see
+        # [Service Control API Access
+        # Control](https://cloud.google.com/service-infrastructure/docs/service-control/
+        # access-control).
+        # @param [String] service_name
+        #   The service name as specified in its service configuration. For example,
+        #   `"pubsub.googleapis.com"`.
+        #   See
+        #   [google.api.Service](https://cloud.google.com/service-management/reference/rpc/
+        #   google.api#google.api.Service)
+        #   for the definition of a service name.
+        # @param [Google::Apis::ServicecontrolV2::ReportRequest] report_request_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::ServicecontrolV2::ReportResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicecontrolV2::ReportResponse]
+        #
+        # @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 report_service(service_name, report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/services/{serviceName}:report', options)
+          command.request_representation = Google::Apis::ServicecontrolV2::ReportRequest::Representation
+          command.request_object = report_request_object
+          command.response_representation = Google::Apis::ServicecontrolV2::ReportResponse::Representation
+          command.response_class = Google::Apis::ServicecontrolV2::ReportResponse
+          command.params['serviceName'] = service_name unless service_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
+
+        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/servicecontrol_v2.rb

@@ -0,0 +1,38 @@
+# 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/servicecontrol_v2/service.rb'
+require 'google/apis/servicecontrol_v2/classes.rb'
+require 'google/apis/servicecontrol_v2/representations.rb'
+
+module Google
+  module Apis
+    # Service Control API
+    #
+    # Provides control plane functionality to managed services, such as logging,
+    # monitoring, and status checks.
+    #
+    # @see https://cloud.google.com/service-control/
+    module ServicecontrolV2
+      VERSION = 'V2'
+      REVISION = '20200727'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # Manage your Google Service Control data
+      AUTH_SERVICECONTROL = 'https://www.googleapis.com/auth/servicecontrol'
+    end
+  end
+end

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

@@ -2566,8 +2566,8 @@ module Google
       # existing data unusable.
       # The following are specific rules for service defined Monitoring metric
       # descriptors:
-      # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
-      # `launch_stage` fields are all required. The `unit` field must be specified
+      # * `type`, `metric_kind`, `value_type` and `description`
+      # fields are all required. The `unit` field must be specified
       # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
       # * Maximum of default 500 metric descriptors per service is allowed.
       # * Maximum of default 10 labels per metric descriptor is allowed.
@@ -3652,6 +3652,54 @@ module Google
         end
       end
       
+      # Defines a proto annotation that describes a string field that refers to
+      # an API resource.
+      class ResourceReference
+        include Google::Apis::Core::Hashable
+      
+        # The resource type of a child collection that the annotated field
+        # references. This is useful for annotating the `parent` field that
+        # doesn't have a fixed resource type.
+        # Example:
+        # message ListLogEntriesRequest `
+        # string parent = 1 [(google.api.resource_reference) = `
+        # child_type: "logging.googleapis.com/LogEntry"
+        # `;
+        # `
+        # Corresponds to the JSON property `childType`
+        # @return [String]
+        attr_accessor :child_type
+      
+        # The resource type that the annotated field references.
+        # Example:
+        # message Subscription `
+        # string topic = 2 [(google.api.resource_reference) = `
+        # type: "pubsub.googleapis.com/Topic"
+        # `];
+        # `
+        # Occasionally, a field may reference an arbitrary resource. In this case,
+        # APIs use the special value * in their resource reference.
+        # Example:
+        # message GetIamPolicyRequest `
+        # string resource = 2 [(google.api.resource_reference) = `
+        # type: "*"
+        # `];
+        # `
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @child_type = args[:child_type] if args.key?(:child_type)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # A rollout resource that defines how service configuration versions are pushed
       # to control plane systems. Typically, you create a new version of the
       # service config, and then create a Rollout to push the service config.