diff --git a/.gitignore b/.gitignore index c04ef5080..4c0ca379f 100644 --- a/.gitignore +++ b/.gitignore @@ -17,3 +17,4 @@ /node_modules/ /package-lock.json /.toys/**/Gemfile.lock +.toys-tmp-gemfile* diff --git a/gapic-generator-ads/test/gapic/presenters/service_test.rb b/gapic-generator-ads/test/gapic/presenters/service_test.rb index 9af78be6b..a1b1f90c3 100644 --- a/gapic-generator-ads/test/gapic/presenters/service_test.rb +++ b/gapic-generator-ads/test/gapic/presenters/service_test.rb @@ -37,46 +37,46 @@ def test_references end def test_proto_methods - assert_equal "::Google::Ads::GoogleAds::V19::Services::CampaignService", presenter.proto_service_name_full - assert_equal "google/ads/googleads/v19/services/campaign_service_pb.rb", presenter.proto_service_file_path + assert_equal "::Google::Ads::GoogleAds::V21::Services::CampaignService", presenter.proto_service_name_full + assert_equal "google/ads/googleads/v21/services/campaign_service_pb.rb", presenter.proto_service_file_path assert_equal "campaign_service_pb.rb", presenter.proto_service_file_name - assert_equal "google/ads/googleads/v19/services/campaign_service_pb", presenter.proto_service_require - assert_equal "google/ads/googleads/v19/services/campaign_service_services_pb.rb", presenter.proto_services_file_path + assert_equal "google/ads/googleads/v21/services/campaign_service_pb", presenter.proto_service_require + assert_equal "google/ads/googleads/v21/services/campaign_service_services_pb.rb", presenter.proto_services_file_path assert_equal "campaign_service_services_pb.rb", presenter.proto_services_file_name - assert_equal "google/ads/googleads/v19/services/campaign_service_services_pb", presenter.proto_services_require - assert_equal "::Google::Ads::GoogleAds::V19::Services::CampaignService::Stub", + assert_equal "google/ads/googleads/v21/services/campaign_service_services_pb", presenter.proto_services_require + assert_equal "::Google::Ads::GoogleAds::V21::Services::CampaignService::Stub", presenter.proto_service_stub_name_full end def test_credentials_methods assert_equal "Credentials", presenter.credentials_name - assert_equal "::Google::Ads::GoogleAds::V19::Services::CampaignService::Credentials", + assert_equal "::Google::Ads::GoogleAds::V21::Services::CampaignService::Credentials", presenter.credentials_name_full - assert_equal "google/ads/google_ads/v19/services/campaign_service/credentials.rb", presenter.credentials_file_path + assert_equal "google/ads/google_ads/v21/services/campaign_service/credentials.rb", presenter.credentials_file_path assert_equal "credentials.rb", presenter.credentials_file_name - assert_equal "google/ads/google_ads/v19/services/campaign_service/credentials", presenter.credentials_require + assert_equal "google/ads/google_ads/v21/services/campaign_service/credentials", presenter.credentials_require end def test_operations_methods assert_equal "Operations", presenter.operations_name - assert_equal "::Google::Ads::GoogleAds::V19::Services::CampaignService::Operations", presenter.operations_name_full - assert_equal "google/ads/google_ads/v19/services/campaign_service/operations.rb", presenter.operations_file_path + assert_equal "::Google::Ads::GoogleAds::V21::Services::CampaignService::Operations", presenter.operations_name_full + assert_equal "google/ads/google_ads/v21/services/campaign_service/operations.rb", presenter.operations_file_path assert_equal "operations.rb", presenter.operations_file_name - assert_equal "google/ads/google_ads/v19/services/campaign_service/operations", presenter.operations_require + assert_equal "google/ads/google_ads/v21/services/campaign_service/operations", presenter.operations_require end def test_helpers_methods - assert_equal "google/ads/google_ads/v19/services/campaign_service/helpers.rb", presenter.helpers_file_path + assert_equal "google/ads/google_ads/v21/services/campaign_service/helpers.rb", presenter.helpers_file_path assert_equal "helpers.rb", presenter.helpers_file_name - assert_equal "google/ads/google_ads/v19/services/campaign_service/helpers", presenter.helpers_require + assert_equal "google/ads/google_ads/v21/services/campaign_service/helpers", presenter.helpers_require end def test_test_client_file_path - assert_equal "google/ads/google_ads/v19/services/campaign_service_test.rb", presenter.test_client_file_path + assert_equal "google/ads/google_ads/v21/services/campaign_service_test.rb", presenter.test_client_file_path end def test_test_client_operations_file_path - assert_equal "google/ads/google_ads/v19/services/campaign_service_operations_test.rb", + assert_equal "google/ads/google_ads/v21/services/campaign_service_operations_test.rb", presenter.test_client_operations_file_path end @@ -105,11 +105,11 @@ def test_paths_name end def test_paths_name_full - assert_equal "::Google::Ads::GoogleAds::V19::Services::CampaignService::Paths", presenter.paths_name_full + assert_equal "::Google::Ads::GoogleAds::V21::Services::CampaignService::Paths", presenter.paths_name_full end def test_paths_file_path - assert_equal "google/ads/google_ads/v19/services/campaign_service/paths.rb", presenter.paths_file_path + assert_equal "google/ads/google_ads/v21/services/campaign_service/paths.rb", presenter.paths_file_path end def test_paths_file_name @@ -117,6 +117,6 @@ def test_paths_file_name end def test_paths_require - assert_equal "google/ads/google_ads/v19/services/campaign_service/paths", presenter.paths_require + assert_equal "google/ads/google_ads/v21/services/campaign_service/paths", presenter.paths_require end end diff --git a/shared/gapic-showcase b/shared/gapic-showcase index 60f4159fb..b6c247f15 160000 --- a/shared/gapic-showcase +++ b/shared/gapic-showcase @@ -1 +1 @@ -Subproject commit 60f4159fbf6474304c8b0c088c28e77647763e83 +Subproject commit b6c247f153369044d599969f6929ecdeb066c4c6 diff --git a/shared/gem_defaults.rb b/shared/gem_defaults.rb index b99694bfb..16babf22c 100644 --- a/shared/gem_defaults.rb +++ b/shared/gem_defaults.rb @@ -36,6 +36,7 @@ def gem_defaults "grafeas/v1/intoto_statement.proto", "grafeas/v1/package.proto", "grafeas/v1/provenance.proto", + "grafeas/v1/risk.proto", "grafeas/v1/sbom.proto", "grafeas/v1/secret.proto", "grafeas/v1/severity.proto", @@ -153,7 +154,7 @@ def gem_defaults }, googleads: { protos: [ - "google/ads/googleads/v19/services/campaign_service.proto" + "google/ads/googleads/v21/services/campaign_service.proto" ], generator: :ads }, diff --git a/shared/googleapis b/shared/googleapis index 7e90a532b..c5dcac8b1 160000 --- a/shared/googleapis +++ b/shared/googleapis @@ -1 +1 @@ -Subproject commit 7e90a532b8fc4a127ffda6932dc0af894c2ac3c8 +Subproject commit c5dcac8b1de4cb23c610bd4890b184e36845c56e diff --git a/shared/input/compute_small_desc.bin b/shared/input/compute_small_desc.bin index b3adca314..6d6ac2e83 100644 Binary files a/shared/input/compute_small_desc.bin and b/shared/input/compute_small_desc.bin differ diff --git a/shared/input/compute_small_wrapper_desc.bin b/shared/input/compute_small_wrapper_desc.bin index 6d859e8d8..44fda3473 100644 Binary files a/shared/input/compute_small_wrapper_desc.bin and b/shared/input/compute_small_wrapper_desc.bin differ diff --git a/shared/input/garbage_desc.bin b/shared/input/garbage_desc.bin index 638cf5e40..10836dad3 100644 Binary files a/shared/input/garbage_desc.bin and b/shared/input/garbage_desc.bin differ diff --git a/shared/input/googleads_desc.bin b/shared/input/googleads_desc.bin index f2bb6d234..e4ea7bcbc 100644 Binary files a/shared/input/googleads_desc.bin and b/shared/input/googleads_desc.bin differ diff --git a/shared/input/grafeas_v1_desc.bin b/shared/input/grafeas_v1_desc.bin index fa7074f97..1c4c1bd86 100644 Binary files a/shared/input/grafeas_v1_desc.bin and b/shared/input/grafeas_v1_desc.bin differ diff --git a/shared/input/language_v1_desc.bin b/shared/input/language_v1_desc.bin index f745b5008..d813e67e9 100644 Binary files a/shared/input/language_v1_desc.bin and b/shared/input/language_v1_desc.bin differ diff --git a/shared/input/language_v1beta1_desc.bin b/shared/input/language_v1beta1_desc.bin index 848cb8c6c..633293281 100644 Binary files a/shared/input/language_v1beta1_desc.bin and b/shared/input/language_v1beta1_desc.bin differ diff --git a/shared/input/language_v1beta2_desc.bin b/shared/input/language_v1beta2_desc.bin index c0bb5ef85..8069e7355 100644 Binary files a/shared/input/language_v1beta2_desc.bin and b/shared/input/language_v1beta2_desc.bin differ diff --git a/shared/input/language_wrapper_desc.bin b/shared/input/language_wrapper_desc.bin index e0988ced0..ef326bfc2 100644 Binary files a/shared/input/language_wrapper_desc.bin and b/shared/input/language_wrapper_desc.bin differ diff --git a/shared/input/location_desc.bin b/shared/input/location_desc.bin index 28cf36824..ae282a89b 100644 Binary files a/shared/input/location_desc.bin and b/shared/input/location_desc.bin differ diff --git a/shared/input/secretmanager_v1beta1_desc.bin b/shared/input/secretmanager_v1beta1_desc.bin index 4f221353f..2a0931e56 100644 Binary files a/shared/input/secretmanager_v1beta1_desc.bin and b/shared/input/secretmanager_v1beta1_desc.bin differ diff --git a/shared/input/secretmanager_wrapper_desc.bin b/shared/input/secretmanager_wrapper_desc.bin index bbd86c566..6d9f77488 100644 Binary files a/shared/input/secretmanager_wrapper_desc.bin and b/shared/input/secretmanager_wrapper_desc.bin differ diff --git a/shared/input/showcase_desc.bin b/shared/input/showcase_desc.bin index 91f0e833c..9cb28542e 100644 Binary files a/shared/input/showcase_desc.bin and b/shared/input/showcase_desc.bin differ diff --git a/shared/input/speech_v1_desc.bin b/shared/input/speech_v1_desc.bin index 52a15bded..31edc29e4 100644 Binary files a/shared/input/speech_v1_desc.bin and b/shared/input/speech_v1_desc.bin differ diff --git a/shared/input/testing_desc.bin b/shared/input/testing_desc.bin index 383118668..3855138e3 100644 Binary files a/shared/input/testing_desc.bin and b/shared/input/testing_desc.bin differ diff --git a/shared/input/vision_v1_desc.bin b/shared/input/vision_v1_desc.bin index a09057736..8cec9e11a 100644 Binary files a/shared/input/vision_v1_desc.bin and b/shared/input/vision_v1_desc.bin differ diff --git a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services.rb b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services.rb similarity index 80% rename from shared/output/ads/googleads/lib/google/ads/google_ads/v19/services.rb rename to shared/output/ads/googleads/lib/google/ads/google_ads/v21/services.rb index 0b5d06217..9cff6e536 100644 --- a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services.rb +++ b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services.rb @@ -16,20 +16,20 @@ # Auto-generated by gapic-generator-ruby. DO NOT EDIT! -require "google/ads/google_ads/v19/services/campaign_service" +require "google/ads/google_ads/v21/services/campaign_service" require "google/ads/google_ads/version" module Google module Ads module GoogleAds - module V19 + module V21 ## # API client module. # # @example Load this package, including all its services, and instantiate a gRPC client # - # require "google/ads/google_ads/v19/services" - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new + # require "google/ads/google_ads/v21/services" + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new # module Services end @@ -39,4 +39,4 @@ module Services end helper_path = ::File.join __dir__, "services", "_helpers.rb" -require "google/ads/google_ads/v19/services/_helpers" if ::File.file? helper_path +require "google/ads/google_ads/v21/services/_helpers" if ::File.file? helper_path diff --git a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service.rb b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service.rb similarity index 75% rename from shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service.rb rename to shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service.rb index 3c31bb1ac..04fc05b24 100644 --- a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service.rb +++ b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service.rb @@ -22,22 +22,22 @@ require "google/ads/google_ads/version" -require "google/ads/google_ads/v19/services/campaign_service/credentials" -require "google/ads/google_ads/v19/services/campaign_service/paths" -require "google/ads/google_ads/v19/services/campaign_service/client" +require "google/ads/google_ads/v21/services/campaign_service/credentials" +require "google/ads/google_ads/v21/services/campaign_service/paths" +require "google/ads/google_ads/v21/services/campaign_service/client" module Google module Ads module GoogleAds - module V19 + module V21 module Services ## # Service to manage campaigns. # # @example Load this service and instantiate a gRPC client # - # require "google/ads/google_ads/v19/services/campaign_service" - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new + # require "google/ads/google_ads/v21/services/campaign_service" + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new # module CampaignService end @@ -48,4 +48,4 @@ module CampaignService end helper_path = ::File.join __dir__, "campaign_service", "helpers.rb" -require "google/ads/google_ads/v19/services/campaign_service/helpers" if ::File.file? helper_path +require "google/ads/google_ads/v21/services/campaign_service/helpers" if ::File.file? helper_path diff --git a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/client.rb b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/client.rb similarity index 93% rename from shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/client.rb rename to shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/client.rb index ed2a61199..800af28e4 100644 --- a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/client.rb +++ b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/client.rb @@ -17,12 +17,12 @@ # Auto-generated by gapic-generator-ruby. DO NOT EDIT! # require "google/ads/google_ads/error" -require "google/ads/googleads/v19/services/campaign_service_pb" +require "google/ads/googleads/v21/services/campaign_service_pb" module Google module Ads module GoogleAds - module V19 + module V21 module Services module CampaignService ## @@ -45,13 +45,13 @@ class Client ## # Configure the CampaignService Client class. # - # See {::Google::Ads::GoogleAds::V19::Services::CampaignService::Client::Configuration} + # See {::Google::Ads::GoogleAds::V21::Services::CampaignService::Client::Configuration} # for a description of the configuration fields. # # @example # # # Modify the configuration for all CampaignService clients - # ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.configure do |config| + # ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.configure do |config| # config.timeout = 10.0 # end # @@ -77,7 +77,7 @@ def self.configure # but structural changes (adding new fields, etc.) are not allowed. Structural changes # should be made on {Client.configure}. # - # See {::Google::Ads::GoogleAds::V19::Services::CampaignService::Client::Configuration} + # See {::Google::Ads::GoogleAds::V21::Services::CampaignService::Client::Configuration} # for a description of the configuration fields. # # @yield [config] Configure the Client client. @@ -105,10 +105,10 @@ def universe_domain # @example # # # Create a client using the default configuration - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new # # # Create a client using a custom configuration - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new do |config| + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new do |config| # config.timeout = 10.0 # end # @@ -120,7 +120,7 @@ def initialize # the gRPC module only when it's required. # See https://github.com/googleapis/toolkit/issues/446 require "gapic/grpc" - require "google/ads/googleads/v19/services/campaign_service_services_pb" + require "google/ads/googleads/v21/services/campaign_service_services_pb" # Create the configuration object @config = Configuration.new Client.configure @@ -144,7 +144,7 @@ def initialize @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id @campaign_service_stub = ::Gapic::ServiceStub.new( - ::Google::Ads::GoogleAds::V19::Services::CampaignService::Stub, + ::Google::Ads::GoogleAds::V21::Services::CampaignService::Stub, credentials: credentials, endpoint: @config.endpoint, endpoint_template: DEFAULT_ENDPOINT_TEMPLATE, @@ -219,9 +219,9 @@ def logger # # @overload mutate_campaigns(request, options = nil) # Pass arguments to `mutate_campaigns` via a request object, either of type - # {::Google::Ads::GoogleAds::V19::Services::MutateCampaignsRequest} or an equivalent Hash. + # {::Google::Ads::GoogleAds::V21::Services::MutateCampaignsRequest} or an equivalent Hash. # - # @param request [::Google::Ads::GoogleAds::V19::Services::MutateCampaignsRequest, ::Hash] + # @param request [::Google::Ads::GoogleAds::V21::Services::MutateCampaignsRequest, ::Hash] # A request object representing the call parameters. Required. To specify no # parameters, or to keep all the default parameter values, pass an empty Hash. # @param options [::Gapic::CallOptions, ::Hash] @@ -234,7 +234,7 @@ def logger # # @param customer_id [::String] # Required. The ID of the customer whose campaigns are being modified. - # @param operations [::Array<::Google::Ads::GoogleAds::V19::Services::CampaignOperation, ::Hash>] + # @param operations [::Array<::Google::Ads::GoogleAds::V21::Services::CampaignOperation, ::Hash>] # Required. The list of operations to perform on individual campaigns. # @param partial_failure [::Boolean] # If true, successful operations will be carried out and invalid @@ -244,37 +244,37 @@ def logger # @param validate_only [::Boolean] # If true, the request is validated but not executed. Only errors are # returned, not results. - # @param response_content_type [::Google::Ads::GoogleAds::V19::Enums::ResponseContentTypeEnum::ResponseContentType] + # @param response_content_type [::Google::Ads::GoogleAds::V21::Enums::ResponseContentTypeEnum::ResponseContentType] # The response content type setting. Determines whether the mutable resource # or just the resource name should be returned post mutation. # # @yield [response, operation] Access the result along with the RPC operation - # @yieldparam response [::Google::Ads::GoogleAds::V19::Services::MutateCampaignsResponse] + # @yieldparam response [::Google::Ads::GoogleAds::V21::Services::MutateCampaignsResponse] # @yieldparam operation [::GRPC::ActiveCall::Operation] # - # @return [::Google::Ads::GoogleAds::V19::Services::MutateCampaignsResponse] + # @return [::Google::Ads::GoogleAds::V21::Services::MutateCampaignsResponse] # # @raise [Google::Ads::GoogleAds::Error] if the RPC is aborted. # # @example Basic example - # require "google/ads/google_ads/v19/services" + # require "google/ads/google_ads/v21/services" # # # Create a client object. The client can be reused for multiple calls. - # client = Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new + # client = Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new # # # Create a request. To set request fields, pass in keyword arguments. - # request = Google::Ads::GoogleAds::V19::Services::MutateCampaignsRequest.new + # request = Google::Ads::GoogleAds::V21::Services::MutateCampaignsRequest.new # # # Call the mutate_campaigns method. # result = client.mutate_campaigns request # - # # The returned object is of type Google::Ads::GoogleAds::V19::Services::MutateCampaignsResponse. + # # The returned object is of type Google::Ads::GoogleAds::V21::Services::MutateCampaignsResponse. # p result # def mutate_campaigns request, options = nil raise ::ArgumentError, "request must be provided" if request.nil? - request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::GoogleAds::V19::Services::MutateCampaignsRequest + request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::GoogleAds::V21::Services::MutateCampaignsRequest # Converts hash and nil to an options object options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h @@ -331,9 +331,9 @@ def mutate_campaigns request, options = nil # # @overload enable_p_max_brand_guidelines(request, options = nil) # Pass arguments to `enable_p_max_brand_guidelines` via a request object, either of type - # {::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesRequest} or an equivalent Hash. + # {::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesRequest} or an equivalent Hash. # - # @param request [::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesRequest, ::Hash] + # @param request [::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesRequest, ::Hash] # A request object representing the call parameters. Required. To specify no # parameters, or to keep all the default parameter values, pass an empty Hash. # @param options [::Gapic::CallOptions, ::Hash] @@ -346,37 +346,37 @@ def mutate_campaigns request, options = nil # # @param customer_id [::String] # Required. The ID of the customer whose campaigns are being enabled. - # @param operations [::Array<::Google::Ads::GoogleAds::V19::Services::EnableOperation, ::Hash>] + # @param operations [::Array<::Google::Ads::GoogleAds::V21::Services::EnableOperation, ::Hash>] # Required. The list of individual campaign operations. A maximum of 10 # enable operations can be executed in a request. # # @yield [response, operation] Access the result along with the RPC operation - # @yieldparam response [::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesResponse] + # @yieldparam response [::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesResponse] # @yieldparam operation [::GRPC::ActiveCall::Operation] # - # @return [::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesResponse] + # @return [::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesResponse] # # @raise [Google::Ads::GoogleAds::Error] if the RPC is aborted. # # @example Basic example - # require "google/ads/google_ads/v19/services" + # require "google/ads/google_ads/v21/services" # # # Create a client object. The client can be reused for multiple calls. - # client = Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new + # client = Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new # # # Create a request. To set request fields, pass in keyword arguments. - # request = Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesRequest.new + # request = Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesRequest.new # # # Call the enable_p_max_brand_guidelines method. # result = client.enable_p_max_brand_guidelines request # - # # The returned object is of type Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesResponse. + # # The returned object is of type Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesResponse. # p result # def enable_p_max_brand_guidelines request, options = nil raise ::ArgumentError, "request must be provided" if request.nil? - request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesRequest + request = ::Gapic::Protobuf.coerce request, to: ::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesRequest # Converts hash and nil to an options object options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h @@ -422,7 +422,7 @@ def enable_p_max_brand_guidelines request, options = nil # providing control over timeouts, retry behavior, logging, transport # parameters, and other low-level controls. Certain parameters can also be # applied individually to specific RPCs. See - # {::Google::Ads::GoogleAds::V19::Services::CampaignService::Client::Configuration::Rpcs} + # {::Google::Ads::GoogleAds::V21::Services::CampaignService::Client::Configuration::Rpcs} # for a list of RPCs that can be configured independently. # # Configuration can be applied globally to all clients, or to a single client @@ -433,13 +433,13 @@ def enable_p_max_brand_guidelines request, options = nil # # Modify the global config, setting the timeout for # # mutate_campaigns to 20 seconds, # # and all remaining timeouts to 10 seconds. - # ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.configure do |config| + # ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.configure do |config| # config.timeout = 10.0 # config.rpcs.mutate_campaigns.timeout = 20.0 # end # # # Apply the above configuration only to a new client. - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new do |config| + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new do |config| # config.timeout = 10.0 # config.rpcs.mutate_campaigns.timeout = 20.0 # end @@ -473,7 +473,7 @@ def enable_p_max_brand_guidelines request, options = nil # json_key_io: ::File.open("/path/to/keyfile.json") # ) # - # client = ::Google::Ads::GoogleAds::V19::Services::CampaignService::Client.new do |config| + # client = ::Google::Ads::GoogleAds::V21::Services::CampaignService::Client.new do |config| # config.credentials = credentials # end # diff --git a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/credentials.rb b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/credentials.rb similarity index 98% rename from shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/credentials.rb rename to shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/credentials.rb index bc5043101..00109331b 100644 --- a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/credentials.rb +++ b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/credentials.rb @@ -21,7 +21,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Services module CampaignService # Credentials for the CampaignService API. diff --git a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/paths.rb b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/paths.rb similarity index 98% rename from shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/paths.rb rename to shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/paths.rb index 7635baf79..6a7bf523a 100644 --- a/shared/output/ads/googleads/lib/google/ads/google_ads/v19/services/campaign_service/paths.rb +++ b/shared/output/ads/googleads/lib/google/ads/google_ads/v21/services/campaign_service/paths.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Services module CampaignService # Path helper methods for the CampaignService API. diff --git a/shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_pb.rb b/shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_pb.rb similarity index 63% rename from shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_pb.rb rename to shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_pb.rb index da31d882e..da54759b1 100644 --- a/shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_pb.rb +++ b/shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_pb.rb @@ -1,11 +1,11 @@ # frozen_string_literal: true # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/ads/googleads/v19/services/campaign_service.proto +# source: google/ads/googleads/v21/services/campaign_service.proto require 'google/protobuf' -require 'google/ads/googleads/v19/enums/response_content_type_pb' -require 'google/ads/googleads/v19/resources/campaign_pb' +require 'google/ads/googleads/v21/enums/response_content_type_pb' +require 'google/ads/googleads/v21/resources/campaign_pb' require 'google/api/annotations_pb' require 'google/api/client_pb' require 'google/api/field_behavior_pb' @@ -14,7 +14,7 @@ require 'google/rpc/status_pb' -descriptor_data = "\n8google/ads/googleads/v19/services/campaign_service.proto\x12!google.ads.googleads.v19.services\x1a:google/ads/googleads/v19/enums/response_content_type.proto\x1a\x31google/ads/googleads/v19/resources/campaign.proto\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/rpc/status.proto\"\x9d\x02\n\x16MutateCampaignsRequest\x12\x18\n\x0b\x63ustomer_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12M\n\noperations\x18\x02 \x03(\x0b\x32\x34.google.ads.googleads.v19.services.CampaignOperationB\x03\xe0\x41\x02\x12\x17\n\x0fpartial_failure\x18\x03 \x01(\x08\x12\x15\n\rvalidate_only\x18\x04 \x01(\x08\x12j\n\x15response_content_type\x18\x05 \x01(\x0e\x32K.google.ads.googleads.v19.enums.ResponseContentTypeEnum.ResponseContentType\"\x8b\x02\n\x11\x43\x61mpaignOperation\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12>\n\x06\x63reate\x18\x01 \x01(\x0b\x32,.google.ads.googleads.v19.resources.CampaignH\x00\x12>\n\x06update\x18\x02 \x01(\x0b\x32,.google.ads.googleads.v19.resources.CampaignH\x00\x12\x38\n\x06remove\x18\x03 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/CampaignH\x00\x42\x0b\n\toperation\"\x96\x01\n\x17MutateCampaignsResponse\x12\x31\n\x15partial_failure_error\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12H\n\x07results\x18\x02 \x03(\x0b\x32\x37.google.ads.googleads.v19.services.MutateCampaignResult\"\x95\x01\n\x14MutateCampaignResult\x12=\n\rresource_name\x18\x01 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/Campaign\x12>\n\x08\x63\x61mpaign\x18\x02 \x01(\x0b\x32,.google.ads.googleads.v19.resources.Campaign\"\x89\x01\n EnablePMaxBrandGuidelinesRequest\x12\x18\n\x0b\x63ustomer_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12K\n\noperations\x18\x02 \x03(\x0b\x32\x32.google.ads.googleads.v19.services.EnableOperationB\x03\xe0\x41\x02\"\xb7\x02\n\x0f\x45nableOperation\x12;\n\x08\x63\x61mpaign\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!googleads.googleapis.com/Campaign\x12\'\n\x1a\x61uto_populate_brand_assets\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02\x12Q\n\x0c\x62rand_assets\x18\x03 \x01(\x0b\x32\x36.google.ads.googleads.v19.services.BrandCampaignAssetsB\x03\xe0\x41\x01\x12\x1d\n\x10\x66inal_uri_domain\x18\x04 \x01(\tB\x03\xe0\x41\x01\x12\x17\n\nmain_color\x18\x05 \x01(\tB\x03\xe0\x41\x01\x12\x19\n\x0c\x61\x63\x63\x65nt_color\x18\x06 \x01(\tB\x03\xe0\x41\x01\x12\x18\n\x0b\x66ont_family\x18\x07 \x01(\tB\x03\xe0\x41\x01\"s\n\x13\x42randCampaignAssets\x12 \n\x13\x62usiness_name_asset\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x17\n\nlogo_asset\x18\x02 \x03(\tB\x03\xe0\x41\x02\x12!\n\x14landscape_logo_asset\x18\x03 \x03(\tB\x03\xe0\x41\x01\"i\n!EnablePMaxBrandGuidelinesResponse\x12\x44\n\x07results\x18\x01 \x03(\x0b\x32\x33.google.ads.googleads.v19.services.EnablementResult\"z\n\x10\x45nablementResult\x12\x38\n\x08\x63\x61mpaign\x18\x01 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/Campaign\x12,\n\x10\x65nablement_error\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status2\xc9\x04\n\x0f\x43\x61mpaignService\x12\xdd\x01\n\x0fMutateCampaigns\x12\x39.google.ads.googleads.v19.services.MutateCampaignsRequest\x1a:.google.ads.googleads.v19.services.MutateCampaignsResponse\"S\xda\x41\x16\x63ustomer_id,operations\x82\xd3\xe4\x93\x02\x34\"//v19/customers/{customer_id=*}/campaigns:mutate:\x01*\x12\x8e\x02\n\x19\x45nablePMaxBrandGuidelines\x12\x43.google.ads.googleads.v19.services.EnablePMaxBrandGuidelinesRequest\x1a\x44.google.ads.googleads.v19.services.EnablePMaxBrandGuidelinesResponse\"f\xda\x41\x16\x63ustomer_id,operations\x82\xd3\xe4\x93\x02G\"B/v19/customers/{customer_id=*}/campaigns:enablePMaxBrandGuidelines:\x01*\x1a\x45\xca\x41\x18googleads.googleapis.com\xd2\x41\'https://www.googleapis.com/auth/adwordsB\x80\x02\n%com.google.ads.googleads.v19.servicesB\x14\x43\x61mpaignServiceProtoP\x01ZIgoogle.golang.org/genproto/googleapis/ads/googleads/v19/services;services\xa2\x02\x03GAA\xaa\x02!Google.Ads.GoogleAds.V19.Services\xca\x02!Google\\Ads\\GoogleAds\\V19\\Services\xea\x02%Google::Ads::GoogleAds::V19::Servicesb\x06proto3" +descriptor_data = "\n8google/ads/googleads/v21/services/campaign_service.proto\x12!google.ads.googleads.v21.services\x1a:google/ads/googleads/v21/enums/response_content_type.proto\x1a\x31google/ads/googleads/v21/resources/campaign.proto\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/rpc/status.proto\"\x9d\x02\n\x16MutateCampaignsRequest\x12\x18\n\x0b\x63ustomer_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12M\n\noperations\x18\x02 \x03(\x0b\x32\x34.google.ads.googleads.v21.services.CampaignOperationB\x03\xe0\x41\x02\x12\x17\n\x0fpartial_failure\x18\x03 \x01(\x08\x12\x15\n\rvalidate_only\x18\x04 \x01(\x08\x12j\n\x15response_content_type\x18\x05 \x01(\x0e\x32K.google.ads.googleads.v21.enums.ResponseContentTypeEnum.ResponseContentType\"\x8b\x02\n\x11\x43\x61mpaignOperation\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12>\n\x06\x63reate\x18\x01 \x01(\x0b\x32,.google.ads.googleads.v21.resources.CampaignH\x00\x12>\n\x06update\x18\x02 \x01(\x0b\x32,.google.ads.googleads.v21.resources.CampaignH\x00\x12\x38\n\x06remove\x18\x03 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/CampaignH\x00\x42\x0b\n\toperation\"\x96\x01\n\x17MutateCampaignsResponse\x12\x31\n\x15partial_failure_error\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12H\n\x07results\x18\x02 \x03(\x0b\x32\x37.google.ads.googleads.v21.services.MutateCampaignResult\"\x95\x01\n\x14MutateCampaignResult\x12=\n\rresource_name\x18\x01 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/Campaign\x12>\n\x08\x63\x61mpaign\x18\x02 \x01(\x0b\x32,.google.ads.googleads.v21.resources.Campaign\"\x89\x01\n EnablePMaxBrandGuidelinesRequest\x12\x18\n\x0b\x63ustomer_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12K\n\noperations\x18\x02 \x03(\x0b\x32\x32.google.ads.googleads.v21.services.EnableOperationB\x03\xe0\x41\x02\"\xb7\x02\n\x0f\x45nableOperation\x12;\n\x08\x63\x61mpaign\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!googleads.googleapis.com/Campaign\x12\'\n\x1a\x61uto_populate_brand_assets\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02\x12Q\n\x0c\x62rand_assets\x18\x03 \x01(\x0b\x32\x36.google.ads.googleads.v21.services.BrandCampaignAssetsB\x03\xe0\x41\x01\x12\x1d\n\x10\x66inal_uri_domain\x18\x04 \x01(\tB\x03\xe0\x41\x01\x12\x17\n\nmain_color\x18\x05 \x01(\tB\x03\xe0\x41\x01\x12\x19\n\x0c\x61\x63\x63\x65nt_color\x18\x06 \x01(\tB\x03\xe0\x41\x01\x12\x18\n\x0b\x66ont_family\x18\x07 \x01(\tB\x03\xe0\x41\x01\"s\n\x13\x42randCampaignAssets\x12 \n\x13\x62usiness_name_asset\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x17\n\nlogo_asset\x18\x02 \x03(\tB\x03\xe0\x41\x02\x12!\n\x14landscape_logo_asset\x18\x03 \x03(\tB\x03\xe0\x41\x01\"i\n!EnablePMaxBrandGuidelinesResponse\x12\x44\n\x07results\x18\x01 \x03(\x0b\x32\x33.google.ads.googleads.v21.services.EnablementResult\"z\n\x10\x45nablementResult\x12\x38\n\x08\x63\x61mpaign\x18\x01 \x01(\tB&\xfa\x41#\n!googleads.googleapis.com/Campaign\x12,\n\x10\x65nablement_error\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status2\xc9\x04\n\x0f\x43\x61mpaignService\x12\xdd\x01\n\x0fMutateCampaigns\x12\x39.google.ads.googleads.v21.services.MutateCampaignsRequest\x1a:.google.ads.googleads.v21.services.MutateCampaignsResponse\"S\xda\x41\x16\x63ustomer_id,operations\x82\xd3\xe4\x93\x02\x34\"//v21/customers/{customer_id=*}/campaigns:mutate:\x01*\x12\x8e\x02\n\x19\x45nablePMaxBrandGuidelines\x12\x43.google.ads.googleads.v21.services.EnablePMaxBrandGuidelinesRequest\x1a\x44.google.ads.googleads.v21.services.EnablePMaxBrandGuidelinesResponse\"f\xda\x41\x16\x63ustomer_id,operations\x82\xd3\xe4\x93\x02G\"B/v21/customers/{customer_id=*}/campaigns:enablePMaxBrandGuidelines:\x01*\x1a\x45\xca\x41\x18googleads.googleapis.com\xd2\x41\'https://www.googleapis.com/auth/adwordsB\x80\x02\n%com.google.ads.googleads.v21.servicesB\x14\x43\x61mpaignServiceProtoP\x01ZIgoogle.golang.org/genproto/googleapis/ads/googleads/v21/services;services\xa2\x02\x03GAA\xaa\x02!Google.Ads.GoogleAds.V21.Services\xca\x02!Google\\Ads\\GoogleAds\\V21\\Services\xea\x02%Google::Ads::GoogleAds::V21::Servicesb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) @@ -22,17 +22,17 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Services - MutateCampaignsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.MutateCampaignsRequest").msgclass - CampaignOperation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.CampaignOperation").msgclass - MutateCampaignsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.MutateCampaignsResponse").msgclass - MutateCampaignResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.MutateCampaignResult").msgclass - EnablePMaxBrandGuidelinesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.EnablePMaxBrandGuidelinesRequest").msgclass - EnableOperation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.EnableOperation").msgclass - BrandCampaignAssets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.BrandCampaignAssets").msgclass - EnablePMaxBrandGuidelinesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.EnablePMaxBrandGuidelinesResponse").msgclass - EnablementResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v19.services.EnablementResult").msgclass + MutateCampaignsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.MutateCampaignsRequest").msgclass + CampaignOperation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.CampaignOperation").msgclass + MutateCampaignsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.MutateCampaignsResponse").msgclass + MutateCampaignResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.MutateCampaignResult").msgclass + EnablePMaxBrandGuidelinesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.EnablePMaxBrandGuidelinesRequest").msgclass + EnableOperation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.EnableOperation").msgclass + BrandCampaignAssets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.BrandCampaignAssets").msgclass + EnablePMaxBrandGuidelinesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.EnablePMaxBrandGuidelinesResponse").msgclass + EnablementResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.ads.googleads.v21.services.EnablementResult").msgclass end end end diff --git a/shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_services_pb.rb b/shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_services_pb.rb similarity index 85% rename from shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_services_pb.rb rename to shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_services_pb.rb index f1b59178e..c64cee01a 100644 --- a/shared/output/ads/googleads/lib/google/ads/googleads/v19/services/campaign_service_services_pb.rb +++ b/shared/output/ads/googleads/lib/google/ads/googleads/v21/services/campaign_service_services_pb.rb @@ -1,7 +1,7 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! -# Source: google/ads/googleads/v19/services/campaign_service.proto for package 'Google.Ads.GoogleAds.V19.Services' +# Source: google/ads/googleads/v21/services/campaign_service.proto for package 'Google.Ads.GoogleAds.V21.Services' # Original file comments: -# Copyright 2025 Google LLC +# Copyright 2026 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. @@ -17,12 +17,12 @@ # require 'grpc' -require 'google/ads/googleads/v19/services/campaign_service_pb' +require 'google/ads/googleads/v21/services/campaign_service_pb' module Google module Ads module GoogleAds - module V19 + module V21 module Services module CampaignService # Proto file describing the Campaign service. @@ -34,7 +34,7 @@ class Service self.marshal_class_method = :encode self.unmarshal_class_method = :decode - self.service_name = 'google.ads.googleads.v19.services.CampaignService' + self.service_name = 'google.ads.googleads.v21.services.CampaignService' # Creates, updates, or removes campaigns. Operation statuses are returned. # @@ -74,7 +74,7 @@ class Service # [StringFormatError]() # [StringLengthError]() # [UrlFieldError]() - rpc :MutateCampaigns, ::Google::Ads::GoogleAds::V19::Services::MutateCampaignsRequest, ::Google::Ads::GoogleAds::V19::Services::MutateCampaignsResponse + rpc :MutateCampaigns, ::Google::Ads::GoogleAds::V21::Services::MutateCampaignsRequest, ::Google::Ads::GoogleAds::V21::Services::MutateCampaignsResponse # Enables Brand Guidelines for Performance Max campaigns. # # List of thrown errors: @@ -90,7 +90,7 @@ class Service # [QuotaError]() # [RequestError]() # [ResourceCountLimitExceededError]() - rpc :EnablePMaxBrandGuidelines, ::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesRequest, ::Google::Ads::GoogleAds::V19::Services::EnablePMaxBrandGuidelinesResponse + rpc :EnablePMaxBrandGuidelines, ::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesRequest, ::Google::Ads::GoogleAds::V21::Services::EnablePMaxBrandGuidelinesResponse end Stub = Service.rpc_stub_class diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/bidding.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/bidding.rb similarity index 91% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/bidding.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/bidding.rb index 03cea95ee..c1adf3eb7 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/bidding.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/bidding.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Common # Commission is an automatic bidding strategy in which the advertiser pays a # certain portion of the conversion value. @@ -118,6 +118,13 @@ class MaximizeConversions # Minimum bid limit that can be set by the bid strategy. # The limit applies to all keywords managed by the strategy. # Mutable for portfolio bidding strategies only. + # @!attribute [rw] target_roas_tolerance_percent_millis + # @return [::Integer] + # The percent of ROAS(return on advertising spend) degradation tolerance + # allowed to increase traffic diversity and conversion volume, specified in + # millis (for example, 10,000 = 10%). A value of 10,000 means that the + # advertiser can expect ROAS degradation of up to 10% of the specified target + # ROAS. class MaximizeConversionValue include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -148,7 +155,7 @@ class TargetCpa # Target CPM (cost per thousand impressions) is an automated bidding strategy # that sets bids to optimize performance given the target CPM you set. # @!attribute [rw] target_frequency_goal - # @return [::Google::Ads::GoogleAds::V19::Common::TargetCpmTargetFrequencyGoal] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetCpmTargetFrequencyGoal] # Target Frequency bidding goal details. class TargetCpm include ::Google::Protobuf::MessageExts @@ -161,7 +168,7 @@ class TargetCpm # Target Frequency count representing how many times you want to reach # a single user. # @!attribute [rw] time_unit - # @return [::Google::Ads::GoogleAds::V19::Enums::TargetFrequencyTimeUnitEnum::TargetFrequencyTimeUnit] + # @return [::Google::Ads::GoogleAds::V21::Enums::TargetFrequencyTimeUnitEnum::TargetFrequencyTimeUnit] # Time window expressing the period over which you want to reach # the specified target_count. class TargetCpmTargetFrequencyGoal @@ -173,7 +180,7 @@ class TargetCpmTargetFrequencyGoal # search ads are shown at the top of the first page (or other targeted # location). # @!attribute [rw] location - # @return [::Google::Ads::GoogleAds::V19::Enums::TargetImpressionShareLocationEnum::TargetImpressionShareLocation] + # @return [::Google::Ads::GoogleAds::V21::Enums::TargetImpressionShareLocationEnum::TargetImpressionShareLocation] # The targeted location on the search results page. # @!attribute [rw] location_fraction_micros # @return [::Integer] @@ -205,6 +212,13 @@ class TargetImpressionShare # Minimum bid limit that can be set by the bid strategy. # The limit applies to all keywords managed by the strategy. # This should only be set for portfolio bid strategies. + # @!attribute [rw] target_roas_tolerance_percent_millis + # @return [::Integer] + # The percent of ROAS(return on advertising spend) degradation tolerance + # allowed to increase traffic diversity and conversion volume, specified in + # millis (for example, 10,000 = 10%). A value of 10,000 means that the + # advertiser can expect ROAS degradation of up to 10% of the specified target + # ROAS. This field is only mutable for portfolio bidding strategies. class TargetRoas include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -253,11 +267,11 @@ class PercentCpc # Fixed CPM (cost per thousand impression) bidding strategy. A manual bidding # strategy with a fixed CPM. # @!attribute [rw] goal - # @return [::Google::Ads::GoogleAds::V19::Enums::FixedCpmGoalEnum::FixedCpmGoal] + # @return [::Google::Ads::GoogleAds::V21::Enums::FixedCpmGoalEnum::FixedCpmGoal] # Fixed CPM bidding goal. Determines the exact bidding optimization # parameters. # @!attribute [rw] target_frequency_info - # @return [::Google::Ads::GoogleAds::V19::Common::FixedCpmTargetFrequencyGoalInfo] + # @return [::Google::Ads::GoogleAds::V21::Common::FixedCpmTargetFrequencyGoalInfo] # Target frequency bidding goal details. class FixedCpm include ::Google::Protobuf::MessageExts @@ -271,7 +285,7 @@ class FixedCpm # Target frequency count represents the number of times an advertiser wants # to show the ad to target a single user. # @!attribute [rw] time_unit - # @return [::Google::Ads::GoogleAds::V19::Enums::FixedCpmTargetFrequencyTimeUnitEnum::FixedCpmTargetFrequencyTimeUnit] + # @return [::Google::Ads::GoogleAds::V21::Enums::FixedCpmTargetFrequencyTimeUnitEnum::FixedCpmTargetFrequencyTimeUnit] # Time window expressing the period over which you want to reach # the specified target_count. class FixedCpmTargetFrequencyGoalInfo diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/custom_parameter.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/custom_parameter.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/custom_parameter.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/custom_parameter.rb index 9469deb25..06fbd9e99 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/custom_parameter.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/custom_parameter.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Common # A mapping that can be used by custom parameter tags in a # `tracking_url_template`, `final_urls`, or `mobile_final_urls`. diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/frequency_cap.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/frequency_cap.rb similarity index 89% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/frequency_cap.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/frequency_cap.rb index 56ad641c5..3152b9e7d 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/frequency_cap.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/frequency_cap.rb @@ -20,12 +20,12 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Common # A rule specifying the maximum number of times an ad (or some set of ads) can # be shown to a user over a particular time period. # @!attribute [rw] key - # @return [::Google::Ads::GoogleAds::V19::Common::FrequencyCapKey] + # @return [::Google::Ads::GoogleAds::V21::Common::FrequencyCapKey] # The key of a particular frequency cap. There can be no more # than one frequency cap with the same key. # @!attribute [rw] cap @@ -39,14 +39,14 @@ class FrequencyCapEntry # A group of fields used as keys for a frequency cap. # There can be no more than one frequency cap with the same key. # @!attribute [rw] level - # @return [::Google::Ads::GoogleAds::V19::Enums::FrequencyCapLevelEnum::FrequencyCapLevel] + # @return [::Google::Ads::GoogleAds::V21::Enums::FrequencyCapLevelEnum::FrequencyCapLevel] # The level on which the cap is to be applied (for example, ad group ad, ad # group). The cap is applied to all the entities of this level. # @!attribute [rw] event_type - # @return [::Google::Ads::GoogleAds::V19::Enums::FrequencyCapEventTypeEnum::FrequencyCapEventType] + # @return [::Google::Ads::GoogleAds::V21::Enums::FrequencyCapEventTypeEnum::FrequencyCapEventType] # The type of event that the cap applies to (for example, impression). # @!attribute [rw] time_unit - # @return [::Google::Ads::GoogleAds::V19::Enums::FrequencyCapTimeUnitEnum::FrequencyCapTimeUnit] + # @return [::Google::Ads::GoogleAds::V21::Enums::FrequencyCapTimeUnitEnum::FrequencyCapTimeUnit] # Unit of time the cap is defined at (for example, day, week). # @!attribute [rw] time_length # @return [::Integer] diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/real_time_bidding_setting.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/real_time_bidding_setting.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/real_time_bidding_setting.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/real_time_bidding_setting.rb index ac641bc3a..af63d473f 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/real_time_bidding_setting.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/real_time_bidding_setting.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Common # Settings for Real-Time Bidding, a feature only available for campaigns # targeting the Ad Exchange network. diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/targeting_setting.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/targeting_setting.rb similarity index 91% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/targeting_setting.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/targeting_setting.rb index dd441a818..c55bedb5c 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/common/targeting_setting.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/targeting_setting.rb @@ -20,17 +20,17 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Common # Settings for the targeting-related features, at the campaign and ad group # levels. For more details about the targeting setting, visit # https://support.google.com/google-ads/answer/7365594 # @!attribute [rw] target_restrictions - # @return [::Array<::Google::Ads::GoogleAds::V19::Common::TargetRestriction>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::TargetRestriction>] # The per-targeting-dimension setting to restrict the reach of your campaign # or ad group. # @!attribute [rw] target_restriction_operations - # @return [::Array<::Google::Ads::GoogleAds::V19::Common::TargetRestrictionOperation>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::TargetRestrictionOperation>] # The list of operations changing the target restrictions. # # Adding a target restriction with a targeting dimension that already exists @@ -42,7 +42,7 @@ class TargetingSetting # The list of per-targeting-dimension targeting settings. # @!attribute [rw] targeting_dimension - # @return [::Google::Ads::GoogleAds::V19::Enums::TargetingDimensionEnum::TargetingDimension] + # @return [::Google::Ads::GoogleAds::V21::Enums::TargetingDimensionEnum::TargetingDimension] # The targeting dimension that these settings apply to. # @!attribute [rw] bid_only # @return [::Boolean] @@ -60,10 +60,10 @@ class TargetRestriction # Operation to be performed on a target restriction list in a mutate. # @!attribute [rw] operator - # @return [::Google::Ads::GoogleAds::V19::Common::TargetRestrictionOperation::Operator] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetRestrictionOperation::Operator] # Type of list operation to perform. # @!attribute [rw] value - # @return [::Google::Ads::GoogleAds::V19::Common::TargetRestriction] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetRestriction] # The target restriction being added to or removed from the list. class TargetRestrictionOperation include ::Google::Protobuf::MessageExts diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/third_party_integration_partners.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/third_party_integration_partners.rb new file mode 100644 index 000000000..dbf5a807c --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/common/third_party_integration_partners.rb @@ -0,0 +1,190 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Common + # Container for Customer level third party integration partners. + # @!attribute [rw] viewability_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CustomerThirdPartyViewabilityIntegrationPartner>] + # Allowed third party integration partners for YouTube viewability + # verification. + # @!attribute [rw] brand_lift_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CustomerThirdPartyBrandLiftIntegrationPartner>] + # Allowed third party integration partners for Brand Lift verification. + # @!attribute [rw] brand_safety_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CustomerThirdPartyBrandSafetyIntegrationPartner>] + # Allowed third party integration partners for brand safety verification. + # @!attribute [rw] reach_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CustomerThirdPartyReachIntegrationPartner>] + # Allowed third party integration partners for reach verification. + class CustomerThirdPartyIntegrationPartners + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party viewability integration data for Customer. + # @!attribute [rw] viewability_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyViewabilityIntegrationPartnerEnum::ThirdPartyViewabilityIntegrationPartner] + # Allowed third party integration partners for YouTube viewability + # verification. + # @!attribute [rw] allow_share_cost + # @return [::Boolean] + # If true, cost data can be shared with this vendor. + class CustomerThirdPartyViewabilityIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party brand safety integration data for Customer. + # @!attribute [rw] brand_safety_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyBrandSafetyIntegrationPartnerEnum::ThirdPartyBrandSafetyIntegrationPartner] + # Allowed third party integration partners for brand safety verification. + class CustomerThirdPartyBrandSafetyIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party Brand Lift integration data for Customer. + # @!attribute [rw] brand_lift_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyBrandLiftIntegrationPartnerEnum::ThirdPartyBrandLiftIntegrationPartner] + # Allowed Third Party integration partners for Brand Lift verification. + # @!attribute [rw] allow_share_cost + # @return [::Boolean] + # If true, cost data can be shared with this vendor. + class CustomerThirdPartyBrandLiftIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party reach integration data for Customer. + # @!attribute [rw] reach_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyReachIntegrationPartnerEnum::ThirdPartyReachIntegrationPartner] + # Allowed Third Party integration partners for reach verification. + # @!attribute [rw] allow_share_cost + # @return [::Boolean] + # If true, cost data can be shared with this vendor. + class CustomerThirdPartyReachIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for Campaign level third party integration partners. + # @!attribute [rw] viewability_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CampaignThirdPartyViewabilityIntegrationPartner>] + # Third party integration partners for YouTube viewability + # verification for this Campaign. + # @!attribute [rw] brand_lift_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CampaignThirdPartyBrandLiftIntegrationPartner>] + # Third party integration partners for Brand Lift verification for this + # Campaign. + # @!attribute [rw] brand_safety_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CampaignThirdPartyBrandSafetyIntegrationPartner>] + # Third party integration partners for brand safety verification for this + # Campaign. + # @!attribute [rw] reach_integration_partners + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CampaignThirdPartyReachIntegrationPartner>] + # Third party integration partners for reach verification for this Campaign. + class CampaignThirdPartyIntegrationPartners + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party viewability integration data for Campaign. + # @!attribute [rw] viewability_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyViewabilityIntegrationPartnerEnum::ThirdPartyViewabilityIntegrationPartner] + # Allowed third party integration partners for YouTube viewability + # verification. + # @!attribute [rw] viewability_integration_partner_data + # @return [::Google::Ads::GoogleAds::V21::Common::ThirdPartyIntegrationPartnerData] + # Third party partner data for YouTube viewability verification. This is + # optional metadata for partners to join or attach data to Ads campaigns. + # @!attribute [rw] share_cost + # @return [::Boolean] + # If true, then cost data will be shared with this vendor. + class CampaignThirdPartyViewabilityIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party brand safety integration data for Campaign. + # @!attribute [rw] brand_safety_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyBrandSafetyIntegrationPartnerEnum::ThirdPartyBrandSafetyIntegrationPartner] + # Allowed third party integration partners for brand safety verification. + # @!attribute [rw] brand_safety_integration_partner_data + # @return [::Google::Ads::GoogleAds::V21::Common::ThirdPartyIntegrationPartnerData] + # Third party partner data for YouTube brand safety verification. This is + # optional metadata for partners to join or attach data to Ads campaigns. + class CampaignThirdPartyBrandSafetyIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party Brand Lift integration data for Campaign. + # @!attribute [rw] brand_lift_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyBrandLiftIntegrationPartnerEnum::ThirdPartyBrandLiftIntegrationPartner] + # Allowed third party integration partners for Brand Lift verification. + # @!attribute [rw] brand_lift_integration_partner_data + # @return [::Google::Ads::GoogleAds::V21::Common::ThirdPartyIntegrationPartnerData] + # Third party partner data for YouTube Brand Lift verification. This is + # optional metadata for partners to join or attach data to Ads campaigns. + # @!attribute [rw] share_cost + # @return [::Boolean] + # If true, then cost data will be shared with this vendor. + class CampaignThirdPartyBrandLiftIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for third party reach integration data for Campaign. + # @!attribute [rw] reach_integration_partner + # @return [::Google::Ads::GoogleAds::V21::Enums::ThirdPartyReachIntegrationPartnerEnum::ThirdPartyReachIntegrationPartner] + # Allowed third party integration partners for reach verification. + # @!attribute [rw] reach_integration_partner_data + # @return [::Google::Ads::GoogleAds::V21::Common::ThirdPartyIntegrationPartnerData] + # Third party partner data for YouTube Reach verification. This is + # optional metadata for partners to join or attach data to Ads campaigns. + # @!attribute [rw] share_cost + # @return [::Boolean] + # If true, then cost data will be shared with this vendor. + class CampaignThirdPartyReachIntegrationPartner + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Contains third party measurement partner related data for video campaigns. + # @!attribute [rw] client_id + # @return [::String] + # The client ID that allows the measurement partner to join multiple + # campaigns for a particular advertiser. + # @!attribute [rw] third_party_placement_id + # @return [::String] + # The third party placement ID that maps the measurement partner data with a + # campaign (or a group of related campaigns) specific data. + class ThirdPartyIntegrationPartnerData + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_group_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_group_type.rb new file mode 100644 index 000000000..ffe65cd4b --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_group_type.rb @@ -0,0 +1,98 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Defines types of an ad group, specific to a particular campaign channel + # type. This type drives validations that restrict which entities can be + # added to the ad group. + class AdGroupTypeEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum listing the possible types of an ad group. + module AdGroupType + # The type has not been specified. + UNSPECIFIED = 0 + + # The received value is not known in this version. + # + # This is a response-only value. + UNKNOWN = 1 + + # The default ad group type for Search campaigns. + SEARCH_STANDARD = 2 + + # The default ad group type for Display campaigns. + DISPLAY_STANDARD = 3 + + # The ad group type for Shopping campaigns serving standard product ads. + SHOPPING_PRODUCT_ADS = 4 + + # The default ad group type for Hotel campaigns. + HOTEL_ADS = 6 + + # The type for ad groups in Smart Shopping campaigns. + SHOPPING_SMART_ADS = 7 + + # Short unskippable in-stream video ads. + VIDEO_BUMPER = 8 + + # TrueView (skippable) in-stream video ads. + VIDEO_TRUE_VIEW_IN_STREAM = 9 + + # TrueView in-display video ads. + VIDEO_TRUE_VIEW_IN_DISPLAY = 10 + + # Unskippable in-stream video ads. + VIDEO_NON_SKIPPABLE_IN_STREAM = 11 + + # Ad group type for Dynamic Search Ads ad groups. + SEARCH_DYNAMIC_ADS = 13 + + # The type for ad groups in Shopping Comparison Listing campaigns. + SHOPPING_COMPARISON_LISTING_ADS = 14 + + # The ad group type for Promoted Hotel ad groups. + PROMOTED_HOTEL_ADS = 15 + + # Video responsive ad groups. + VIDEO_RESPONSIVE = 16 + + # Video efficient reach ad groups. + VIDEO_EFFICIENT_REACH = 17 + + # Ad group type for Smart campaigns. + SMART_CAMPAIGN_ADS = 18 + + # Ad group type for Travel campaigns. + TRAVEL_ADS = 19 + + # Ad group type for YouTube Audio campaigns. + YOUTUBE_AUDIO = 20 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/ad_serving_optimization_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_serving_optimization_status.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/ad_serving_optimization_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_serving_optimization_status.rb index 5d1d3d6f8..6bb41acb5 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/ad_serving_optimization_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/ad_serving_optimization_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Possible ad serving statuses of a campaign. class AdServingOptimizationStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_sub_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_sub_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_sub_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_sub_type.rb index f4aad8b94..86523a560 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_sub_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_sub_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # An immutable specialization of an Advertising Channel. class AdvertisingChannelSubTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_type.rb index bbf3e56f4..7df452efc 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/advertising_channel_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/advertising_channel_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # The channel type a campaign may target to serve on. class AdvertisingChannelTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_app_store.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_app_store.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_app_store.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_app_store.rb index 075ffff33..333d525be 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_app_store.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_app_store.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # The application store that distributes mobile applications. class AppCampaignAppStoreEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_bidding_strategy_goal_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_bidding_strategy_goal_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_bidding_strategy_goal_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_bidding_strategy_goal_type.rb index 3769c24b4..9dbcb934e 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/app_campaign_bidding_strategy_goal_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/app_campaign_bidding_strategy_goal_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing goal towards which the bidding strategy of an # app campaign should optimize for. diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_status.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_status.rb index ebc430341..d71c9ecdf 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the status of asset automation. class AssetAutomationStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_type.rb similarity index 60% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_type.rb index 9a29faed6..ca2bfadb0 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_automation_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_automation_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the type of asset automation. class AssetAutomationTypeEnum @@ -35,19 +35,25 @@ module AssetAutomationType # Used as a return value only. Represents value unknown in this version. UNKNOWN = 1 - # Text asset automation includes headlines and descriptions. - # By default, advertisers are opted-in for Performance Max and + # Text asset automation (text customization) includes headlines and + # descriptions, allowing Google to create customized text assets using your + # existing ads, landing page copy, and generative AI across your campaign's + # ads. By default, advertisers are opted-in for Performance Max and # opted-out for Search. + # + # Contrast this with `FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION`, which + # dynamically generates text assets to match the content of dynamically + # selected landing pages when final URL expansion is active. TEXT_ASSET_AUTOMATION = 2 # Converts horizontal video assets to vertical orientation using # content-aware technology. By default, advertisers are opted in for - # DemandGenVideoResponsiveAd. + # DemandGenVideoResponsiveAdInfo. GENERATE_VERTICAL_YOUTUBE_VIDEOS = 3 # Shortens video assets to better capture user attention using # content-aware technology. By default, advertisers are opted in for - # DemandGenVideoResponsiveAd. + # DemandGenVideoResponsiveAdInfo. GENERATE_SHORTER_YOUTUBE_VIDEOS = 4 # Generates a preview of the landing page shown in the engagement panel. @@ -61,6 +67,21 @@ module AssetAutomationType # Generates video enhancements (vertical and shorter videos) for PMax # campaigns. Opted in by default. GENERATE_ENHANCED_YOUTUBE_VIDEOS = 6 + + # Controls automation for text assets related to Final URL expansion. This + # includes automatically creating dynamic landing pages from the final URL + # and generating text assets from the content of those landing pages. This + # setting is turned OFF by default for Search campaigns, but it is turned + # ON by default for Performance Max campaigns. + # + # Enabling final URL expansion also enables text asset automation. There is + # no way to opt out of text asset automation and still use final URL + # expansion. + # + # Contrast this with standard `TEXT_ASSET_AUTOMATION` (text customization), + # which customizes copy across all ads in the campaign even when final URL + # expansion does not occur. + FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = 11 end end end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_field_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_field_type.rb similarity index 97% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_field_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_field_type.rb index f4ed3d0a0..0e8f8a56d 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_field_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_field_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the possible placements of an asset. class AssetFieldTypeEnum @@ -126,6 +126,9 @@ module AssetFieldType # The asset is linked for use as a tall portrait marketing image. TALL_PORTRAIT_MARKETING_IMAGE = 32 + + # The asset is linked for use as related YouTube videos. + RELATED_YOUTUBE_VIDEOS = 33 end end end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_set_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_set_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_set_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_set_type.rb index e52d9e17d..1c0debf21 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/asset_set_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/asset_set_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible types of an asset set. class AssetSetTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_system_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_system_status.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_system_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_system_status.rb index 2770a5aa1..38bf3501a 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_system_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_system_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Message describing BiddingStrategy system statuses. class BiddingStrategySystemStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_type.rb index 5a9d616a8..b5488a657 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/bidding_strategy_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/bidding_strategy_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible bidding strategy types. class BiddingStrategyTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/brand_safety_suitability.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/brand_safety_suitability.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/brand_safety_suitability.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/brand_safety_suitability.rb index 81fea24a5..9bb9a9140 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/brand_safety_suitability.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/brand_safety_suitability.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum with 3-Tier brand safety suitability control. class BrandSafetySuitabilityEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_experiment_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_experiment_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_experiment_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_experiment_type.rb index a67a37645..c3788d6f7 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_experiment_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_experiment_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing campaign experiment type. class CampaignExperimentTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_keyword_match_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_keyword_match_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_keyword_match_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_keyword_match_type.rb index ae91a57ff..b6da68071 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_keyword_match_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_keyword_match_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing keyword match type. class CampaignKeywordMatchTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status.rb index 98883303e..00e957012 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible campaign primary status. class CampaignPrimaryStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status_reason.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status_reason.rb similarity index 97% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status_reason.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status_reason.rb index 046131524..688360428 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_primary_status_reason.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_primary_status_reason.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible campaign primary status reasons. class CampaignPrimaryStatusReasonEnum @@ -154,6 +154,10 @@ module CampaignPrimaryStatusReason # All asset groups in this campaign are paused. ASSET_GROUPS_PAUSED = 38 + + # The campaign has location restrictions but does not specify location + # targeting. + MISSING_LOCATION_TARGETING = 39 end end end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_serving_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_serving_status.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_serving_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_serving_status.rb index aa9a256b9..2c1f0eb86 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_serving_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_serving_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Message describing Campaign serving statuses. class CampaignServingStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_status.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_status.rb index 22d4468d7..483109338 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/campaign_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/campaign_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible statuses of a campaign. class CampaignStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/eu_political_advertising_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/eu_political_advertising_status.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/eu_political_advertising_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/eu_political_advertising_status.rb index 2dd789a58..f41f07d4c 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/eu_political_advertising_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/eu_political_advertising_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing whether or not the campaign contains political # advertising targeted towards the European Union. diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_goal.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_goal.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_goal.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_goal.rb index 8be626837..fffcac633 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_goal.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_goal.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for describing the goal of the Fixed CPM bidding strategy. class FixedCpmGoalEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_target_frequency_time_unit.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_target_frequency_time_unit.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_target_frequency_time_unit.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_target_frequency_time_unit.rb index 4f381fdfc..172eb0326 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/fixed_cpm_target_frequency_time_unit.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/fixed_cpm_target_frequency_time_unit.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing bidding goal target frequency time units. class FixedCpmTargetFrequencyTimeUnitEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_event_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_event_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_event_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_event_type.rb index ca7d32806..da826bfdf 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_event_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_event_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the type of event that the cap applies to. class FrequencyCapEventTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_level.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_level.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_level.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_level.rb index 24871520b..d6a2b3604 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_level.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_level.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the level on which the cap is to be applied. class FrequencyCapLevelEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_time_unit.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_time_unit.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_time_unit.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_time_unit.rb index 82a524390..df7786057 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/frequency_cap_time_unit.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/frequency_cap_time_unit.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the unit of time the cap is defined at. class FrequencyCapTimeUnitEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/listing_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/listing_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/listing_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/listing_type.rb index c3201cc32..9109f7ff5 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/listing_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/listing_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible listing types. class ListingTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/location_source_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/location_source_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/location_source_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/location_source_type.rb index 91570109d..f5ccbd684 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/location_source_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/location_source_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Used to distinguish the location source type. class LocationSourceTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/negative_geo_target_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/negative_geo_target_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/negative_geo_target_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/negative_geo_target_type.rb index 01e5db863..fd4cd4790 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/negative_geo_target_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/negative_geo_target_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible negative geo target types. class NegativeGeoTargetTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_max_duration.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_max_duration.rb new file mode 100644 index 000000000..bc7769889 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_max_duration.rb @@ -0,0 +1,54 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing the allowed maximum duration values for videos + # used in non-skippable video responsive ads. + class NonSkippableMaxDurationEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing the allowed maximum duration values for videos used in + # non-skippable video responsive ads. + module NonSkippableMaxDuration + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Indicates that non-skippable ads must be at most 15 seconds long. + MAX_DURATION_FIFTEEN_SECONDS = 2 + + # Indicates that non-skippable ads must be at most 30 seconds long. + MAX_DURATION_THIRTY_SECONDS = 3 + + # Indicates that non-skippable ads must be at most 60 seconds long. + MAX_DURATION_SIXTY_SECONDS = 4 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_min_duration.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_min_duration.rb new file mode 100644 index 000000000..ca45c2c95 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/non_skippable_min_duration.rb @@ -0,0 +1,57 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing the allowed minimum duration values for videos + # used in non-skippable video responsive ads. + class NonSkippableMinDurationEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing the allowed minimum duration values for videos used in + # non-skippable video responsive ads. + module NonSkippableMinDuration + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Indicates that non-skippable ads must be at least 5 seconds long. + MIN_DURATION_FIVE_SECONDS = 2 + + # Indicates that non-skippable ads must be at least 7 seconds long. + MIN_DURATION_SEVEN_SECONDS = 3 + + # Indicates that non-skippable ads must be at least 16 seconds long. + MIN_DURATION_SIXTEEN_SECONDS = 4 + + # Indicates that non-skippable ads must be at least 31 seconds long. + MIN_DURATION_THIRTY_ONE_SECONDS = 5 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/optimization_goal_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/optimization_goal_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/optimization_goal_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/optimization_goal_type.rb index 644dee22b..12387567b 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/optimization_goal_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/optimization_goal_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing the type of optimization goal. class OptimizationGoalTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/payment_mode.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/payment_mode.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/payment_mode.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/payment_mode.rb index ae5b2bdf5..6ae4a97b7 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/payment_mode.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/payment_mode.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible payment modes. class PaymentModeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/performance_max_upgrade_status.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/performance_max_upgrade_status.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/performance_max_upgrade_status.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/performance_max_upgrade_status.rb index 86b17a406..8c322eeb1 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/performance_max_upgrade_status.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/performance_max_upgrade_status.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Performance Max Upgrade status for campaign. class PerformanceMaxUpgradeStatusEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/positive_geo_target_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/positive_geo_target_type.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/positive_geo_target_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/positive_geo_target_type.rb index 837f0c93a..a90c83743 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/positive_geo_target_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/positive_geo_target_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing possible positive geo target types. class PositiveGeoTargetTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/response_content_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/response_content_type.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/response_content_type.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/response_content_type.rb index 220d18beb..2212318f1 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/response_content_type.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/response_content_type.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for possible response content types. class ResponseContentTypeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_frequency_time_unit.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_frequency_time_unit.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_frequency_time_unit.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_frequency_time_unit.rb index e48bff8d9..19ab4f6f3 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_frequency_time_unit.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_frequency_time_unit.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing bidding goal Target Frequency time units. class TargetFrequencyTimeUnitEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_impression_share_location.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_impression_share_location.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_impression_share_location.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_impression_share_location.rb index 6e6e3aebc..d8c58e03b 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/target_impression_share_location.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/target_impression_share_location.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # Container for enum describing where on the first search results page the # automated bidding system should target impressions for the diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/targeting_dimension.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/targeting_dimension.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/targeting_dimension.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/targeting_dimension.rb index 2c3db259d..0a619737a 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/targeting_dimension.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/targeting_dimension.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # The dimensions that can be targeted. class TargetingDimensionEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_lift_integration_partner.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_lift_integration_partner.rb new file mode 100644 index 000000000..de464d051 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_lift_integration_partner.rb @@ -0,0 +1,57 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing available third party integration partners for + # Brand Lift verification. + class ThirdPartyBrandLiftIntegrationPartnerEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing available third party integration partners for Brand Lift + # verification. + module ThirdPartyBrandLiftIntegrationPartner + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Kantar + KANTAR_MILLWARD_BROWN = 2 + + # Dynata + DYNATA = 3 + + # Intage + INTAGE = 4 + + # Macromill + MACROMILL = 5 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_safety_integration_partner.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_safety_integration_partner.rb new file mode 100644 index 000000000..40b7c39c7 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_brand_safety_integration_partner.rb @@ -0,0 +1,54 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing available third party integration partners for + # brand safety verification. + class ThirdPartyBrandSafetyIntegrationPartnerEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing available third party integration partners for brand safety + # verification. + module ThirdPartyBrandSafetyIntegrationPartner + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # DoubleVerify. + DOUBLE_VERIFY = 2 + + # Integral Ad Science. + INTEGRAL_AD_SCIENCE = 3 + + # Zefr. + ZEFR = 4 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_reach_integration_partner.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_reach_integration_partner.rb new file mode 100644 index 000000000..409ac6552 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_reach_integration_partner.rb @@ -0,0 +1,72 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing available third party integration partners for + # reach verification. + class ThirdPartyReachIntegrationPartnerEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing available third party integration partners for reach + # verification. + module ThirdPartyReachIntegrationPartner + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Nielsen. + NIELSEN = 2 + + # Comscore. + COMSCORE = 3 + + # Kantar. + KANTAR_MILLWARD_BROWN = 4 + + # Video Research. + VIDEO_RESEARCH = 5 + + # Gemius. + GEMIUS = 6 + + # MediaScope. + MEDIA_SCOPE = 7 + + # AudienceProject + AUDIENCE_PROJECT = 8 + + # VideoAmp + VIDEO_AMP = 9 + + # iSpot.tv + ISPOT_TV = 10 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_viewability_integration_partner.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_viewability_integration_partner.rb new file mode 100644 index 000000000..c282477bf --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/third_party_viewability_integration_partner.rb @@ -0,0 +1,51 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing available third party integration partners for + # YouTube viewability verification. + class ThirdPartyViewabilityIntegrationPartnerEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing available third party integration partners for YouTube + # viewability verification. + module ThirdPartyViewabilityIntegrationPartner + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # DoubleVerify. + DOUBLE_VERIFY = 2 + + # Integral Ad Science. + INTEGRAL_AD_SCIENCE = 3 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_display_url_mode.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_display_url_mode.rb similarity index 98% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_display_url_mode.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_display_url_mode.rb index 3283f9de6..ff8660b7c 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_display_url_mode.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_display_url_mode.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # The display mode for vanity pharma URLs. class VanityPharmaDisplayUrlModeEnum diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_text.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_text.rb similarity index 99% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_text.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_text.rb index d5bc96a48..9ac6f2869 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/enums/vanity_pharma_text.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/vanity_pharma_text.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Enums # The text that will be displayed in display URL of the text ad when website # description is the selected display mode for vanity pharma URLs. diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_format_restriction.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_format_restriction.rb new file mode 100644 index 000000000..9670384ad --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_format_restriction.rb @@ -0,0 +1,47 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing format restrictions for video responsive ads in + # video campaigns. + class VideoAdFormatRestrictionEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing format restrictions for responsive ads in video campaigns. + module VideoAdFormatRestriction + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Non-skippable in-stream video responsive ad. + NON_SKIPPABLE_IN_STREAM = 2 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_interaction_type.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_interaction_type.rb new file mode 100644 index 000000000..56464d0c9 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_interaction_type.rb @@ -0,0 +1,62 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing an interaction between a viewer and a video in + # a video ad sequence. + class VideoAdSequenceInteractionTypeEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing an interaction between a viewer and a video in a video ad + # sequence. + module VideoAdSequenceInteractionType + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # The viewer engaged with or watched at least 30 seconds of the ad (or the + # entire ad, if it was less than 30 seconds). Only available for campaigns + # using Target CPM as the bidding strategy and skippable in-stream ads as + # the ad format. + PAID_VIEW = 2 + + # The viewer skipped the ad. Only available for campaigns using Target CPM + # as the bidding strategy and skippable in-stream ads as the ad format. + SKIP = 3 + + # The ad was shown to the viewer. + IMPRESSION = 4 + + # An ad impression that was not immediately skipped, but didn't reach the + # billable event either. + ENGAGED_IMPRESSION = 5 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_minimum_duration.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_minimum_duration.rb new file mode 100644 index 000000000..4e41d9cd5 --- /dev/null +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/enums/video_ad_sequence_minimum_duration.rb @@ -0,0 +1,54 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Google + module Ads + module GoogleAds + module V21 + module Enums + # Container for enum describing possible times after starting a video ad + # sequence when a user is eligible to repeat the sequence. + class VideoAdSequenceMinimumDurationEnum + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing possible times after starting a video ad sequence when a + # user is eligible to repeat the sequence. + module VideoAdSequenceMinimumDuration + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Users are eligible to restart a sequence once they have completed the + # sequence and at least 7 days have passed since sequence start. + WEEK = 2 + + # Users are eligible to restart a sequence once at least 30 days have + # passed since sequence start. Users are eligible to start the sequence + # again even if they haven't completed the sequence. + MONTH = 3 + end + end + end + end + end + end +end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/resources/campaign.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/resources/campaign.rb similarity index 74% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/resources/campaign.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/resources/campaign.rb index 48823e46d..8dac7965f 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/resources/campaign.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/resources/campaign.rb @@ -20,7 +20,7 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Resources # A campaign. # @!attribute [rw] resource_name @@ -42,35 +42,35 @@ module Resources # It must not contain any null (code point 0x0), NL line feed # (code point 0xA) or carriage return (code point 0xD) characters. # @!attribute [r] primary_status - # @return [::Google::Ads::GoogleAds::V19::Enums::CampaignPrimaryStatusEnum::CampaignPrimaryStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::CampaignPrimaryStatusEnum::CampaignPrimaryStatus] # Output only. The primary status of the campaign. # # Provides insight into why a campaign is not serving or not serving # optimally. Modification to the campaign and its related entities might take # a while to be reflected in this status. # @!attribute [r] primary_status_reasons - # @return [::Array<::Google::Ads::GoogleAds::V19::Enums::CampaignPrimaryStatusReasonEnum::CampaignPrimaryStatusReason>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Enums::CampaignPrimaryStatusReasonEnum::CampaignPrimaryStatusReason>] # Output only. The primary status reasons of the campaign. # # Provides insight into why a campaign is not serving or not serving # optimally. These reasons are aggregated to determine an overall # CampaignPrimaryStatus. # @!attribute [rw] status - # @return [::Google::Ads::GoogleAds::V19::Enums::CampaignStatusEnum::CampaignStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::CampaignStatusEnum::CampaignStatus] # The status of the campaign. # # When a new campaign is added, the status defaults to ENABLED. # @!attribute [r] serving_status - # @return [::Google::Ads::GoogleAds::V19::Enums::CampaignServingStatusEnum::CampaignServingStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::CampaignServingStatusEnum::CampaignServingStatus] # Output only. The ad serving status of the campaign. # @!attribute [r] bidding_strategy_system_status - # @return [::Google::Ads::GoogleAds::V19::Enums::BiddingStrategySystemStatusEnum::BiddingStrategySystemStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::BiddingStrategySystemStatusEnum::BiddingStrategySystemStatus] # Output only. The system status of the campaign's bidding strategy. # @!attribute [rw] ad_serving_optimization_status - # @return [::Google::Ads::GoogleAds::V19::Enums::AdServingOptimizationStatusEnum::AdServingOptimizationStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::AdServingOptimizationStatusEnum::AdServingOptimizationStatus] # The ad serving optimization status of the campaign. # @!attribute [rw] advertising_channel_type - # @return [::Google::Ads::GoogleAds::V19::Enums::AdvertisingChannelTypeEnum::AdvertisingChannelType] + # @return [::Google::Ads::GoogleAds::V21::Enums::AdvertisingChannelTypeEnum::AdvertisingChannelType] # Immutable. The primary serving target for ads within the campaign. # The targeting options can be refined in `network_settings`. # @@ -80,7 +80,7 @@ module Resources # Can be set only when creating campaigns. # After the campaign is created, the field can not be changed. # @!attribute [rw] advertising_channel_sub_type - # @return [::Google::Ads::GoogleAds::V19::Enums::AdvertisingChannelSubTypeEnum::AdvertisingChannelSubType] + # @return [::Google::Ads::GoogleAds::V21::Enums::AdvertisingChannelSubTypeEnum::AdvertisingChannelSubType] # Immutable. Optional refinement to `advertising_channel_type`. # Must be a valid sub-type of the parent channel type. # @@ -90,60 +90,60 @@ module Resources # @return [::String] # The URL template for constructing a tracking URL. # @!attribute [rw] url_custom_parameters - # @return [::Array<::Google::Ads::GoogleAds::V19::Common::CustomParameter>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::CustomParameter>] # The list of mappings used to substitute custom parameter tags in a # `tracking_url_template`, `final_urls`, or `mobile_final_urls`. # @!attribute [rw] local_services_campaign_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::LocalServicesCampaignSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::LocalServicesCampaignSettings] # The Local Services Campaign related settings. # @!attribute [rw] travel_campaign_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::TravelCampaignSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::TravelCampaignSettings] # Settings for Travel campaign. # @!attribute [rw] demand_gen_campaign_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::DemandGenCampaignSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::DemandGenCampaignSettings] # Settings for Demand Gen campaign. # @!attribute [rw] video_campaign_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::VideoCampaignSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings] # Settings for Video campaign. # @!attribute [rw] pmax_campaign_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::PmaxCampaignSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::PmaxCampaignSettings] # Settings for Performance Max campaign. # @!attribute [rw] real_time_bidding_setting - # @return [::Google::Ads::GoogleAds::V19::Common::RealTimeBiddingSetting] + # @return [::Google::Ads::GoogleAds::V21::Common::RealTimeBiddingSetting] # Settings for Real-Time Bidding, a feature only available for campaigns # targeting the Ad Exchange network. # @!attribute [rw] network_settings - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::NetworkSettings] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::NetworkSettings] # The network settings for the campaign. # @!attribute [rw] hotel_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::HotelSettingInfo] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::HotelSettingInfo] # Immutable. The hotel setting for the campaign. # @!attribute [rw] dynamic_search_ads_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::DynamicSearchAdsSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::DynamicSearchAdsSetting] # The setting for controlling Dynamic Search Ads (DSA). # @!attribute [rw] shopping_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::ShoppingSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::ShoppingSetting] # The setting for controlling Shopping campaigns. # @!attribute [rw] targeting_setting - # @return [::Google::Ads::GoogleAds::V19::Common::TargetingSetting] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetingSetting] # Setting for targeting related features. # @!attribute [rw] audience_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::AudienceSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::AudienceSetting] # Immutable. Setting for audience related features. # @!attribute [rw] geo_target_type_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::GeoTargetTypeSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::GeoTargetTypeSetting] # The setting for ads geotargeting. # @!attribute [rw] local_campaign_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::LocalCampaignSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::LocalCampaignSetting] # The setting for local campaign. # @!attribute [rw] app_campaign_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::AppCampaignSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::AppCampaignSetting] # The setting related to App Campaign. # @!attribute [r] labels # @return [::Array<::String>] # Output only. The resource names of labels attached to this campaign. # @!attribute [r] experiment_type - # @return [::Google::Ads::GoogleAds::V19::Enums::CampaignExperimentTypeEnum::CampaignExperimentType] + # @return [::Google::Ads::GoogleAds::V21::Enums::CampaignExperimentTypeEnum::CampaignExperimentType] # Output only. The type of campaign: normal, draft, or experiment. # @!attribute [r] base_campaign # @return [::String] @@ -155,7 +155,7 @@ module Resources # @return [::String] # The resource name of the campaign budget of the campaign. # @!attribute [r] bidding_strategy_type - # @return [::Google::Ads::GoogleAds::V19::Enums::BiddingStrategyTypeEnum::BiddingStrategyType] + # @return [::Google::Ads::GoogleAds::V21::Enums::BiddingStrategyTypeEnum::BiddingStrategyType] # Output only. The type of bidding strategy. # # A bidding strategy can be created by setting either the bidding scheme to @@ -191,32 +191,32 @@ module Resources # Suffix used to append query parameters to landing pages that are served # with parallel tracking. # @!attribute [rw] frequency_caps - # @return [::Array<::Google::Ads::GoogleAds::V19::Common::FrequencyCapEntry>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Common::FrequencyCapEntry>] # A list that limits how often each user will see this campaign's ads. # @!attribute [rw] video_brand_safety_suitability - # @return [::Google::Ads::GoogleAds::V19::Enums::BrandSafetySuitabilityEnum::BrandSafetySuitability] + # @return [::Google::Ads::GoogleAds::V21::Enums::BrandSafetySuitabilityEnum::BrandSafetySuitability] # Brand Safety setting at the individual campaign level. Allows for selecting # an inventory type to show your ads on content that is the right fit for # your brand. See https://support.google.com/google-ads/answer/7515513. # @!attribute [rw] vanity_pharma - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::VanityPharma] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VanityPharma] # Describes how unbranded pharma ads will be displayed. # @!attribute [rw] selective_optimization - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::SelectiveOptimization] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::SelectiveOptimization] # Selective optimization setting for this campaign, which includes a set of # conversion actions to optimize this campaign towards. # This feature only applies to app campaigns that use MULTI_CHANNEL as # AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as # AdvertisingChannelSubType. # @!attribute [rw] optimization_goal_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::OptimizationGoalSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::OptimizationGoalSetting] # Optimization goal setting for this campaign, which includes a set of # optimization goal types. # @!attribute [r] tracking_setting - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::TrackingSetting] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::TrackingSetting] # Output only. Campaign-level settings for tracking information. # @!attribute [rw] payment_mode - # @return [::Google::Ads::GoogleAds::V19::Enums::PaymentModeEnum::PaymentMode] + # @return [::Google::Ads::GoogleAds::V21::Enums::PaymentModeEnum::PaymentMode] # Payment mode for the campaign. # @!attribute [r] optimization_score # @return [::Float] @@ -232,12 +232,12 @@ module Resources # # This field is read-only. # @!attribute [rw] excluded_parent_asset_field_types - # @return [::Array<::Google::Ads::GoogleAds::V19::Enums::AssetFieldTypeEnum::AssetFieldType>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Enums::AssetFieldTypeEnum::AssetFieldType>] # The asset field types that should be excluded from this campaign. Asset # links with these field types will not be inherited by this campaign from # the upper level. # @!attribute [rw] excluded_parent_asset_set_types - # @return [::Array<::Google::Ads::GoogleAds::V19::Enums::AssetSetTypeEnum::AssetSetType>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Enums::AssetSetTypeEnum::AssetSetType>] # The asset set types that should be excluded from this campaign. Asset set # links with these types will not be inherited by this campaign from # the upper level. @@ -257,23 +257,23 @@ module Resources # only be set for Performance Max campaigns, where the default value is # false. # @!attribute [r] performance_max_upgrade - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::PerformanceMaxUpgrade] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::PerformanceMaxUpgrade] # Output only. Information about campaigns being upgraded to Performance Max. # @!attribute [rw] hotel_property_asset_set # @return [::String] # Immutable. The resource name for a set of hotel properties for Performance # Max for travel goals campaigns. # @!attribute [rw] listing_type - # @return [::Google::Ads::GoogleAds::V19::Enums::ListingTypeEnum::ListingType] + # @return [::Google::Ads::GoogleAds::V21::Enums::ListingTypeEnum::ListingType] # Immutable. Listing type of ads served for this campaign. # Field is restricted for usage with Performance Max campaigns. # @!attribute [rw] asset_automation_settings - # @return [::Array<::Google::Ads::GoogleAds::V19::Resources::Campaign::AssetAutomationSetting>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Resources::Campaign::AssetAutomationSetting>] # Contains the opt-in/out status of each AssetAutomationType. # See documentation of each asset automation type enum for default # opt in/out behavior. # @!attribute [rw] keyword_match_type - # @return [::Google::Ads::GoogleAds::V19::Enums::CampaignKeywordMatchTypeEnum::CampaignKeywordMatchType] + # @return [::Google::Ads::GoogleAds::V21::Enums::CampaignKeywordMatchTypeEnum::CampaignKeywordMatchType] # Keyword match type of Campaign. Set to BROAD to set broad matching for all # keywords in a campaign. # @!attribute [rw] brand_guidelines_enabled @@ -298,106 +298,120 @@ module Resources # Performance Max campaigns with Travel Goals. Attempting to set this field # to true for a Travel Goals campaign will result in an error. # @!attribute [rw] brand_guidelines - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::BrandGuidelines] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::BrandGuidelines] # These settings control how your brand appears in automatically generated # assets and formats within this campaign. Note: These settings can only be # used for Performance Max campaigns that have Brand Guidelines enabled. + # @!attribute [rw] third_party_integration_partners + # @return [::Google::Ads::GoogleAds::V21::Common::CampaignThirdPartyIntegrationPartners] + # Third-Party integration partners. + # @!attribute [rw] ai_max_setting + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::AiMaxSetting] + # Settings for AI Max in Search and Shopping campaigns. # @!attribute [rw] contains_eu_political_advertising - # @return [::Google::Ads::GoogleAds::V19::Enums::EuPoliticalAdvertisingStatusEnum::EuPoliticalAdvertisingStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::EuPoliticalAdvertisingStatusEnum::EuPoliticalAdvertisingStatus] # The advertiser should self-declare whether this campaign contains # political advertising content targeted towards the European Union. + # @!attribute [r] missing_eu_political_advertising_declaration + # @return [::Boolean] + # Output only. Indicates whether this campaign is missing a declaration about + # whether it contains political advertising targeted towards the EU and is + # ineligible for any exemptions. If this field is true, use the + # contains_eu_political_advertising field to add the required declaration. + # + # This field is read-only. # @!attribute [rw] bidding_strategy # @return [::String] # The resource name of the portfolio bidding strategy used by the campaign. # # Note: The following fields are mutually exclusive: `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] commission - # @return [::Google::Ads::GoogleAds::V19::Common::Commission] + # @return [::Google::Ads::GoogleAds::V21::Common::Commission] # Commission is an automatic bidding strategy in which the advertiser pays # a certain portion of the conversion value. # # Note: The following fields are mutually exclusive: `commission`, `bidding_strategy`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] manual_cpa - # @return [::Google::Ads::GoogleAds::V19::Common::ManualCpa] + # @return [::Google::Ads::GoogleAds::V21::Common::ManualCpa] # Standard Manual CPA bidding strategy. # Manual bidding strategy that allows advertiser to set the bid per # advertiser-specified action. Supported only for Local Services campaigns. # # Note: The following fields are mutually exclusive: `manual_cpa`, `bidding_strategy`, `commission`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] manual_cpc - # @return [::Google::Ads::GoogleAds::V19::Common::ManualCpc] + # @return [::Google::Ads::GoogleAds::V21::Common::ManualCpc] # Standard Manual CPC bidding strategy. # Manual click-based bidding where user pays per click. # # Note: The following fields are mutually exclusive: `manual_cpc`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] manual_cpm - # @return [::Google::Ads::GoogleAds::V19::Common::ManualCpm] + # @return [::Google::Ads::GoogleAds::V21::Common::ManualCpm] # Standard Manual CPM bidding strategy. # Manual impression-based bidding where user pays per thousand # impressions. # # Note: The following fields are mutually exclusive: `manual_cpm`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] manual_cpv - # @return [::Google::Ads::GoogleAds::V19::Common::ManualCpv] + # @return [::Google::Ads::GoogleAds::V21::Common::ManualCpv] # A bidding strategy that pays a configurable amount per video view. # # Note: The following fields are mutually exclusive: `manual_cpv`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] maximize_conversions - # @return [::Google::Ads::GoogleAds::V19::Common::MaximizeConversions] + # @return [::Google::Ads::GoogleAds::V21::Common::MaximizeConversions] # Standard Maximize Conversions bidding strategy that automatically # maximizes number of conversions while spending your budget. # # Note: The following fields are mutually exclusive: `maximize_conversions`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] maximize_conversion_value - # @return [::Google::Ads::GoogleAds::V19::Common::MaximizeConversionValue] + # @return [::Google::Ads::GoogleAds::V21::Common::MaximizeConversionValue] # Standard Maximize Conversion Value bidding strategy that automatically # sets bids to maximize revenue while spending your budget. # # Note: The following fields are mutually exclusive: `maximize_conversion_value`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_cpa - # @return [::Google::Ads::GoogleAds::V19::Common::TargetCpa] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetCpa] # Standard Target CPA bidding strategy that automatically sets bids to # help get as many conversions as possible at the target # cost-per-acquisition (CPA) you set. # # Note: The following fields are mutually exclusive: `target_cpa`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_impression_share - # @return [::Google::Ads::GoogleAds::V19::Common::TargetImpressionShare] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetImpressionShare] # Target Impression Share bidding strategy. An automated bidding strategy # that sets bids to achieve a chosen percentage of impressions. # # Note: The following fields are mutually exclusive: `target_impression_share`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_roas - # @return [::Google::Ads::GoogleAds::V19::Common::TargetRoas] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetRoas] # Standard Target ROAS bidding strategy that automatically maximizes # revenue while averaging a specific target return on ad spend (ROAS). # # Note: The following fields are mutually exclusive: `target_roas`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_spend`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_spend - # @return [::Google::Ads::GoogleAds::V19::Common::TargetSpend] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetSpend] # Standard Target Spend bidding strategy that automatically sets your bids # to help get as many clicks as possible within your budget. # # Note: The following fields are mutually exclusive: `target_spend`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `percent_cpc`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] percent_cpc - # @return [::Google::Ads::GoogleAds::V19::Common::PercentCpc] + # @return [::Google::Ads::GoogleAds::V21::Common::PercentCpc] # Standard Percent Cpc bidding strategy where bids are a fraction of the # advertised price for some good or service. # # Note: The following fields are mutually exclusive: `percent_cpc`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `target_cpm`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_cpm - # @return [::Google::Ads::GoogleAds::V19::Common::TargetCpm] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetCpm] # A bidding strategy that automatically optimizes cost per thousand # impressions. # # Note: The following fields are mutually exclusive: `target_cpm`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `fixed_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] fixed_cpm - # @return [::Google::Ads::GoogleAds::V19::Common::FixedCpm] + # @return [::Google::Ads::GoogleAds::V21::Common::FixedCpm] # A manual bidding strategy with a fixed CPM. # # Note: The following fields are mutually exclusive: `fixed_cpm`, `bidding_strategy`, `commission`, `manual_cpa`, `manual_cpc`, `manual_cpm`, `manual_cpv`, `maximize_conversions`, `maximize_conversion_value`, `target_cpa`, `target_impression_share`, `target_roas`, `target_spend`, `percent_cpc`, `target_cpm`, `target_cpv`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] target_cpv - # @return [::Google::Ads::GoogleAds::V19::Common::TargetCpv] + # @return [::Google::Ads::GoogleAds::V21::Common::TargetCpv] # An automated bidding strategy that sets bids to optimize performance # given the target CPV you set. # @@ -416,7 +430,7 @@ class Campaign # Output only. The resource name of the legacy campaign upgraded to # Performance Max. # @!attribute [r] status - # @return [::Google::Ads::GoogleAds::V19::Enums::PerformanceMaxUpgradeStatusEnum::PerformanceMaxUpgradeStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::PerformanceMaxUpgradeStatusEnum::PerformanceMaxUpgradeStatus] # Output only. The upgrade status of a campaign requested to be upgraded to # Performance Max. class PerformanceMaxUpgrade @@ -430,7 +444,7 @@ class PerformanceMaxUpgrade # Whether ads will be served with google.com search results. # @!attribute [rw] target_search_network # @return [::Boolean] - # Whether ads will be served on partner sites in the Google Search Network + # Whether ads will be served on sites in the Google Search Partners Network # (requires `target_google_search` to also be `true`). # @!attribute [rw] target_content_network # @return [::Boolean] @@ -438,8 +452,11 @@ class PerformanceMaxUpgrade # Network. Placements are specified using the Placement criterion. # @!attribute [rw] target_partner_search_network # @return [::Boolean] - # Whether ads will be served on the Google Partner Network. - # This is available only to some select Google partner accounts. + # Whether ads will be served on the partner network. This is available + # only to some select partner accounts. Unless you have been instructed to + # use this field, it likely does not apply to your account. This does not + # control whether ads will be served on Google Search Partners Network; use + # `target_search_network` for that instead. # @!attribute [rw] target_youtube # @return [::Boolean] # Whether ads will be served on YouTube. @@ -488,11 +505,13 @@ class DynamicSearchAdsSetting # @!attribute [rw] feed_label # @return [::String] # Feed label of products to include in the campaign. - # Only one of feed_label or sales_country can be set. - # If used instead of sales_country, the feed_label field accepts country - # codes in the same format for example: 'XX'. - # Otherwise can be any string used for feed label in Google Merchant - # Center. + # Valid feed labels may contain a maximum of 20 characters including + # uppercase letters, numbers, hyphens, and underscores. + # If you previously used the deprecated `sales_country` in the two-letter + # country code (`XX`) format, the `feed_label` field should be used + # instead. For more information see the + # [feed label](//support.google.com/merchants/answer/12453549) + # support article. # @!attribute [rw] campaign_priority # @return [::Integer] # Priority of the campaign. Campaigns with numerically higher priorities @@ -511,11 +530,12 @@ class DynamicSearchAdsSetting # inventory in Performance Max campaigns, use `listing_type` instead. # @!attribute [rw] advertising_partner_ids # @return [::Array<::Integer>] - # Immutable. The list of Google Ads accounts IDs of advertising partners - # cooperating within the campaign. This feature is currently available only - # for accounts having an advertising partner link. This feature is - # currently supported only for Performance Max, Shopping, Search and Demand - # Gen campaign types. + # The list of Google Ads accounts IDs of advertising partners cooperating + # within the campaign. + # This feature is currently available only for accounts having an + # advertising partner link. Once set, the field is immutable. + # This feature is currently supported only for Performance Max, Shopping, + # Search and Demand Gen campaign types. # @!attribute [rw] disable_product_feed # @return [::Boolean] # Disable the optional product feed. This field is currently supported @@ -538,10 +558,10 @@ class TrackingSetting # Represents a collection of settings related to ads geotargeting. # @!attribute [rw] positive_geo_target_type - # @return [::Google::Ads::GoogleAds::V19::Enums::PositiveGeoTargetTypeEnum::PositiveGeoTargetType] + # @return [::Google::Ads::GoogleAds::V21::Enums::PositiveGeoTargetTypeEnum::PositiveGeoTargetType] # The setting used for positive geotargeting in this particular campaign. # @!attribute [rw] negative_geo_target_type - # @return [::Google::Ads::GoogleAds::V19::Enums::NegativeGeoTargetTypeEnum::NegativeGeoTargetType] + # @return [::Google::Ads::GoogleAds::V21::Enums::NegativeGeoTargetTypeEnum::NegativeGeoTargetType] # The setting used for negative geotargeting in this particular campaign. class GeoTargetTypeSetting include ::Google::Protobuf::MessageExts @@ -550,7 +570,7 @@ class GeoTargetTypeSetting # Campaign setting for local campaigns. # @!attribute [rw] location_source_type - # @return [::Google::Ads::GoogleAds::V19::Enums::LocationSourceTypeEnum::LocationSourceType] + # @return [::Google::Ads::GoogleAds::V21::Enums::LocationSourceTypeEnum::LocationSourceType] # The location source type for this local campaign. class LocalCampaignSetting include ::Google::Protobuf::MessageExts @@ -559,14 +579,14 @@ class LocalCampaignSetting # Campaign-level settings for App Campaigns. # @!attribute [rw] bidding_strategy_goal_type - # @return [::Google::Ads::GoogleAds::V19::Enums::AppCampaignBiddingStrategyGoalTypeEnum::AppCampaignBiddingStrategyGoalType] + # @return [::Google::Ads::GoogleAds::V21::Enums::AppCampaignBiddingStrategyGoalTypeEnum::AppCampaignBiddingStrategyGoalType] # Represents the goal which the bidding strategy of this app campaign # should optimize towards. # @!attribute [rw] app_id # @return [::String] # Immutable. A string that uniquely identifies a mobile application. # @!attribute [rw] app_store - # @return [::Google::Ads::GoogleAds::V19::Enums::AppCampaignAppStoreEnum::AppCampaignAppStore] + # @return [::Google::Ads::GoogleAds::V21::Enums::AppCampaignAppStoreEnum::AppCampaignAppStore] # Immutable. The application store that distributes this specific app. class AppCampaignSetting include ::Google::Protobuf::MessageExts @@ -575,10 +595,10 @@ class AppCampaignSetting # Describes how unbranded pharma ads will be displayed. # @!attribute [rw] vanity_pharma_display_url_mode - # @return [::Google::Ads::GoogleAds::V19::Enums::VanityPharmaDisplayUrlModeEnum::VanityPharmaDisplayUrlMode] + # @return [::Google::Ads::GoogleAds::V21::Enums::VanityPharmaDisplayUrlModeEnum::VanityPharmaDisplayUrlMode] # The display mode for vanity pharma URLs. # @!attribute [rw] vanity_pharma_text - # @return [::Google::Ads::GoogleAds::V19::Enums::VanityPharmaTextEnum::VanityPharmaText] + # @return [::Google::Ads::GoogleAds::V21::Enums::VanityPharmaTextEnum::VanityPharmaText] # The text that will be displayed in display URL of the text ad when # website description is the selected display mode for vanity pharma URLs. class VanityPharma @@ -603,7 +623,7 @@ class SelectiveOptimization # Optimization goal setting for this campaign, which includes a set of # optimization goal types. # @!attribute [rw] optimization_goal_types - # @return [::Array<::Google::Ads::GoogleAds::V19::Enums::OptimizationGoalTypeEnum::OptimizationGoalType>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Enums::OptimizationGoalTypeEnum::OptimizationGoalType>] # The list of optimization goal types. class OptimizationGoalSetting include ::Google::Protobuf::MessageExts @@ -623,7 +643,7 @@ class AudienceSetting # Settings for LocalServicesCampaign subresource. # @!attribute [rw] category_bids - # @return [::Array<::Google::Ads::GoogleAds::V19::Resources::Campaign::CategoryBid>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Resources::Campaign::CategoryBid>] # Categorical level bids associated with MANUAL_CPA bidding strategy. class LocalServicesCampaignSettings include ::Google::Protobuf::MessageExts @@ -672,9 +692,20 @@ class DemandGenCampaignSettings end # Settings for Video campaign. + # @!attribute [rw] video_ad_sequence + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings::VideoAdSequence] + # Container for video ads sequencing definition. # @!attribute [rw] video_ad_inventory_control - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::VideoCampaignSettings::VideoAdInventoryControl] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings::VideoAdInventoryControl] # Inventory control for video responsive ads in reach campaigns. + # + # Note: The following fields are mutually exclusive: `video_ad_inventory_control`, `video_ad_format_control`. If a field in that set is populated, all other fields in the set will automatically be cleared. + # @!attribute [rw] video_ad_format_control + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings::VideoAdFormatControl] + # Format-restricting control enabling usage of video responsive ads in + # format defined Video campaigns (for example, non-skippable). + # + # Note: The following fields are mutually exclusive: `video_ad_format_control`, `video_ad_inventory_control`. If a field in that set is populated, all other fields in the set will automatically be cleared. class VideoCampaignSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -691,15 +722,85 @@ class VideoCampaignSettings # @!attribute [rw] allow_shorts # @return [::Boolean] # Determine if video responsive ads can be used as shorts format. + # @!attribute [rw] allow_non_skippable_in_stream + # @return [::Boolean] + # Determine if video responsive ads can be used for non-skippable + # in-stream ads. This is only available for campaigns that allow mixing + # of non-skippable with other formats (Video reach campaign with Target + # Frequency bidding strategy goal). class VideoAdInventoryControl include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods end + + # Format-restricting control enabling usage of video responsive ads in + # format defined Video campaigns (for example, non-skippable). + # @!attribute [rw] format_restriction + # @return [::Google::Ads::GoogleAds::V21::Enums::VideoAdFormatRestrictionEnum::VideoAdFormatRestriction] + # All contained responsive ads are expected to respect this restriction. + # @!attribute [rw] non_skippable_in_stream_restrictions + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings::NonSkippableInStreamRestrictions] + # Restrictions for non-skippable format. + class VideoAdFormatControl + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Restrictions for non-skippable format. + # @!attribute [rw] min_duration + # @return [::Google::Ads::GoogleAds::V21::Enums::NonSkippableMinDurationEnum::NonSkippableMinDuration] + # The minimum allowed duration for non-skippable ads. + # @!attribute [rw] max_duration + # @return [::Google::Ads::GoogleAds::V21::Enums::NonSkippableMaxDurationEnum::NonSkippableMaxDuration] + # The maximum allowed duration for non-skippable ads. + class NonSkippableInStreamRestrictions + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Container for video ads sequencing definition. + # @!attribute [rw] steps + # @return [::Array<::Google::Ads::GoogleAds::V21::Resources::Campaign::VideoCampaignSettings::VideoAdSequenceStep>] + # The list of sequence steps and data associated with them. + # @!attribute [rw] minimum_duration + # @return [::Google::Ads::GoogleAds::V21::Enums::VideoAdSequenceMinimumDurationEnum::VideoAdSequenceMinimumDuration] + # Users are eligible to repeat sequence after this period. Defaults to + # WEEK if not specified. + class VideoAdSequence + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # Information about a step within a video sequence. + # @!attribute [rw] video_ad_sequence_step_id + # @return [::Integer] + # The ID of this sequence step. + # @!attribute [rw] asset_id + # @return [::Integer] + # The ID of the Asset for this step. The asset must be type + # YOUTUBE_VIDEO. + # @!attribute [rw] ad_group_type + # @return [::Google::Ads::GoogleAds::V21::Enums::AdGroupTypeEnum::AdGroupType] + # The ad group type for this step (denoting the video format). + # @!attribute [rw] previous_step_id + # @return [::Integer] + # The ID of the previous step. This field is required for all + # steps except the first one. It must point to a step that appears in the + # step definition list before this step. + # @!attribute [rw] previous_step_interaction_type + # @return [::Google::Ads::GoogleAds::V21::Enums::VideoAdSequenceInteractionTypeEnum::VideoAdSequenceInteractionType] + # Type of interaction *on the previous step* required in order for the + # user to advance to this step. As with the previous step ID, it's + # required for every step except for the first one. + class VideoAdSequenceStep + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end end # Settings for Performance Max campaigns. # @!attribute [rw] brand_targeting_overrides - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign::PmaxCampaignSettings::BrandTargetingOverrides] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::PmaxCampaignSettings::BrandTargetingOverrides] # Overrides of brand targeting for various ad types. class PmaxCampaignSettings include ::Google::Protobuf::MessageExts @@ -718,10 +819,10 @@ class BrandTargetingOverrides # Asset automation setting contains pair of AssetAutomationType and the # asset automation opt-in/out status # @!attribute [rw] asset_automation_type - # @return [::Google::Ads::GoogleAds::V19::Enums::AssetAutomationTypeEnum::AssetAutomationType] + # @return [::Google::Ads::GoogleAds::V21::Enums::AssetAutomationTypeEnum::AssetAutomationType] # The asset automation type advertiser would like to opt-in/out. # @!attribute [rw] asset_automation_status - # @return [::Google::Ads::GoogleAds::V19::Enums::AssetAutomationStatusEnum::AssetAutomationStatus] + # @return [::Google::Ads::GoogleAds::V21::Enums::AssetAutomationStatusEnum::AssetAutomationStatus] # The opt-in/out status of asset automation type. class AssetAutomationSetting include ::Google::Protobuf::MessageExts @@ -748,6 +849,54 @@ class BrandGuidelines include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods end + + # Settings for AI Max in Search and Shopping campaigns. + # @!attribute [rw] enable_ai_max + # @return [::Boolean] + # Controls whether or not AI Max features are served for this campaign. + # + # Individual AI Max features are enabled or disabled by their respective + # settings. But if enable_ai_max is set to false or cleared, then no AI + # Max features will serve for this campaign, regardless of the other + # settings. + # + # Supported in Search and Shopping campaigns. + # + # For Search campaigns, Search Term Matching is enabled by default when + # AI Max is enabled, and can be disabled at the ad group level. + # + # For Shopping campaigns, Text customization is always enabled when AI Max + # is enabled. + # @!attribute [r] bundling_required + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign::AiMaxSetting::AiMaxBundlingRequired] + # Output only. Search campaigns only. Indicates whether a campaign has + # adopted AI Max before, and is required to have AI Max enabled to adopt + # campaign-level text asset automation and brand list targeting in all API + # versions. + class AiMaxSetting + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # Enum describing whether AI Max must be enabled to serve and update + # text asset automation and brand list features newly bundled with AI Max. + module AiMaxBundlingRequired + # Not specified. + UNSPECIFIED = 0 + + # Used for return value only. Represents value unknown in this version. + UNKNOWN = 1 + + # Search campaign is using text asset automation or brand + # list targeting, and AI Max is not required to be enabled to serve these + # features. + NOT_REQUIRED = 2 + + # AI Max is required to be enabled for this search campaign to serve + # existing text asset automation and brand list targeting, or to add new + # text asset automation and brand list targeting settings. + REQUIRED = 3 + end + end end end end diff --git a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/services/campaign_service.rb b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/services/campaign_service.rb similarity index 93% rename from shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/services/campaign_service.rb rename to shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/services/campaign_service.rb index 64b84d238..697f8676b 100644 --- a/shared/output/ads/googleads/proto_docs/google/ads/googleads/v19/services/campaign_service.rb +++ b/shared/output/ads/googleads/proto_docs/google/ads/googleads/v21/services/campaign_service.rb @@ -20,15 +20,15 @@ module Google module Ads module GoogleAds - module V19 + module V21 module Services # Request message for - # {::Google::Ads::GoogleAds::V19::Services::CampaignService::Client#mutate_campaigns CampaignService.MutateCampaigns}. + # {::Google::Ads::GoogleAds::V21::Services::CampaignService::Client#mutate_campaigns CampaignService.MutateCampaigns}. # @!attribute [rw] customer_id # @return [::String] # Required. The ID of the customer whose campaigns are being modified. # @!attribute [rw] operations - # @return [::Array<::Google::Ads::GoogleAds::V19::Services::CampaignOperation>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Services::CampaignOperation>] # Required. The list of operations to perform on individual campaigns. # @!attribute [rw] partial_failure # @return [::Boolean] @@ -41,7 +41,7 @@ module Services # If true, the request is validated but not executed. Only errors are # returned, not results. # @!attribute [rw] response_content_type - # @return [::Google::Ads::GoogleAds::V19::Enums::ResponseContentTypeEnum::ResponseContentType] + # @return [::Google::Ads::GoogleAds::V21::Enums::ResponseContentTypeEnum::ResponseContentType] # The response content type setting. Determines whether the mutable resource # or just the resource name should be returned post mutation. class MutateCampaignsRequest @@ -54,12 +54,12 @@ class MutateCampaignsRequest # @return [::Google::Protobuf::FieldMask] # FieldMask that determines which resource fields are modified in an update. # @!attribute [rw] create - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign] # Create operation: No resource name is expected for the new campaign. # # Note: The following fields are mutually exclusive: `create`, `update`, `remove`. If a field in that set is populated, all other fields in the set will automatically be cleared. # @!attribute [rw] update - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign] # Update operation: The campaign is expected to have a valid # resource name. # @@ -85,7 +85,7 @@ class CampaignOperation # operations. If any errors occur outside the operations (for example, auth # errors), we return an RPC level error. # @!attribute [rw] results - # @return [::Array<::Google::Ads::GoogleAds::V19::Services::MutateCampaignResult>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Services::MutateCampaignResult>] # All results for the mutate. class MutateCampaignsResponse include ::Google::Protobuf::MessageExts @@ -97,7 +97,7 @@ class MutateCampaignsResponse # @return [::String] # Returned for successful operations. # @!attribute [rw] campaign - # @return [::Google::Ads::GoogleAds::V19::Resources::Campaign] + # @return [::Google::Ads::GoogleAds::V21::Resources::Campaign] # The mutated campaign with only mutable fields after mutate. The field will # only be returned when response_content_type is set to "MUTABLE_RESOURCE". class MutateCampaignResult @@ -110,7 +110,7 @@ class MutateCampaignResult # @return [::String] # Required. The ID of the customer whose campaigns are being enabled. # @!attribute [rw] operations - # @return [::Array<::Google::Ads::GoogleAds::V19::Services::EnableOperation>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Services::EnableOperation>] # Required. The list of individual campaign operations. A maximum of 10 # enable operations can be executed in a request. class EnablePMaxBrandGuidelinesRequest @@ -128,7 +128,7 @@ class EnablePMaxBrandGuidelinesRequest # This field is required. If true, top-performing brand assets will be # automatically populated. If false, the brand_assets field is required. # @!attribute [rw] brand_assets - # @return [::Google::Ads::GoogleAds::V19::Services::BrandCampaignAssets] + # @return [::Google::Ads::GoogleAds::V21::Services::BrandCampaignAssets] # Optional. The brand assets linked to the campaign. This field is required # when the value of auto_populate_brand_assets is false. # @!attribute [rw] final_uri_domain @@ -170,7 +170,7 @@ class BrandCampaignAssets # Brand Guidelines campaign enablement response. # @!attribute [rw] results - # @return [::Array<::Google::Ads::GoogleAds::V19::Services::EnablementResult>] + # @return [::Array<::Google::Ads::GoogleAds::V21::Services::EnablementResult>] # Campaign enablement results per campaign. class EnablePMaxBrandGuidelinesResponse include ::Google::Protobuf::MessageExts diff --git a/shared/output/ads/googleads/proto_docs/google/api/client.rb b/shared/output/ads/googleads/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/ads/googleads/proto_docs/google/api/client.rb +++ b/shared/output/ads/googleads/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/compute_small/proto_docs/google/api/client.rb b/shared/output/cloud/compute_small/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/compute_small/proto_docs/google/api/client.rb +++ b/shared/output/cloud/compute_small/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/common_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/common_pb.rb index babf82fb9..ce9669d62 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/common_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/common_pb.rb @@ -5,7 +5,7 @@ require 'google/protobuf' -descriptor_data = "\n\x17grafeas/v1/common.proto\x12\ngrafeas.v1\"(\n\nRelatedUrl\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05label\x18\x02 \x01(\t\"5\n\tSignature\x12\x11\n\tsignature\x18\x01 \x01(\x0c\x12\x15\n\rpublic_key_id\x18\x02 \x01(\t\"d\n\x08\x45nvelope\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x14\n\x0cpayload_type\x18\x02 \x01(\t\x12\x31\n\nsignatures\x18\x03 \x03(\x0b\x32\x1d.grafeas.v1.EnvelopeSignature\"/\n\x11\x45nvelopeSignature\x12\x0b\n\x03sig\x18\x01 \x01(\x0c\x12\r\n\x05keyid\x18\x02 \x01(\t\"R\n\x0c\x46ileLocation\x12\x11\n\tfile_path\x18\x01 \x01(\t\x12/\n\rlayer_details\x18\x02 \x01(\x0b\x32\x18.grafeas.v1.LayerDetails\"B\n\tBaseImage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nrepository\x18\x02 \x01(\t\x12\x13\n\x0blayer_count\x18\x03 \x01(\x05\"}\n\x0cLayerDetails\x12\r\n\x05index\x18\x01 \x01(\x05\x12\x0f\n\x07\x64iff_id\x18\x02 \x01(\t\x12\x10\n\x08\x63hain_id\x18\x05 \x01(\t\x12\x0f\n\x07\x63ommand\x18\x03 \x01(\t\x12*\n\x0b\x62\x61se_images\x18\x04 \x03(\x0b\x32\x15.grafeas.v1.BaseImage\"/\n\x07License\x12\x12\n\nexpression\x18\x01 \x01(\t\x12\x10\n\x08\x63omments\x18\x02 \x01(\t\",\n\x06\x44igest\x12\x0c\n\x04\x61lgo\x18\x01 \x01(\t\x12\x14\n\x0c\x64igest_bytes\x18\x02 \x01(\x0c*\xfc\x01\n\x08NoteKind\x12\x19\n\x15NOTE_KIND_UNSPECIFIED\x10\x00\x12\x11\n\rVULNERABILITY\x10\x01\x12\t\n\x05\x42UILD\x10\x02\x12\t\n\x05IMAGE\x10\x03\x12\x0b\n\x07PACKAGE\x10\x04\x12\x0e\n\nDEPLOYMENT\x10\x05\x12\r\n\tDISCOVERY\x10\x06\x12\x0f\n\x0b\x41TTESTATION\x10\x07\x12\x0b\n\x07UPGRADE\x10\x08\x12\x0e\n\nCOMPLIANCE\x10\t\x12\x14\n\x10\x44SSE_ATTESTATION\x10\n\x12\x1c\n\x18VULNERABILITY_ASSESSMENT\x10\x0b\x12\x12\n\x0eSBOM_REFERENCE\x10\x0c\x12\n\n\x06SECRET\x10\rBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" +descriptor_data = "\n\x17grafeas/v1/common.proto\x12\ngrafeas.v1\"(\n\nRelatedUrl\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05label\x18\x02 \x01(\t\"5\n\tSignature\x12\x11\n\tsignature\x18\x01 \x01(\x0c\x12\x15\n\rpublic_key_id\x18\x02 \x01(\t\"d\n\x08\x45nvelope\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x14\n\x0cpayload_type\x18\x02 \x01(\t\x12\x31\n\nsignatures\x18\x03 \x03(\x0b\x32\x1d.grafeas.v1.EnvelopeSignature\"/\n\x11\x45nvelopeSignature\x12\x0b\n\x03sig\x18\x01 \x01(\x0c\x12\r\n\x05keyid\x18\x02 \x01(\t\"g\n\x0c\x46ileLocation\x12\x11\n\tfile_path\x18\x01 \x01(\t\x12/\n\rlayer_details\x18\x02 \x01(\x0b\x32\x18.grafeas.v1.LayerDetails\x12\x13\n\x0bline_number\x18\x03 \x01(\x05\"T\n\tBaseImage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nrepository\x18\x02 \x01(\t\x12\x13\n\x0blayer_count\x18\x03 \x01(\x05\x12\x10\n\x08registry\x18\x04 \x01(\t\"}\n\x0cLayerDetails\x12\r\n\x05index\x18\x01 \x01(\x05\x12\x0f\n\x07\x64iff_id\x18\x02 \x01(\t\x12\x10\n\x08\x63hain_id\x18\x05 \x01(\t\x12\x0f\n\x07\x63ommand\x18\x03 \x01(\t\x12*\n\x0b\x62\x61se_images\x18\x04 \x03(\x0b\x32\x15.grafeas.v1.BaseImage\"/\n\x07License\x12\x12\n\nexpression\x18\x01 \x01(\t\x12\x10\n\x08\x63omments\x18\x02 \x01(\t\",\n\x06\x44igest\x12\x0c\n\x04\x61lgo\x18\x01 \x01(\t\x12\x14\n\x0c\x64igest_bytes\x18\x02 \x01(\x0c*\xfc\x01\n\x08NoteKind\x12\x19\n\x15NOTE_KIND_UNSPECIFIED\x10\x00\x12\x11\n\rVULNERABILITY\x10\x01\x12\t\n\x05\x42UILD\x10\x02\x12\t\n\x05IMAGE\x10\x03\x12\x0b\n\x07PACKAGE\x10\x04\x12\x0e\n\nDEPLOYMENT\x10\x05\x12\r\n\tDISCOVERY\x10\x06\x12\x0f\n\x0b\x41TTESTATION\x10\x07\x12\x0b\n\x07UPGRADE\x10\x08\x12\x0e\n\nCOMPLIANCE\x10\t\x12\x14\n\x10\x44SSE_ATTESTATION\x10\n\x12\x1c\n\x18VULNERABILITY_ASSESSMENT\x10\x0b\x12\x12\n\x0eSBOM_REFERENCE\x10\x0c\x12\n\n\x06SECRET\x10\rBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/cvss_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/cvss_pb.rb index 12a5b5d82..6855ca3fe 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/cvss_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/cvss_pb.rb @@ -5,7 +5,7 @@ require 'google/protobuf' -descriptor_data = "\n\x15grafeas/v1/cvss.proto\x12\ngrafeas.v1\"\xc5\t\n\x06\x43VSSv3\x12\x12\n\nbase_score\x18\x01 \x01(\x02\x12\x1c\n\x14\x65xploitability_score\x18\x02 \x01(\x02\x12\x14\n\x0cimpact_score\x18\x03 \x01(\x02\x12\x36\n\rattack_vector\x18\x05 \x01(\x0e\x32\x1f.grafeas.v1.CVSSv3.AttackVector\x12>\n\x11\x61ttack_complexity\x18\x06 \x01(\x0e\x32#.grafeas.v1.CVSSv3.AttackComplexity\x12\x42\n\x13privileges_required\x18\x07 \x01(\x0e\x32%.grafeas.v1.CVSSv3.PrivilegesRequired\x12<\n\x10user_interaction\x18\x08 \x01(\x0e\x32\".grafeas.v1.CVSSv3.UserInteraction\x12\'\n\x05scope\x18\t \x01(\x0e\x32\x18.grafeas.v1.CVSSv3.Scope\x12\x39\n\x16\x63onfidentiality_impact\x18\n \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x33\n\x10integrity_impact\x18\x0b \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x36\n\x13\x61vailability_impact\x18\x0c \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\"\x99\x01\n\x0c\x41ttackVector\x12\x1d\n\x19\x41TTACK_VECTOR_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_VECTOR_NETWORK\x10\x01\x12\x1a\n\x16\x41TTACK_VECTOR_ADJACENT\x10\x02\x12\x17\n\x13\x41TTACK_VECTOR_LOCAL\x10\x03\x12\x1a\n\x16\x41TTACK_VECTOR_PHYSICAL\x10\x04\"l\n\x10\x41ttackComplexity\x12!\n\x1d\x41TTACK_COMPLEXITY_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_COMPLEXITY_LOW\x10\x01\x12\x1a\n\x16\x41TTACK_COMPLEXITY_HIGH\x10\x02\"\x92\x01\n\x12PrivilegesRequired\x12#\n\x1fPRIVILEGES_REQUIRED_UNSPECIFIED\x10\x00\x12\x1c\n\x18PRIVILEGES_REQUIRED_NONE\x10\x01\x12\x1b\n\x17PRIVILEGES_REQUIRED_LOW\x10\x02\x12\x1c\n\x18PRIVILEGES_REQUIRED_HIGH\x10\x03\"m\n\x0fUserInteraction\x12 \n\x1cUSER_INTERACTION_UNSPECIFIED\x10\x00\x12\x19\n\x15USER_INTERACTION_NONE\x10\x01\x12\x1d\n\x19USER_INTERACTION_REQUIRED\x10\x02\"F\n\x05Scope\x12\x15\n\x11SCOPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fSCOPE_UNCHANGED\x10\x01\x12\x11\n\rSCOPE_CHANGED\x10\x02\"R\n\x06Impact\x12\x16\n\x12IMPACT_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIMPACT_HIGH\x10\x01\x12\x0e\n\nIMPACT_LOW\x10\x02\x12\x0f\n\x0bIMPACT_NONE\x10\x03\"\xb8\x0b\n\x04\x43VSS\x12\x12\n\nbase_score\x18\x01 \x01(\x02\x12\x1c\n\x14\x65xploitability_score\x18\x02 \x01(\x02\x12\x14\n\x0cimpact_score\x18\x03 \x01(\x02\x12\x34\n\rattack_vector\x18\x04 \x01(\x0e\x32\x1d.grafeas.v1.CVSS.AttackVector\x12<\n\x11\x61ttack_complexity\x18\x05 \x01(\x0e\x32!.grafeas.v1.CVSS.AttackComplexity\x12\x37\n\x0e\x61uthentication\x18\x06 \x01(\x0e\x32\x1f.grafeas.v1.CVSS.Authentication\x12@\n\x13privileges_required\x18\x07 \x01(\x0e\x32#.grafeas.v1.CVSS.PrivilegesRequired\x12:\n\x10user_interaction\x18\x08 \x01(\x0e\x32 .grafeas.v1.CVSS.UserInteraction\x12%\n\x05scope\x18\t \x01(\x0e\x32\x16.grafeas.v1.CVSS.Scope\x12\x37\n\x16\x63onfidentiality_impact\x18\n \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x31\n\x10integrity_impact\x18\x0b \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x34\n\x13\x61vailability_impact\x18\x0c \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\"\x99\x01\n\x0c\x41ttackVector\x12\x1d\n\x19\x41TTACK_VECTOR_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_VECTOR_NETWORK\x10\x01\x12\x1a\n\x16\x41TTACK_VECTOR_ADJACENT\x10\x02\x12\x17\n\x13\x41TTACK_VECTOR_LOCAL\x10\x03\x12\x1a\n\x16\x41TTACK_VECTOR_PHYSICAL\x10\x04\"\x8a\x01\n\x10\x41ttackComplexity\x12!\n\x1d\x41TTACK_COMPLEXITY_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_COMPLEXITY_LOW\x10\x01\x12\x1a\n\x16\x41TTACK_COMPLEXITY_HIGH\x10\x02\x12\x1c\n\x18\x41TTACK_COMPLEXITY_MEDIUM\x10\x03\"\x81\x01\n\x0e\x41uthentication\x12\x1e\n\x1a\x41UTHENTICATION_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x41UTHENTICATION_MULTIPLE\x10\x01\x12\x19\n\x15\x41UTHENTICATION_SINGLE\x10\x02\x12\x17\n\x13\x41UTHENTICATION_NONE\x10\x03\"\x92\x01\n\x12PrivilegesRequired\x12#\n\x1fPRIVILEGES_REQUIRED_UNSPECIFIED\x10\x00\x12\x1c\n\x18PRIVILEGES_REQUIRED_NONE\x10\x01\x12\x1b\n\x17PRIVILEGES_REQUIRED_LOW\x10\x02\x12\x1c\n\x18PRIVILEGES_REQUIRED_HIGH\x10\x03\"m\n\x0fUserInteraction\x12 \n\x1cUSER_INTERACTION_UNSPECIFIED\x10\x00\x12\x19\n\x15USER_INTERACTION_NONE\x10\x01\x12\x1d\n\x19USER_INTERACTION_REQUIRED\x10\x02\"F\n\x05Scope\x12\x15\n\x11SCOPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fSCOPE_UNCHANGED\x10\x01\x12\x11\n\rSCOPE_CHANGED\x10\x02\"{\n\x06Impact\x12\x16\n\x12IMPACT_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIMPACT_HIGH\x10\x01\x12\x0e\n\nIMPACT_LOW\x10\x02\x12\x0f\n\x0bIMPACT_NONE\x10\x03\x12\x12\n\x0eIMPACT_PARTIAL\x10\x04\x12\x13\n\x0fIMPACT_COMPLETE\x10\x05*S\n\x0b\x43VSSVersion\x12\x1c\n\x18\x43VSS_VERSION_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43VSS_VERSION_2\x10\x01\x12\x12\n\x0e\x43VSS_VERSION_3\x10\x02\x42\\\n\rio.grafeas.v1B\tCVSSProtoP\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" +descriptor_data = "\n\x15grafeas/v1/cvss.proto\x12\ngrafeas.v1\"\xc5\t\n\x06\x43VSSv3\x12\x12\n\nbase_score\x18\x01 \x01(\x02\x12\x1c\n\x14\x65xploitability_score\x18\x02 \x01(\x02\x12\x14\n\x0cimpact_score\x18\x03 \x01(\x02\x12\x36\n\rattack_vector\x18\x05 \x01(\x0e\x32\x1f.grafeas.v1.CVSSv3.AttackVector\x12>\n\x11\x61ttack_complexity\x18\x06 \x01(\x0e\x32#.grafeas.v1.CVSSv3.AttackComplexity\x12\x42\n\x13privileges_required\x18\x07 \x01(\x0e\x32%.grafeas.v1.CVSSv3.PrivilegesRequired\x12<\n\x10user_interaction\x18\x08 \x01(\x0e\x32\".grafeas.v1.CVSSv3.UserInteraction\x12\'\n\x05scope\x18\t \x01(\x0e\x32\x18.grafeas.v1.CVSSv3.Scope\x12\x39\n\x16\x63onfidentiality_impact\x18\n \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x33\n\x10integrity_impact\x18\x0b \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x36\n\x13\x61vailability_impact\x18\x0c \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\"\x99\x01\n\x0c\x41ttackVector\x12\x1d\n\x19\x41TTACK_VECTOR_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_VECTOR_NETWORK\x10\x01\x12\x1a\n\x16\x41TTACK_VECTOR_ADJACENT\x10\x02\x12\x17\n\x13\x41TTACK_VECTOR_LOCAL\x10\x03\x12\x1a\n\x16\x41TTACK_VECTOR_PHYSICAL\x10\x04\"l\n\x10\x41ttackComplexity\x12!\n\x1d\x41TTACK_COMPLEXITY_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_COMPLEXITY_LOW\x10\x01\x12\x1a\n\x16\x41TTACK_COMPLEXITY_HIGH\x10\x02\"\x92\x01\n\x12PrivilegesRequired\x12#\n\x1fPRIVILEGES_REQUIRED_UNSPECIFIED\x10\x00\x12\x1c\n\x18PRIVILEGES_REQUIRED_NONE\x10\x01\x12\x1b\n\x17PRIVILEGES_REQUIRED_LOW\x10\x02\x12\x1c\n\x18PRIVILEGES_REQUIRED_HIGH\x10\x03\"m\n\x0fUserInteraction\x12 \n\x1cUSER_INTERACTION_UNSPECIFIED\x10\x00\x12\x19\n\x15USER_INTERACTION_NONE\x10\x01\x12\x1d\n\x19USER_INTERACTION_REQUIRED\x10\x02\"F\n\x05Scope\x12\x15\n\x11SCOPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fSCOPE_UNCHANGED\x10\x01\x12\x11\n\rSCOPE_CHANGED\x10\x02\"R\n\x06Impact\x12\x16\n\x12IMPACT_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIMPACT_HIGH\x10\x01\x12\x0e\n\nIMPACT_LOW\x10\x02\x12\x0f\n\x0bIMPACT_NONE\x10\x03\"\xce\x12\n\x04\x43VSS\x12\x12\n\nbase_score\x18\x01 \x01(\x02\x12\x1c\n\x14\x65xploitability_score\x18\x02 \x01(\x02\x12\x14\n\x0cimpact_score\x18\x03 \x01(\x02\x12\x34\n\rattack_vector\x18\x04 \x01(\x0e\x32\x1d.grafeas.v1.CVSS.AttackVector\x12<\n\x11\x61ttack_complexity\x18\x05 \x01(\x0e\x32!.grafeas.v1.CVSS.AttackComplexity\x12\x37\n\x0e\x61uthentication\x18\x06 \x01(\x0e\x32\x1f.grafeas.v1.CVSS.Authentication\x12@\n\x13privileges_required\x18\x07 \x01(\x0e\x32#.grafeas.v1.CVSS.PrivilegesRequired\x12:\n\x10user_interaction\x18\x08 \x01(\x0e\x32 .grafeas.v1.CVSS.UserInteraction\x12%\n\x05scope\x18\t \x01(\x0e\x32\x16.grafeas.v1.CVSS.Scope\x12\x37\n\x16\x63onfidentiality_impact\x18\n \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x31\n\x10integrity_impact\x18\x0b \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x34\n\x13\x61vailability_impact\x18\x0c \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12@\n\x13\x61ttack_requirements\x18\r \x01(\x0e\x32#.grafeas.v1.CVSS.AttackRequirements\x12I\n(vulnerable_system_confidentiality_impact\x18\x0e \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x43\n\"vulnerable_system_integrity_impact\x18\x0f \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x46\n%vulnerable_system_availability_impact\x18\x10 \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12I\n(subsequent_system_confidentiality_impact\x18\x11 \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x43\n\"subsequent_system_integrity_impact\x18\x12 \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12\x46\n%subsequent_system_availability_impact\x18\x13 \x01(\x0e\x32\x17.grafeas.v1.CVSS.Impact\x12:\n\x10\x65xploit_maturity\x18\x14 \x01(\x0e\x32 .grafeas.v1.CVSS.ExploitMaturity\"\x99\x01\n\x0c\x41ttackVector\x12\x1d\n\x19\x41TTACK_VECTOR_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_VECTOR_NETWORK\x10\x01\x12\x1a\n\x16\x41TTACK_VECTOR_ADJACENT\x10\x02\x12\x17\n\x13\x41TTACK_VECTOR_LOCAL\x10\x03\x12\x1a\n\x16\x41TTACK_VECTOR_PHYSICAL\x10\x04\"\x8a\x01\n\x10\x41ttackComplexity\x12!\n\x1d\x41TTACK_COMPLEXITY_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_COMPLEXITY_LOW\x10\x01\x12\x1a\n\x16\x41TTACK_COMPLEXITY_HIGH\x10\x02\x12\x1c\n\x18\x41TTACK_COMPLEXITY_MEDIUM\x10\x03\"\x81\x01\n\x0e\x41uthentication\x12\x1e\n\x1a\x41UTHENTICATION_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x41UTHENTICATION_MULTIPLE\x10\x01\x12\x19\n\x15\x41UTHENTICATION_SINGLE\x10\x02\x12\x17\n\x13\x41UTHENTICATION_NONE\x10\x03\"\x92\x01\n\x12PrivilegesRequired\x12#\n\x1fPRIVILEGES_REQUIRED_UNSPECIFIED\x10\x00\x12\x1c\n\x18PRIVILEGES_REQUIRED_NONE\x10\x01\x12\x1b\n\x17PRIVILEGES_REQUIRED_LOW\x10\x02\x12\x1c\n\x18PRIVILEGES_REQUIRED_HIGH\x10\x03\"\xa8\x01\n\x0fUserInteraction\x12 \n\x1cUSER_INTERACTION_UNSPECIFIED\x10\x00\x12\x19\n\x15USER_INTERACTION_NONE\x10\x01\x12\x1d\n\x19USER_INTERACTION_REQUIRED\x10\x02\x12\x1c\n\x18USER_INTERACTION_PASSIVE\x10\x03\x12\x1b\n\x17USER_INTERACTION_ACTIVE\x10\x04\"F\n\x05Scope\x12\x15\n\x11SCOPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fSCOPE_UNCHANGED\x10\x01\x12\x11\n\rSCOPE_CHANGED\x10\x02\"{\n\x06Impact\x12\x16\n\x12IMPACT_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIMPACT_HIGH\x10\x01\x12\x0e\n\nIMPACT_LOW\x10\x02\x12\x0f\n\x0bIMPACT_NONE\x10\x03\x12\x12\n\x0eIMPACT_PARTIAL\x10\x04\x12\x13\n\x0fIMPACT_COMPLETE\x10\x05\"x\n\x12\x41ttackRequirements\x12#\n\x1f\x41TTACK_REQUIREMENTS_UNSPECIFIED\x10\x00\x12\x1c\n\x18\x41TTACK_REQUIREMENTS_NONE\x10\x01\x12\x1f\n\x1b\x41TTACK_REQUIREMENTS_PRESENT\x10\x02\"\xaf\x01\n\x0f\x45xploitMaturity\x12 \n\x1c\x45XPLOIT_MATURITY_UNSPECIFIED\x10\x00\x12 \n\x1c\x45XPLOIT_MATURITY_NOT_DEFINED\x10\x01\x12\x1d\n\x19\x45XPLOIT_MATURITY_ATTACKED\x10\x02\x12\x18\n\x14\x45XPLOIT_MATURITY_POC\x10\x03\x12\x1f\n\x1b\x45XPLOIT_MATURITY_UNREPORTED\x10\x04*g\n\x0b\x43VSSVersion\x12\x1c\n\x18\x43VSS_VERSION_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43VSS_VERSION_2\x10\x01\x12\x12\n\x0e\x43VSS_VERSION_3\x10\x02\x12\x12\n\x0e\x43VSS_VERSION_4\x10\x03\x42\\\n\rio.grafeas.v1B\tCVSSProtoP\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) @@ -27,6 +27,8 @@ module V1 CVSS::UserInteraction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSS.UserInteraction").enummodule CVSS::Scope = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSS.Scope").enummodule CVSS::Impact = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSS.Impact").enummodule + CVSS::AttackRequirements = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSS.AttackRequirements").enummodule + CVSS::ExploitMaturity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSS.ExploitMaturity").enummodule CVSSVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CVSSVersion").enummodule end end diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/discovery_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/discovery_pb.rb index 8af350fa0..eb72608cb 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/discovery_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/discovery_pb.rb @@ -10,7 +10,7 @@ require 'grafeas/v1/common_pb' -descriptor_data = "\n\x1agrafeas/v1/discovery.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17grafeas/v1/common.proto\"<\n\rDiscoveryNote\x12+\n\ranalysis_kind\x18\x01 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\"\xfc\n\n\x13\x44iscoveryOccurrence\x12O\n\x13\x63ontinuous_analysis\x18\x01 \x01(\x0e\x32\x32.grafeas.v1.DiscoveryOccurrence.ContinuousAnalysis\x12G\n\x0f\x61nalysis_status\x18\x02 \x01(\x0e\x32..grafeas.v1.DiscoveryOccurrence.AnalysisStatus\x12M\n\x12\x61nalysis_completed\x18\x07 \x01(\x0b\x32\x31.grafeas.v1.DiscoveryOccurrence.AnalysisCompleted\x12*\n\x0e\x61nalysis_error\x18\x08 \x03(\x0b\x32\x12.google.rpc.Status\x12\x31\n\x15\x61nalysis_status_error\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12\x0b\n\x03\x63pe\x18\x04 \x01(\t\x12\x32\n\x0elast_scan_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x0c\x61rchive_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12?\n\x0bsbom_status\x18\t \x01(\x0b\x32*.grafeas.v1.DiscoveryOccurrence.SBOMStatus\x12[\n\x19vulnerability_attestation\x18\n \x01(\x0b\x32\x38.grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation\x1a*\n\x11\x41nalysisCompleted\x12\x15\n\ranalysis_type\x18\x01 \x03(\t\x1a\xa9\x01\n\nSBOMStatus\x12H\n\nsbom_state\x18\x01 \x01(\x0e\x32\x34.grafeas.v1.DiscoveryOccurrence.SBOMStatus.SBOMState\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"B\n\tSBOMState\x12\x1a\n\x16SBOM_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0c\n\x08\x43OMPLETE\x10\x02\x1a\xb3\x02\n\x18VulnerabilityAttestation\x12\x35\n\x11last_attempt_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x65\n\x05state\x18\x02 \x01(\x0e\x32V.grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation.VulnerabilityAttestationState\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"j\n\x1dVulnerabilityAttestationState\x12/\n+VULNERABILITY_ATTESTATION_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07SUCCESS\x10\x01\x12\x0b\n\x07\x46\x41ILURE\x10\x02\"S\n\x12\x43ontinuousAnalysis\x12#\n\x1f\x43ONTINUOUS_ANALYSIS_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0c\n\x08INACTIVE\x10\x02\"\xa3\x01\n\x0e\x41nalysisStatus\x12\x1f\n\x1b\x41NALYSIS_STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0c\n\x08SCANNING\x10\x02\x12\x14\n\x10\x46INISHED_SUCCESS\x10\x03\x12\x0c\n\x08\x43OMPLETE\x10\x03\x12\x13\n\x0f\x46INISHED_FAILED\x10\x04\x12\x18\n\x14\x46INISHED_UNSUPPORTED\x10\x05\x1a\x02\x10\x01\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" +descriptor_data = "\n\x1agrafeas/v1/discovery.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17grafeas/v1/common.proto\"<\n\rDiscoveryNote\x12+\n\ranalysis_kind\x18\x01 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\"\xfd\x0c\n\x13\x44iscoveryOccurrence\x12O\n\x13\x63ontinuous_analysis\x18\x01 \x01(\x0e\x32\x32.grafeas.v1.DiscoveryOccurrence.ContinuousAnalysis\x12G\n\x0f\x61nalysis_status\x18\x02 \x01(\x0e\x32..grafeas.v1.DiscoveryOccurrence.AnalysisStatus\x12M\n\x12\x61nalysis_completed\x18\x07 \x01(\x0b\x32\x31.grafeas.v1.DiscoveryOccurrence.AnalysisCompleted\x12*\n\x0e\x61nalysis_error\x18\x08 \x03(\x0b\x32\x12.google.rpc.Status\x12\x31\n\x15\x61nalysis_status_error\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12\x0b\n\x03\x63pe\x18\x04 \x01(\t\x12\x32\n\x0elast_scan_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x0c\x61rchive_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12?\n\x0bsbom_status\x18\t \x01(\x0b\x32*.grafeas.v1.DiscoveryOccurrence.SBOMStatus\x12[\n\x19vulnerability_attestation\x18\n \x01(\x0b\x32\x38.grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation\x12\x33\n\x05\x66iles\x18\x0b \x03(\x0b\x32$.grafeas.v1.DiscoveryOccurrence.File\x12\x42\n\x1elast_vulnerability_update_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a*\n\x11\x41nalysisCompleted\x12\x15\n\ranalysis_type\x18\x01 \x03(\t\x1a\xa9\x01\n\nSBOMStatus\x12H\n\nsbom_state\x18\x01 \x01(\x0e\x32\x34.grafeas.v1.DiscoveryOccurrence.SBOMStatus.SBOMState\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"B\n\tSBOMState\x12\x1a\n\x16SBOM_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0c\n\x08\x43OMPLETE\x10\x02\x1a\xb3\x02\n\x18VulnerabilityAttestation\x12\x35\n\x11last_attempt_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x65\n\x05state\x18\x02 \x01(\x0e\x32V.grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation.VulnerabilityAttestationState\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"j\n\x1dVulnerabilityAttestationState\x12/\n+VULNERABILITY_ATTESTATION_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07SUCCESS\x10\x01\x12\x0b\n\x07\x46\x41ILURE\x10\x02\x1a\x85\x01\n\x04\x46ile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12@\n\x06\x64igest\x18\x02 \x03(\x0b\x32\x30.grafeas.v1.DiscoveryOccurrence.File.DigestEntry\x1a-\n\x0b\x44igestEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"S\n\x12\x43ontinuousAnalysis\x12#\n\x1f\x43ONTINUOUS_ANALYSIS_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0c\n\x08INACTIVE\x10\x02\"\xa3\x01\n\x0e\x41nalysisStatus\x12\x1f\n\x1b\x41NALYSIS_STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0c\n\x08SCANNING\x10\x02\x12\x14\n\x10\x46INISHED_SUCCESS\x10\x03\x12\x0c\n\x08\x43OMPLETE\x10\x03\x12\x13\n\x0f\x46INISHED_FAILED\x10\x04\x12\x18\n\x14\x46INISHED_UNSUPPORTED\x10\x05\x1a\x02\x10\x01\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) @@ -24,6 +24,7 @@ module V1 DiscoveryOccurrence::SBOMStatus::SBOMState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.SBOMStatus.SBOMState").enummodule DiscoveryOccurrence::VulnerabilityAttestation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation").msgclass DiscoveryOccurrence::VulnerabilityAttestation::VulnerabilityAttestationState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.VulnerabilityAttestation.VulnerabilityAttestationState").enummodule + DiscoveryOccurrence::File = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.File").msgclass DiscoveryOccurrence::ContinuousAnalysis = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.ContinuousAnalysis").enummodule DiscoveryOccurrence::AnalysisStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.DiscoveryOccurrence.AnalysisStatus").enummodule end diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas/client.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas/client.rb index 3b8e2d0ca..651f62ffd 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas/client.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas/client.rb @@ -283,7 +283,7 @@ def get_occurrence request, options = nil # @param options [::Gapic::CallOptions, ::Hash] # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional. # - # @overload list_occurrences(parent: nil, filter: nil, page_size: nil, page_token: nil) + # @overload list_occurrences(parent: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil) # Pass arguments to `list_occurrences` via keyword arguments. Note that at # least one keyword argument is required. To specify no parameters, or to keep all # the default parameter values, pass an empty Hash as a request object (see above). @@ -298,6 +298,12 @@ def get_occurrence request, options = nil # page size is 1000. If not specified, page size defaults to 20. # @param page_token [::String] # Token to provide to skip to a particular spot in the list. + # @param return_partial_success [::Boolean] + # If set, the request will return all reachable Occurrences + # and report all unreachable regions in the `unreachable` field in + # the response. + # + # Only applicable for requests in the global region. # # @yield [response, operation] Access the result along with the RPC operation # @yieldparam response [::Gapic::PagedEnumerable<::Grafeas::V1::Occurrence>] @@ -909,7 +915,7 @@ def get_note request, options = nil # @param options [::Gapic::CallOptions, ::Hash] # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional. # - # @overload list_notes(parent: nil, filter: nil, page_size: nil, page_token: nil) + # @overload list_notes(parent: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil) # Pass arguments to `list_notes` via keyword arguments. Note that at # least one keyword argument is required. To specify no parameters, or to keep all # the default parameter values, pass an empty Hash as a request object (see above). @@ -924,6 +930,12 @@ def get_note request, options = nil # size is 1000. If not specified, page size defaults to 20. # @param page_token [::String] # Token to provide to skip to a particular spot in the list. + # @param return_partial_success [::Boolean] + # If set, the request will return all reachable Notes + # and report all unreachable regions in the `unreachable` field in + # the response. + # + # Only applicable for requests in the global region. # # @yield [response, operation] Access the result along with the RPC operation # @yieldparam response [::Gapic::PagedEnumerable<::Grafeas::V1::Note>] diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas_pb.rb index 46216cf59..f098a03d4 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/grafeas_pb.rb @@ -27,7 +27,7 @@ require 'grafeas/v1/vulnerability_pb' -descriptor_data = "\n\x18grafeas/v1/grafeas.proto\x12\ngrafeas.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgrafeas/v1/attestation.proto\x1a\x16grafeas/v1/build.proto\x1a\x17grafeas/v1/common.proto\x1a\x1bgrafeas/v1/compliance.proto\x1a\x1bgrafeas/v1/deployment.proto\x1a\x1agrafeas/v1/discovery.proto\x1a!grafeas/v1/dsse_attestation.proto\x1a\x16grafeas/v1/image.proto\x1a\x18grafeas/v1/package.proto\x1a\x15grafeas/v1/sbom.proto\x1a\x17grafeas/v1/secret.proto\x1a\x18grafeas/v1/upgrade.proto\x1a\x14grafeas/v1/vex.proto\x1a\x1egrafeas/v1/vulnerability.proto\"\xea\x07\n\nOccurrence\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0cresource_uri\x18\x02 \x01(\t\x12\x11\n\tnote_name\x18\x03 \x01(\t\x12\"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12\x13\n\x0bremediation\x18\x05 \x01(\t\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\rvulnerability\x18\x08 \x01(\x0b\x32#.grafeas.v1.VulnerabilityOccurrenceH\x00\x12,\n\x05\x62uild\x18\t \x01(\x0b\x32\x1b.grafeas.v1.BuildOccurrenceH\x00\x12,\n\x05image\x18\n \x01(\x0b\x32\x1b.grafeas.v1.ImageOccurrenceH\x00\x12\x30\n\x07package\x18\x0b \x01(\x0b\x32\x1d.grafeas.v1.PackageOccurrenceH\x00\x12\x36\n\ndeployment\x18\x0c \x01(\x0b\x32 .grafeas.v1.DeploymentOccurrenceH\x00\x12\x34\n\tdiscovery\x18\r \x01(\x0b\x32\x1f.grafeas.v1.DiscoveryOccurrenceH\x00\x12\x38\n\x0b\x61ttestation\x18\x0e \x01(\x0b\x32!.grafeas.v1.AttestationOccurrenceH\x00\x12\x30\n\x07upgrade\x18\x0f \x01(\x0b\x32\x1d.grafeas.v1.UpgradeOccurrenceH\x00\x12\x36\n\ncompliance\x18\x10 \x01(\x0b\x32 .grafeas.v1.ComplianceOccurrenceH\x00\x12\x41\n\x10\x64sse_attestation\x18\x11 \x01(\x0b\x32%.grafeas.v1.DSSEAttestationOccurrenceH\x00\x12=\n\x0esbom_reference\x18\x13 \x01(\x0b\x32#.grafeas.v1.SBOMReferenceOccurrenceH\x00\x12.\n\x06secret\x18\x14 \x01(\x0b\x32\x1c.grafeas.v1.SecretOccurrenceH\x00\x12&\n\x08\x65nvelope\x18\x12 \x01(\x0b\x32\x14.grafeas.v1.Envelope:G\xea\x41\x44\n\x15grafeas.io/Occurrence\x12+projects/{project}/occurrences/{occurrence}B\t\n\x07\x64\x65tails\"\xa1\x08\n\x04Note\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11short_description\x18\x02 \x01(\t\x12\x18\n\x10long_description\x18\x03 \x01(\t\x12\"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12+\n\x0brelated_url\x18\x05 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x33\n\x0f\x65xpiration_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1a\n\x12related_note_names\x18\t \x03(\t\x12\x36\n\rvulnerability\x18\n \x01(\x0b\x32\x1d.grafeas.v1.VulnerabilityNoteH\x00\x12&\n\x05\x62uild\x18\x0b \x01(\x0b\x32\x15.grafeas.v1.BuildNoteH\x00\x12&\n\x05image\x18\x0c \x01(\x0b\x32\x15.grafeas.v1.ImageNoteH\x00\x12*\n\x07package\x18\r \x01(\x0b\x32\x17.grafeas.v1.PackageNoteH\x00\x12\x30\n\ndeployment\x18\x0e \x01(\x0b\x32\x1a.grafeas.v1.DeploymentNoteH\x00\x12.\n\tdiscovery\x18\x0f \x01(\x0b\x32\x19.grafeas.v1.DiscoveryNoteH\x00\x12\x32\n\x0b\x61ttestation\x18\x10 \x01(\x0b\x32\x1b.grafeas.v1.AttestationNoteH\x00\x12*\n\x07upgrade\x18\x11 \x01(\x0b\x32\x17.grafeas.v1.UpgradeNoteH\x00\x12\x30\n\ncompliance\x18\x12 \x01(\x0b\x32\x1a.grafeas.v1.ComplianceNoteH\x00\x12;\n\x10\x64sse_attestation\x18\x13 \x01(\x0b\x32\x1f.grafeas.v1.DSSEAttestationNoteH\x00\x12K\n\x18vulnerability_assessment\x18\x14 \x01(\x0b\x32\'.grafeas.v1.VulnerabilityAssessmentNoteH\x00\x12\x37\n\x0esbom_reference\x18\x15 \x01(\x0b\x32\x1d.grafeas.v1.SBOMReferenceNoteH\x00\x12(\n\x06secret\x18\x16 \x01(\x0b\x32\x16.grafeas.v1.SecretNoteH\x00:5\xea\x41\x32\n\x0fgrafeas.io/Note\x12\x1fprojects/{project}/notes/{note}B\x06\n\x04type\"C\n\x14GetOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"{\n\x16ListOccurrencesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"_\n\x17ListOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"F\n\x17\x44\x65leteOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"v\n\x17\x43reateOccurrenceRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12/\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\"\xa8\x01\n\x17UpdateOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\x12/\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"7\n\x0eGetNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\"G\n\x18GetOccurrenceNoteRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"u\n\x10ListNotesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"M\n\x11ListNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\":\n\x11\x44\x65leteNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\"z\n\x11\x43reateNoteRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x14\n\x07note_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12#\n\x04note\x18\x03 \x01(\x0b\x32\x10.grafeas.v1.NoteB\x03\xe0\x41\x02\"\x90\x01\n\x11UpdateNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\x12#\n\x04note\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.NoteB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"z\n\x1aListNoteOccurrencesRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"c\n\x1bListNoteOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xc9\x01\n\x17\x42\x61tchCreateNotesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x42\n\x05notes\x18\x02 \x03(\x0b\x32..grafeas.v1.BatchCreateNotesRequest.NotesEntryB\x03\xe0\x41\x02\x1a>\n\nNotesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1f\n\x05value\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.Note:\x02\x38\x01\";\n\x18\x42\x61tchCreateNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note\"}\n\x1d\x42\x61tchCreateOccurrencesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x30\n\x0boccurrences\x18\x02 \x03(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\"M\n\x1e\x42\x61tchCreateOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence2\x8d\x16\n\x07Grafeas\x12\xb0\x01\n\rGetOccurrence\x12 .grafeas.v1.GetOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"e\xda\x41\x04name\x82\xd3\xe4\x93\x02X\x12#/v1/{name=projects/*/occurrences/*}Z1\x12//v1/{name=projects/*/locations/*/occurrences/*}\x12\xca\x01\n\x0fListOccurrences\x12\".grafeas.v1.ListOccurrencesRequest\x1a#.grafeas.v1.ListOccurrencesResponse\"n\xda\x41\rparent,filter\x82\xd3\xe4\x93\x02X\x12#/v1/{parent=projects/*}/occurrencesZ1\x12//v1/{parent=projects/*/locations/*}/occurrences\x12\xb6\x01\n\x10\x44\x65leteOccurrence\x12#.grafeas.v1.DeleteOccurrenceRequest\x1a\x16.google.protobuf.Empty\"e\xda\x41\x04name\x82\xd3\xe4\x93\x02X*#/v1/{name=projects/*/occurrences/*}Z1*//v1/{name=projects/*/locations/*/occurrences/*}\x12\xdc\x01\n\x10\x43reateOccurrence\x12#.grafeas.v1.CreateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"\x8a\x01\xda\x41\x11parent,occurrence\x82\xd3\xe4\x93\x02p\"#/v1/{parent=projects/*}/occurrences:\noccurrenceZ=\"//v1/{parent=projects/*/locations/*}/occurrences:\noccurrence\x12\x83\x02\n\x16\x42\x61tchCreateOccurrences\x12).grafeas.v1.BatchCreateOccurrencesRequest\x1a*.grafeas.v1.BatchCreateOccurrencesResponse\"\x91\x01\xda\x41\x12parent,occurrences\x82\xd3\xe4\x93\x02v\"//v1/{parent=projects/*}/occurrences:batchCreate:\x01*Z@\";/v1/{parent=projects/*/locations/*}/occurrences:batchCreate:\x01*\x12\xe6\x01\n\x10UpdateOccurrence\x12#.grafeas.v1.UpdateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"\x94\x01\xda\x41\x1bname,occurrence,update_mask\x82\xd3\xe4\x93\x02p2#/v1/{name=projects/*/occurrences/*}:\noccurrenceZ=2//v1/{name=projects/*/locations/*/occurrences/*}:\noccurrence\x12\xbe\x01\n\x11GetOccurrenceNote\x12$.grafeas.v1.GetOccurrenceNoteRequest\x1a\x10.grafeas.v1.Note\"q\xda\x41\x04name\x82\xd3\xe4\x93\x02\x64\x12)/v1/{name=projects/*/occurrences/*}/notesZ7\x12\x35/v1/{name=projects/*/locations/*/occurrences/*}/notes\x12\x92\x01\n\x07GetNote\x12\x1a.grafeas.v1.GetNoteRequest\x1a\x10.grafeas.v1.Note\"Y\xda\x41\x04name\x82\xd3\xe4\x93\x02L\x12\x1d/v1/{name=projects/*/notes/*}Z+\x12)/v1/{name=projects/*/locations/*/notes/*}\x12\xac\x01\n\tListNotes\x12\x1c.grafeas.v1.ListNotesRequest\x1a\x1d.grafeas.v1.ListNotesResponse\"b\xda\x41\rparent,filter\x82\xd3\xe4\x93\x02L\x12\x1d/v1/{parent=projects/*}/notesZ+\x12)/v1/{parent=projects/*/locations/*}/notes\x12\x9e\x01\n\nDeleteNote\x12\x1d.grafeas.v1.DeleteNoteRequest\x1a\x16.google.protobuf.Empty\"Y\xda\x41\x04name\x82\xd3\xe4\x93\x02L*\x1d/v1/{name=projects/*/notes/*}Z+*)/v1/{name=projects/*/locations/*/notes/*}\x12\xb3\x01\n\nCreateNote\x12\x1d.grafeas.v1.CreateNoteRequest\x1a\x10.grafeas.v1.Note\"t\xda\x41\x13parent,note_id,note\x82\xd3\xe4\x93\x02X\"\x1d/v1/{parent=projects/*}/notes:\x04noteZ1\")/v1/{parent=projects/*/locations/*}/notes:\x04note\x12\xde\x01\n\x10\x42\x61tchCreateNotes\x12#.grafeas.v1.BatchCreateNotesRequest\x1a$.grafeas.v1.BatchCreateNotesResponse\"\x7f\xda\x41\x0cparent,notes\x82\xd3\xe4\x93\x02j\")/v1/{parent=projects/*}/notes:batchCreate:\x01*Z:\"5/v1/{parent=projects/*/locations/*}/notes:batchCreate:\x01*\x12\xb5\x01\n\nUpdateNote\x12\x1d.grafeas.v1.UpdateNoteRequest\x1a\x10.grafeas.v1.Note\"v\xda\x41\x15name,note,update_mask\x82\xd3\xe4\x93\x02X2\x1d/v1/{name=projects/*/notes/*}:\x04noteZ12)/v1/{name=projects/*/locations/*/notes/*}:\x04note\x12\xe0\x01\n\x13ListNoteOccurrences\x12&.grafeas.v1.ListNoteOccurrencesRequest\x1a\'.grafeas.v1.ListNoteOccurrencesResponse\"x\xda\x41\x0bname,filter\x82\xd3\xe4\x93\x02\x64\x12)/v1/{name=projects/*/notes/*}/occurrencesZ7\x12\x35/v1/{name=projects/*/locations/*/notes/*}/occurrences\x1a#\xca\x41 containeranalysis.googleapis.comB|\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRA\xea\x41(\n\x12grafeas.io/Project\x12\x12projects/{project}b\x06proto3" +descriptor_data = "\n\x18grafeas/v1/grafeas.proto\x12\ngrafeas.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgrafeas/v1/attestation.proto\x1a\x16grafeas/v1/build.proto\x1a\x17grafeas/v1/common.proto\x1a\x1bgrafeas/v1/compliance.proto\x1a\x1bgrafeas/v1/deployment.proto\x1a\x1agrafeas/v1/discovery.proto\x1a!grafeas/v1/dsse_attestation.proto\x1a\x16grafeas/v1/image.proto\x1a\x18grafeas/v1/package.proto\x1a\x15grafeas/v1/sbom.proto\x1a\x17grafeas/v1/secret.proto\x1a\x18grafeas/v1/upgrade.proto\x1a\x14grafeas/v1/vex.proto\x1a\x1egrafeas/v1/vulnerability.proto\"\xea\x07\n\nOccurrence\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0cresource_uri\x18\x02 \x01(\t\x12\x11\n\tnote_name\x18\x03 \x01(\t\x12\"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12\x13\n\x0bremediation\x18\x05 \x01(\t\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\rvulnerability\x18\x08 \x01(\x0b\x32#.grafeas.v1.VulnerabilityOccurrenceH\x00\x12,\n\x05\x62uild\x18\t \x01(\x0b\x32\x1b.grafeas.v1.BuildOccurrenceH\x00\x12,\n\x05image\x18\n \x01(\x0b\x32\x1b.grafeas.v1.ImageOccurrenceH\x00\x12\x30\n\x07package\x18\x0b \x01(\x0b\x32\x1d.grafeas.v1.PackageOccurrenceH\x00\x12\x36\n\ndeployment\x18\x0c \x01(\x0b\x32 .grafeas.v1.DeploymentOccurrenceH\x00\x12\x34\n\tdiscovery\x18\r \x01(\x0b\x32\x1f.grafeas.v1.DiscoveryOccurrenceH\x00\x12\x38\n\x0b\x61ttestation\x18\x0e \x01(\x0b\x32!.grafeas.v1.AttestationOccurrenceH\x00\x12\x30\n\x07upgrade\x18\x0f \x01(\x0b\x32\x1d.grafeas.v1.UpgradeOccurrenceH\x00\x12\x36\n\ncompliance\x18\x10 \x01(\x0b\x32 .grafeas.v1.ComplianceOccurrenceH\x00\x12\x41\n\x10\x64sse_attestation\x18\x11 \x01(\x0b\x32%.grafeas.v1.DSSEAttestationOccurrenceH\x00\x12=\n\x0esbom_reference\x18\x13 \x01(\x0b\x32#.grafeas.v1.SBOMReferenceOccurrenceH\x00\x12.\n\x06secret\x18\x14 \x01(\x0b\x32\x1c.grafeas.v1.SecretOccurrenceH\x00\x12&\n\x08\x65nvelope\x18\x12 \x01(\x0b\x32\x14.grafeas.v1.Envelope:G\xea\x41\x44\n\x15grafeas.io/Occurrence\x12+projects/{project}/occurrences/{occurrence}B\t\n\x07\x64\x65tails\"\xa1\x08\n\x04Note\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11short_description\x18\x02 \x01(\t\x12\x18\n\x10long_description\x18\x03 \x01(\t\x12\"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12+\n\x0brelated_url\x18\x05 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x33\n\x0f\x65xpiration_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1a\n\x12related_note_names\x18\t \x03(\t\x12\x36\n\rvulnerability\x18\n \x01(\x0b\x32\x1d.grafeas.v1.VulnerabilityNoteH\x00\x12&\n\x05\x62uild\x18\x0b \x01(\x0b\x32\x15.grafeas.v1.BuildNoteH\x00\x12&\n\x05image\x18\x0c \x01(\x0b\x32\x15.grafeas.v1.ImageNoteH\x00\x12*\n\x07package\x18\r \x01(\x0b\x32\x17.grafeas.v1.PackageNoteH\x00\x12\x30\n\ndeployment\x18\x0e \x01(\x0b\x32\x1a.grafeas.v1.DeploymentNoteH\x00\x12.\n\tdiscovery\x18\x0f \x01(\x0b\x32\x19.grafeas.v1.DiscoveryNoteH\x00\x12\x32\n\x0b\x61ttestation\x18\x10 \x01(\x0b\x32\x1b.grafeas.v1.AttestationNoteH\x00\x12*\n\x07upgrade\x18\x11 \x01(\x0b\x32\x17.grafeas.v1.UpgradeNoteH\x00\x12\x30\n\ncompliance\x18\x12 \x01(\x0b\x32\x1a.grafeas.v1.ComplianceNoteH\x00\x12;\n\x10\x64sse_attestation\x18\x13 \x01(\x0b\x32\x1f.grafeas.v1.DSSEAttestationNoteH\x00\x12K\n\x18vulnerability_assessment\x18\x14 \x01(\x0b\x32\'.grafeas.v1.VulnerabilityAssessmentNoteH\x00\x12\x37\n\x0esbom_reference\x18\x15 \x01(\x0b\x32\x1d.grafeas.v1.SBOMReferenceNoteH\x00\x12(\n\x06secret\x18\x16 \x01(\x0b\x32\x16.grafeas.v1.SecretNoteH\x00:5\xea\x41\x32\n\x0fgrafeas.io/Note\x12\x1fprojects/{project}/notes/{note}B\x06\n\x04type\"C\n\x14GetOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"\x9b\x01\n\x16ListOccurrencesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x1e\n\x16return_partial_success\x18\x05 \x01(\x08\"y\n\x17ListOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x18\n\x0bunreachable\x18\x03 \x03(\tB\x03\xe0\x41\x06\"F\n\x17\x44\x65leteOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"v\n\x17\x43reateOccurrenceRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12/\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\"\xa8\x01\n\x17UpdateOccurrenceRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\x12/\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"7\n\x0eGetNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\"G\n\x18GetOccurrenceNoteRequest\x12+\n\x04name\x18\x01 \x01(\tB\x1d\xe0\x41\x02\xfa\x41\x17\n\x15grafeas.io/Occurrence\"\x95\x01\n\x10ListNotesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x1e\n\x16return_partial_success\x18\x05 \x01(\x08\"g\n\x11ListNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x18\n\x0bunreachable\x18\x03 \x03(\tB\x03\xe0\x41\x06\":\n\x11\x44\x65leteNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\"z\n\x11\x43reateNoteRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x14\n\x07note_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12#\n\x04note\x18\x03 \x01(\x0b\x32\x10.grafeas.v1.NoteB\x03\xe0\x41\x02\"\x90\x01\n\x11UpdateNoteRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\x12#\n\x04note\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.NoteB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"z\n\x1aListNoteOccurrencesRequest\x12%\n\x04name\x18\x01 \x01(\tB\x17\xe0\x41\x02\xfa\x41\x11\n\x0fgrafeas.io/Note\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"c\n\x1bListNoteOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xc9\x01\n\x17\x42\x61tchCreateNotesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x42\n\x05notes\x18\x02 \x03(\x0b\x32..grafeas.v1.BatchCreateNotesRequest.NotesEntryB\x03\xe0\x41\x02\x1a>\n\nNotesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1f\n\x05value\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.Note:\x02\x38\x01\";\n\x18\x42\x61tchCreateNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note\"}\n\x1d\x42\x61tchCreateOccurrencesRequest\x12*\n\x06parent\x18\x01 \x01(\tB\x1a\xe0\x41\x02\xfa\x41\x14\n\x12grafeas.io/Project\x12\x30\n\x0boccurrences\x18\x02 \x03(\x0b\x32\x16.grafeas.v1.OccurrenceB\x03\xe0\x41\x02\"M\n\x1e\x42\x61tchCreateOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence2\x8d\x16\n\x07Grafeas\x12\xb0\x01\n\rGetOccurrence\x12 .grafeas.v1.GetOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"e\xda\x41\x04name\x82\xd3\xe4\x93\x02X\x12#/v1/{name=projects/*/occurrences/*}Z1\x12//v1/{name=projects/*/locations/*/occurrences/*}\x12\xca\x01\n\x0fListOccurrences\x12\".grafeas.v1.ListOccurrencesRequest\x1a#.grafeas.v1.ListOccurrencesResponse\"n\xda\x41\rparent,filter\x82\xd3\xe4\x93\x02X\x12#/v1/{parent=projects/*}/occurrencesZ1\x12//v1/{parent=projects/*/locations/*}/occurrences\x12\xb6\x01\n\x10\x44\x65leteOccurrence\x12#.grafeas.v1.DeleteOccurrenceRequest\x1a\x16.google.protobuf.Empty\"e\xda\x41\x04name\x82\xd3\xe4\x93\x02X*#/v1/{name=projects/*/occurrences/*}Z1*//v1/{name=projects/*/locations/*/occurrences/*}\x12\xdc\x01\n\x10\x43reateOccurrence\x12#.grafeas.v1.CreateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"\x8a\x01\xda\x41\x11parent,occurrence\x82\xd3\xe4\x93\x02p\"#/v1/{parent=projects/*}/occurrences:\noccurrenceZ=\"//v1/{parent=projects/*/locations/*}/occurrences:\noccurrence\x12\x83\x02\n\x16\x42\x61tchCreateOccurrences\x12).grafeas.v1.BatchCreateOccurrencesRequest\x1a*.grafeas.v1.BatchCreateOccurrencesResponse\"\x91\x01\xda\x41\x12parent,occurrences\x82\xd3\xe4\x93\x02v\"//v1/{parent=projects/*}/occurrences:batchCreate:\x01*Z@\";/v1/{parent=projects/*/locations/*}/occurrences:batchCreate:\x01*\x12\xe6\x01\n\x10UpdateOccurrence\x12#.grafeas.v1.UpdateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence\"\x94\x01\xda\x41\x1bname,occurrence,update_mask\x82\xd3\xe4\x93\x02p2#/v1/{name=projects/*/occurrences/*}:\noccurrenceZ=2//v1/{name=projects/*/locations/*/occurrences/*}:\noccurrence\x12\xbe\x01\n\x11GetOccurrenceNote\x12$.grafeas.v1.GetOccurrenceNoteRequest\x1a\x10.grafeas.v1.Note\"q\xda\x41\x04name\x82\xd3\xe4\x93\x02\x64\x12)/v1/{name=projects/*/occurrences/*}/notesZ7\x12\x35/v1/{name=projects/*/locations/*/occurrences/*}/notes\x12\x92\x01\n\x07GetNote\x12\x1a.grafeas.v1.GetNoteRequest\x1a\x10.grafeas.v1.Note\"Y\xda\x41\x04name\x82\xd3\xe4\x93\x02L\x12\x1d/v1/{name=projects/*/notes/*}Z+\x12)/v1/{name=projects/*/locations/*/notes/*}\x12\xac\x01\n\tListNotes\x12\x1c.grafeas.v1.ListNotesRequest\x1a\x1d.grafeas.v1.ListNotesResponse\"b\xda\x41\rparent,filter\x82\xd3\xe4\x93\x02L\x12\x1d/v1/{parent=projects/*}/notesZ+\x12)/v1/{parent=projects/*/locations/*}/notes\x12\x9e\x01\n\nDeleteNote\x12\x1d.grafeas.v1.DeleteNoteRequest\x1a\x16.google.protobuf.Empty\"Y\xda\x41\x04name\x82\xd3\xe4\x93\x02L*\x1d/v1/{name=projects/*/notes/*}Z+*)/v1/{name=projects/*/locations/*/notes/*}\x12\xb3\x01\n\nCreateNote\x12\x1d.grafeas.v1.CreateNoteRequest\x1a\x10.grafeas.v1.Note\"t\xda\x41\x13parent,note_id,note\x82\xd3\xe4\x93\x02X\"\x1d/v1/{parent=projects/*}/notes:\x04noteZ1\")/v1/{parent=projects/*/locations/*}/notes:\x04note\x12\xde\x01\n\x10\x42\x61tchCreateNotes\x12#.grafeas.v1.BatchCreateNotesRequest\x1a$.grafeas.v1.BatchCreateNotesResponse\"\x7f\xda\x41\x0cparent,notes\x82\xd3\xe4\x93\x02j\")/v1/{parent=projects/*}/notes:batchCreate:\x01*Z:\"5/v1/{parent=projects/*/locations/*}/notes:batchCreate:\x01*\x12\xb5\x01\n\nUpdateNote\x12\x1d.grafeas.v1.UpdateNoteRequest\x1a\x10.grafeas.v1.Note\"v\xda\x41\x15name,note,update_mask\x82\xd3\xe4\x93\x02X2\x1d/v1/{name=projects/*/notes/*}:\x04noteZ12)/v1/{name=projects/*/locations/*/notes/*}:\x04note\x12\xe0\x01\n\x13ListNoteOccurrences\x12&.grafeas.v1.ListNoteOccurrencesRequest\x1a\'.grafeas.v1.ListNoteOccurrencesResponse\"x\xda\x41\x0bname,filter\x82\xd3\xe4\x93\x02\x64\x12)/v1/{name=projects/*/notes/*}/occurrencesZ7\x12\x35/v1/{name=projects/*/locations/*/notes/*}/occurrences\x1a#\xca\x41 containeranalysis.googleapis.comB|\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRA\xea\x41(\n\x12grafeas.io/Project\x12\x12projects/{project}b\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/risk_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/risk_pb.rb new file mode 100644 index 000000000..970f5ed28 --- /dev/null +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/risk_pb.rb @@ -0,0 +1,19 @@ +# frozen_string_literal: true +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: grafeas/v1/risk.proto + +require 'google/protobuf' + + +descriptor_data = "\n\x15grafeas/v1/risk.proto\x12\ngrafeas.v1\"\x81\x01\n\x04Risk\x12?\n\x08\x63isa_kev\x18\x01 \x01(\x0b\x32-.grafeas.v1.CISAKnownExploitedVulnerabilities\x12\x38\n\x04\x65pss\x18\x02 \x01(\x0b\x32*.grafeas.v1.ExploitPredictionScoringSystem\"J\n!CISAKnownExploitedVulnerabilities\x12%\n\x1dknown_ransomware_campaign_use\x18\x01 \x01(\t\"C\n\x1e\x45xploitPredictionScoringSystem\x12\x12\n\npercentile\x18\x01 \x01(\x01\x12\r\n\x05score\x18\x02 \x01(\x01\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" + +pool = ::Google::Protobuf::DescriptorPool.generated_pool +pool.add_serialized_file(descriptor_data) + +module Grafeas + module V1 + Risk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.Risk").msgclass + CISAKnownExploitedVulnerabilities = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.CISAKnownExploitedVulnerabilities").msgclass + ExploitPredictionScoringSystem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("grafeas.v1.ExploitPredictionScoringSystem").msgclass + end +end diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/secret_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/secret_pb.rb index ed20bda39..0ca629f57 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/secret_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/secret_pb.rb @@ -5,11 +5,12 @@ require 'google/protobuf' require 'google/api/field_behavior_pb' +require 'google/protobuf/any_pb' require 'google/protobuf/timestamp_pb' require 'grafeas/v1/common_pb' -descriptor_data = "\n\x17grafeas/v1/secret.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17grafeas/v1/common.proto\"\x0c\n\nSecretNote\"\xa2\x01\n\x10SecretOccurrence\x12)\n\x04kind\x18\x01 \x01(\x0e\x32\x16.grafeas.v1.SecretKindB\x03\xe0\x41\x02\x12\x32\n\tlocations\x18\x02 \x03(\x0b\x32\x1a.grafeas.v1.SecretLocationB\x03\xe0\x41\x01\x12/\n\x08statuses\x18\x03 \x03(\x0b\x32\x18.grafeas.v1.SecretStatusB\x03\xe0\x41\x01\"O\n\x0eSecretLocation\x12\x31\n\rfile_location\x18\x01 \x01(\x0b\x32\x18.grafeas.v1.FileLocationH\x00\x42\n\n\x08location\"\xd7\x01\n\x0cSecretStatus\x12\x34\n\x06status\x18\x01 \x01(\x0e\x32\x1f.grafeas.v1.SecretStatus.StatusB\x03\xe0\x41\x01\x12\x34\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x01\x12\x14\n\x07message\x18\x03 \x01(\tB\x03\xe0\x41\x01\"E\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07UNKNOWN\x10\x01\x12\t\n\x05VALID\x10\x02\x12\x0b\n\x07INVALID\x10\x03*k\n\nSecretKind\x12\x1b\n\x17SECRET_KIND_UNSPECIFIED\x10\x00\x12\x17\n\x13SECRET_KIND_UNKNOWN\x10\x01\x12\'\n#SECRET_KIND_GCP_SERVICE_ACCOUNT_KEY\x10\x02\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" +descriptor_data = "\n\x17grafeas/v1/secret.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/protobuf/any.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17grafeas/v1/common.proto\"\x0c\n\nSecretNote\"\xea\x01\n\x10SecretOccurrence\x12)\n\x04kind\x18\x01 \x01(\x0e\x32\x16.grafeas.v1.SecretKindB\x03\xe0\x41\x02\x12\x32\n\tlocations\x18\x02 \x03(\x0b\x32\x1a.grafeas.v1.SecretLocationB\x03\xe0\x41\x01\x12/\n\x08statuses\x18\x03 \x03(\x0b\x32\x18.grafeas.v1.SecretStatusB\x03\xe0\x41\x01\x12\"\n\x04\x64\x61ta\x18\x04 \x01(\x0b\x32\x14.google.protobuf.Any\x12\"\n\x06\x64igest\x18\x05 \x01(\x0b\x32\x12.grafeas.v1.Digest\"O\n\x0eSecretLocation\x12\x31\n\rfile_location\x18\x01 \x01(\x0b\x32\x18.grafeas.v1.FileLocationH\x00\x42\n\n\x08location\"\xd7\x01\n\x0cSecretStatus\x12\x34\n\x06status\x18\x01 \x01(\x0e\x32\x1f.grafeas.v1.SecretStatus.StatusB\x03\xe0\x41\x01\x12\x34\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x01\x12\x14\n\x07message\x18\x03 \x01(\tB\x03\xe0\x41\x01\"E\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07UNKNOWN\x10\x01\x12\t\n\x05VALID\x10\x02\x12\x0b\n\x07INVALID\x10\x03*\xa5\x07\n\nSecretKind\x12\x1b\n\x17SECRET_KIND_UNSPECIFIED\x10\x00\x12\x17\n\x13SECRET_KIND_UNKNOWN\x10\x01\x12\'\n#SECRET_KIND_GCP_SERVICE_ACCOUNT_KEY\x10\x02\x12\x1b\n\x17SECRET_KIND_GCP_API_KEY\x10\x03\x12-\n)SECRET_KIND_GCP_OAUTH2_CLIENT_CREDENTIALS\x10\x04\x12\'\n#SECRET_KIND_GCP_OAUTH2_ACCESS_TOKEN\x10\x05\x12\'\n#SECRET_KIND_ANTHROPIC_ADMIN_API_KEY\x10\x06\x12!\n\x1dSECRET_KIND_ANTHROPIC_API_KEY\x10\x07\x12\"\n\x1eSECRET_KIND_AZURE_ACCESS_TOKEN\x10\x08\x12$\n SECRET_KIND_AZURE_IDENTITY_TOKEN\x10\t\x12\x30\n,SECRET_KIND_DOCKER_HUB_PERSONAL_ACCESS_TOKEN\x10\n\x12(\n$SECRET_KIND_GITHUB_APP_REFRESH_TOKEN\x10\x0b\x12\x31\n-SECRET_KIND_GITHUB_APP_SERVER_TO_SERVER_TOKEN\x10\x0c\x12/\n+SECRET_KIND_GITHUB_APP_USER_TO_SERVER_TOKEN\x10\r\x12\x34\n0SECRET_KIND_GITHUB_CLASSIC_PERSONAL_ACCESS_TOKEN\x10\x0e\x12\x39\n5SECRET_KIND_GITHUB_FINE_GRAINED_PERSONAL_ACCESS_TOKEN\x10\x0f\x12\"\n\x1eSECRET_KIND_GITHUB_OAUTH_TOKEN\x10\x10\x12#\n\x1fSECRET_KIND_HUGGINGFACE_API_KEY\x10\x11\x12\x1e\n\x1aSECRET_KIND_OPENAI_API_KEY\x10\x12\x12\"\n\x1eSECRET_KIND_PERPLEXITY_API_KEY\x10\x13\x12!\n\x1dSECRET_KIND_STRIPE_SECRET_KEY\x10\x14\x12%\n!SECRET_KIND_STRIPE_RESTRICTED_KEY\x10\x15\x12%\n!SECRET_KIND_STRIPE_WEBHOOK_SECRET\x10\x16\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) diff --git a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/vulnerability_pb.rb b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/vulnerability_pb.rb index 8dac3c36a..9da9440f5 100644 --- a/shared/output/cloud/grafeas_v1/lib/grafeas/v1/vulnerability_pb.rb +++ b/shared/output/cloud/grafeas_v1/lib/grafeas/v1/vulnerability_pb.rb @@ -9,11 +9,12 @@ require 'grafeas/v1/common_pb' require 'grafeas/v1/cvss_pb' require 'grafeas/v1/package_pb' +require 'grafeas/v1/risk_pb' require 'grafeas/v1/severity_pb' require 'grafeas/v1/vex_pb' -descriptor_data = "\n\x1egrafeas/v1/vulnerability.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17grafeas/v1/common.proto\x1a\x15grafeas/v1/cvss.proto\x1a\x18grafeas/v1/package.proto\x1a\x19grafeas/v1/severity.proto\x1a\x14grafeas/v1/vex.proto\"\xec\x07\n\x11VulnerabilityNote\x12\x12\n\ncvss_score\x18\x01 \x01(\x02\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x35\n\x07\x64\x65tails\x18\x03 \x03(\x0b\x32$.grafeas.v1.VulnerabilityNote.Detail\x12#\n\x07\x63vss_v3\x18\x04 \x01(\x0b\x32\x12.grafeas.v1.CVSSv3\x12\x44\n\x0fwindows_details\x18\x05 \x03(\x0b\x32+.grafeas.v1.VulnerabilityNote.WindowsDetail\x12\x36\n\x12source_update_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12-\n\x0c\x63vss_version\x18\x07 \x01(\x0e\x32\x17.grafeas.v1.CVSSVersion\x12!\n\x07\x63vss_v2\x18\x08 \x01(\x0b\x32\x10.grafeas.v1.CVSS\x1a\xad\x03\n\x06\x44\x65tail\x12\x15\n\rseverity_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x14\n\x0cpackage_type\x18\x03 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x04 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x05 \x01(\t\x12\x33\n\x16\x61\x66\x66\x65\x63ted_version_start\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x31\n\x14\x61\x66\x66\x65\x63ted_version_end\x18\x07 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x08 \x01(\t\x12\x15\n\rfixed_package\x18\t \x01(\t\x12*\n\rfixed_version\x18\n \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x13\n\x0bis_obsolete\x18\x0b \x01(\x08\x12\x36\n\x12source_update_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06source\x18\r \x01(\t\x12\x0e\n\x06vendor\x18\x0e \x01(\t\x1a\xbe\x01\n\rWindowsDetail\x12\x0f\n\x07\x63pe_uri\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12M\n\nfixing_kbs\x18\x04 \x03(\x0b\x32\x39.grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase\x1a*\n\rKnowledgeBase\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\"\x98\n\n\x17VulnerabilityOccurrence\x12\x0c\n\x04type\x18\x01 \x01(\t\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x12\n\ncvss_score\x18\x03 \x01(\x02\x12 \n\x06\x63vssv3\x18\n \x01(\x0b\x32\x10.grafeas.v1.CVSS\x12G\n\rpackage_issue\x18\x04 \x03(\x0b\x32\x30.grafeas.v1.VulnerabilityOccurrence.PackageIssue\x12\x19\n\x11short_description\x18\x05 \x01(\t\x12\x18\n\x10long_description\x18\x06 \x01(\t\x12,\n\x0crelated_urls\x18\x07 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x30\n\x12\x65\x66\x66\x65\x63tive_severity\x18\x08 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x15\n\rfix_available\x18\t \x01(\x08\x12-\n\x0c\x63vss_version\x18\x0b \x01(\x0e\x32\x17.grafeas.v1.CVSSVersion\x12!\n\x07\x63vss_v2\x18\x0c \x01(\x0b\x32\x10.grafeas.v1.CVSS\x12I\n\x0evex_assessment\x18\r \x01(\x0b\x32\x31.grafeas.v1.VulnerabilityOccurrence.VexAssessment\x12\x15\n\rextra_details\x18\x0e \x01(\t\x1a\xe0\x02\n\x0cPackageIssue\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x01 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x02 \x01(\t\x12-\n\x10\x61\x66\x66\x65\x63ted_version\x18\x03 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x04 \x01(\t\x12\x15\n\rfixed_package\x18\x05 \x01(\t\x12*\n\rfixed_version\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfix_available\x18\x07 \x01(\x08\x12\x14\n\x0cpackage_type\x18\x08 \x01(\t\x12\x35\n\x12\x65\x66\x66\x65\x63tive_severity\x18\t \x01(\x0e\x32\x14.grafeas.v1.SeverityB\x03\xe0\x41\x03\x12/\n\rfile_location\x18\n \x03(\x0b\x32\x18.grafeas.v1.FileLocation\x1a\x84\x03\n\rVexAssessment\x12\x0f\n\x03\x63ve\x18\x01 \x01(\tB\x02\x18\x01\x12\x18\n\x10vulnerability_id\x18\x08 \x01(\t\x12,\n\x0crelated_uris\x18\x02 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x11\n\tnote_name\x18\x03 \x01(\t\x12G\n\x05state\x18\x04 \x01(\x0e\x32\x38.grafeas.v1.VulnerabilityAssessmentNote.Assessment.State\x12\x0f\n\x07impacts\x18\x05 \x03(\t\x12T\n\x0cremediations\x18\x06 \x03(\x0b\x32>.grafeas.v1.VulnerabilityAssessmentNote.Assessment.Remediation\x12W\n\rjustification\x18\x07 \x01(\x0b\x32@.grafeas.v1.VulnerabilityAssessmentNote.Assessment.JustificationBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" +descriptor_data = "\n\x1egrafeas/v1/vulnerability.proto\x12\ngrafeas.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17grafeas/v1/common.proto\x1a\x15grafeas/v1/cvss.proto\x1a\x18grafeas/v1/package.proto\x1a\x15grafeas/v1/risk.proto\x1a\x19grafeas/v1/severity.proto\x1a\x14grafeas/v1/vex.proto\"\xca\x08\n\x11VulnerabilityNote\x12\x12\n\ncvss_score\x18\x01 \x01(\x02\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x35\n\x07\x64\x65tails\x18\x03 \x03(\x0b\x32$.grafeas.v1.VulnerabilityNote.Detail\x12#\n\x07\x63vss_v3\x18\x04 \x01(\x0b\x32\x12.grafeas.v1.CVSSv3\x12\x44\n\x0fwindows_details\x18\x05 \x03(\x0b\x32+.grafeas.v1.VulnerabilityNote.WindowsDetail\x12\x36\n\x12source_update_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12-\n\x0c\x63vss_version\x18\x07 \x01(\x0e\x32\x17.grafeas.v1.CVSSVersion\x12!\n\x07\x63vss_v2\x18\x08 \x01(\x0b\x32\x10.grafeas.v1.CVSS\x12\x39\n\x15\x61\x64visory_publish_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12!\n\x07\x63vss_v4\x18\n \x01(\x0b\x32\x10.grafeas.v1.CVSS\x1a\xad\x03\n\x06\x44\x65tail\x12\x15\n\rseverity_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x14\n\x0cpackage_type\x18\x03 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x04 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x05 \x01(\t\x12\x33\n\x16\x61\x66\x66\x65\x63ted_version_start\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x31\n\x14\x61\x66\x66\x65\x63ted_version_end\x18\x07 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x08 \x01(\t\x12\x15\n\rfixed_package\x18\t \x01(\t\x12*\n\rfixed_version\x18\n \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x13\n\x0bis_obsolete\x18\x0b \x01(\x08\x12\x36\n\x12source_update_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06source\x18\r \x01(\t\x12\x0e\n\x06vendor\x18\x0e \x01(\t\x1a\xbe\x01\n\rWindowsDetail\x12\x0f\n\x07\x63pe_uri\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12M\n\nfixing_kbs\x18\x04 \x03(\x0b\x32\x39.grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase\x1a*\n\rKnowledgeBase\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\"\xdb\n\n\x17VulnerabilityOccurrence\x12\x0c\n\x04type\x18\x01 \x01(\t\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x12\n\ncvss_score\x18\x03 \x01(\x02\x12 \n\x06\x63vssv3\x18\n \x01(\x0b\x32\x10.grafeas.v1.CVSS\x12G\n\rpackage_issue\x18\x04 \x03(\x0b\x32\x30.grafeas.v1.VulnerabilityOccurrence.PackageIssue\x12\x19\n\x11short_description\x18\x05 \x01(\t\x12\x18\n\x10long_description\x18\x06 \x01(\t\x12,\n\x0crelated_urls\x18\x07 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x30\n\x12\x65\x66\x66\x65\x63tive_severity\x18\x08 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x15\n\rfix_available\x18\t \x01(\x08\x12-\n\x0c\x63vss_version\x18\x0b \x01(\x0e\x32\x17.grafeas.v1.CVSSVersion\x12!\n\x07\x63vss_v2\x18\x0c \x01(\x0b\x32\x10.grafeas.v1.CVSS\x12I\n\x0evex_assessment\x18\r \x01(\x0b\x32\x31.grafeas.v1.VulnerabilityOccurrence.VexAssessment\x12\x15\n\rextra_details\x18\x0e \x01(\t\x12\x1e\n\x04risk\x18\x0f \x01(\x0b\x32\x10.grafeas.v1.Risk\x12!\n\x07\x63vss_v4\x18\x10 \x01(\x0b\x32\x10.grafeas.v1.CVSS\x1a\xe0\x02\n\x0cPackageIssue\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x01 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x02 \x01(\t\x12-\n\x10\x61\x66\x66\x65\x63ted_version\x18\x03 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x04 \x01(\t\x12\x15\n\rfixed_package\x18\x05 \x01(\t\x12*\n\rfixed_version\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfix_available\x18\x07 \x01(\x08\x12\x14\n\x0cpackage_type\x18\x08 \x01(\t\x12\x35\n\x12\x65\x66\x66\x65\x63tive_severity\x18\t \x01(\x0e\x32\x14.grafeas.v1.SeverityB\x03\xe0\x41\x03\x12/\n\rfile_location\x18\n \x03(\x0b\x32\x18.grafeas.v1.FileLocation\x1a\x84\x03\n\rVexAssessment\x12\x0f\n\x03\x63ve\x18\x01 \x01(\tB\x02\x18\x01\x12\x18\n\x10vulnerability_id\x18\x08 \x01(\t\x12,\n\x0crelated_uris\x18\x02 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x11\n\tnote_name\x18\x03 \x01(\t\x12G\n\x05state\x18\x04 \x01(\x0e\x32\x38.grafeas.v1.VulnerabilityAssessmentNote.Assessment.State\x12\x0f\n\x07impacts\x18\x05 \x03(\t\x12T\n\x0cremediations\x18\x06 \x03(\x0b\x32>.grafeas.v1.VulnerabilityAssessmentNote.Assessment.Remediation\x12W\n\rjustification\x18\x07 \x01(\x0b\x32@.grafeas.v1.VulnerabilityAssessmentNote.Assessment.JustificationBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) diff --git a/shared/output/cloud/grafeas_v1/proto_docs/google/api/client.rb b/shared/output/cloud/grafeas_v1/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/google/api/client.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/common.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/common.rb index 948090fe2..eabafd087 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/common.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/common.rb @@ -117,6 +117,10 @@ class EnvelopeSignature # @return [::Grafeas::V1::LayerDetails] # Each package found in a file should have its own layer metadata (that is, # information from the origin layer of the package). + # @!attribute [rw] line_number + # @return [::Integer] + # Line number in the file where the package was found. + # Optional field that only applies to source repository scanning. class FileLocation include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -132,6 +136,9 @@ class FileLocation # @!attribute [rw] layer_count # @return [::Integer] # The number of layers that the base image is composed of. + # @!attribute [rw] registry + # @return [::String] + # The registry in which the base image is from. class BaseImage include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/cvss.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/cvss.rb index 4f3b94494..b78b9235d 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/cvss.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/cvss.rb @@ -121,109 +121,217 @@ module Impact # @return [::Float] # @!attribute [rw] attack_vector # @return [::Grafeas::V1::CVSS::AttackVector] - # Base Metrics - # Represents the intrinsic characteristics of a vulnerability that are - # constant over time and across user environments. + # Attack Vector (AV). Defined in CVSS v2, v3, v4. # @!attribute [rw] attack_complexity # @return [::Grafeas::V1::CVSS::AttackComplexity] + # Attack Complexity (AC). Defined in CVSS v2, v3, v4. # @!attribute [rw] authentication # @return [::Grafeas::V1::CVSS::Authentication] + # Authentication (Au). Defined in CVSS v2. # @!attribute [rw] privileges_required # @return [::Grafeas::V1::CVSS::PrivilegesRequired] + # Privileges Required (PR). Defined in CVSS v3, v4. # @!attribute [rw] user_interaction # @return [::Grafeas::V1::CVSS::UserInteraction] + # User Interaction (UI). Defined in CVSS v3, v4. # @!attribute [rw] scope # @return [::Grafeas::V1::CVSS::Scope] + # Scope (S). Defined in CVSS v3. # @!attribute [rw] confidentiality_impact # @return [::Grafeas::V1::CVSS::Impact] + # Confidentiality Impact (C). Defined in CVSS v2, v3. # @!attribute [rw] integrity_impact # @return [::Grafeas::V1::CVSS::Impact] + # Integrity Impact (I). Defined in CVSS v2, v3. # @!attribute [rw] availability_impact # @return [::Grafeas::V1::CVSS::Impact] + # Availability Impact (A). Defined in CVSS v2, v3. + # @!attribute [rw] attack_requirements + # @return [::Grafeas::V1::CVSS::AttackRequirements] + # Attack Requirements (AT). Defined in CVSS v4. + # @!attribute [rw] vulnerable_system_confidentiality_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Vulnerable System Confidentiality Impact (VC). Defined in CVSS v4. + # @!attribute [rw] vulnerable_system_integrity_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Vulnerable System Integrity Impact (VI). Defined in CVSS v4. + # @!attribute [rw] vulnerable_system_availability_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Vulnerable System Availability Impact (VA). Defined in CVSS v4. + # @!attribute [rw] subsequent_system_confidentiality_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Subsequent System Confidentiality Impact (SC). Defined in CVSS v4. + # @!attribute [rw] subsequent_system_integrity_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Subsequent System Integrity Impact (SI). Defined in CVSS v4. + # @!attribute [rw] subsequent_system_availability_impact + # @return [::Grafeas::V1::CVSS::Impact] + # Subsequent System Availability Impact (SA). Defined in CVSS v4. + # @!attribute [rw] exploit_maturity + # @return [::Grafeas::V1::CVSS::ExploitMaturity] + # Exploit Maturity (E). Defined in CVSS v4. class CVSS include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods + # Attack Vector. module AttackVector + # Unspecified. ATTACK_VECTOR_UNSPECIFIED = 0 + # Attack Vector: Network (AV:N). Defined in CVSS v2, v3, v4. ATTACK_VECTOR_NETWORK = 1 + # Attack Vector: Adjacent (AV:A). Defined in CVSS v2, v3, v4. ATTACK_VECTOR_ADJACENT = 2 + # Attack Vector: Local (AV:L). Defined in CVSS v2, v3, v4. ATTACK_VECTOR_LOCAL = 3 + # Attack Vector: Physical (AV:P). Defined in CVSS v3, v4. ATTACK_VECTOR_PHYSICAL = 4 end + # Attack Complexity. module AttackComplexity + # Unspecified. ATTACK_COMPLEXITY_UNSPECIFIED = 0 + # Low attack complexity (AC:L). Defined in CVSS v2, v3, v4. ATTACK_COMPLEXITY_LOW = 1 + # High attack complexity (AC:H). Defined in CVSS v2, v3, v4. ATTACK_COMPLEXITY_HIGH = 2 + # Medium attack complexity (AC:M). Defined in CVSS v2. ATTACK_COMPLEXITY_MEDIUM = 3 end + # Authentication. module Authentication + # Unspecified. AUTHENTICATION_UNSPECIFIED = 0 + # Multiple authentication required (Au:M). Defined in CVSS v2. AUTHENTICATION_MULTIPLE = 1 + # Single authentication required (Au:S). Defined in CVSS v2. AUTHENTICATION_SINGLE = 2 + # No authentication required (Au:N). Defined in CVSS v2. AUTHENTICATION_NONE = 3 end + # Privileges Required. module PrivilegesRequired + # Unspecified. PRIVILEGES_REQUIRED_UNSPECIFIED = 0 + # No privileges required (PR:N). Defined in CVSS v3, v4. PRIVILEGES_REQUIRED_NONE = 1 + # Low privileges required (PR:L). Defined in CVSS v3, v4. PRIVILEGES_REQUIRED_LOW = 2 + # High privileges required (PR:H). Defined in CVSS v3, v4. PRIVILEGES_REQUIRED_HIGH = 3 end + # User Interaction. module UserInteraction + # Unspecified. USER_INTERACTION_UNSPECIFIED = 0 + # No user interaction required (UI:N). Defined in CVSS v3, v4. USER_INTERACTION_NONE = 1 + # User interaction required (UI:R). Defined in CVSS v3. USER_INTERACTION_REQUIRED = 2 + + # Passive user interaction required (UI:P). Defined in CVSS v4. + USER_INTERACTION_PASSIVE = 3 + + # Active user interaction required (UI:A). Defined in CVSS v4. + USER_INTERACTION_ACTIVE = 4 end + # Scope. module Scope + # Unspecified. SCOPE_UNSPECIFIED = 0 + # Scope: Unchanged (S:U). Defined in CVSS v3. SCOPE_UNCHANGED = 1 + # Scope: Changed (S:C). Defined in CVSS v3. SCOPE_CHANGED = 2 end + # Impact. module Impact + # Unspecified. IMPACT_UNSPECIFIED = 0 + # High impact (H). Defined in CVSS v3, v4. IMPACT_HIGH = 1 + # Low impact (L). Defined in CVSS v3, v4. IMPACT_LOW = 2 + # No impact (N). Defined in CVSS v2, v3, v4. IMPACT_NONE = 3 + # Partial impact (P). Defined in CVSS v2. IMPACT_PARTIAL = 4 + # Complete impact (C). Defined in CVSS v2. IMPACT_COMPLETE = 5 end + + # Attack Requirements. + module AttackRequirements + # Unspecified. + ATTACK_REQUIREMENTS_UNSPECIFIED = 0 + + # No attack requirements (AT:N). Defined in CVSS v4. + ATTACK_REQUIREMENTS_NONE = 1 + + # Attack requirements: Present (AT:P). Defined in CVSS v4. + ATTACK_REQUIREMENTS_PRESENT = 2 + end + + # Exploit Maturity (E). Defined in CVSS v4. + module ExploitMaturity + # Unspecified. + EXPLOIT_MATURITY_UNSPECIFIED = 0 + + # Exploit maturity: Not defined (E:X). Defined in CVSS v4. + EXPLOIT_MATURITY_NOT_DEFINED = 1 + + # Exploit maturity: Attacked (E:A). Defined in CVSS v4. + EXPLOIT_MATURITY_ATTACKED = 2 + + # Exploit maturity: Proof-of-concept (E:P). Defined in CVSS v4. + EXPLOIT_MATURITY_POC = 3 + + # Exploit maturity: Unreported (E:U). Defined in CVSS v4. + EXPLOIT_MATURITY_UNREPORTED = 4 + end end # CVSS Version. module CVSSVersion + # Unspecified. CVSS_VERSION_UNSPECIFIED = 0 + # CVSS v2. CVSS_VERSION_2 = 1 + # CVSS v3. CVSS_VERSION_3 = 2 + + # CVSS v4. + CVSS_VERSION_4 = 3 end end end diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/discovery.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/discovery.rb index 47d5be3a4..afc178d13 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/discovery.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/discovery.rb @@ -64,6 +64,12 @@ class DiscoveryNote # @!attribute [rw] vulnerability_attestation # @return [::Grafeas::V1::DiscoveryOccurrence::VulnerabilityAttestation] # The status of an vulnerability attestation generation. + # @!attribute [rw] files + # @return [::Array<::Grafeas::V1::DiscoveryOccurrence::File>] + # Files that make up the resource described by the occurrence. + # @!attribute [rw] last_vulnerability_update_time + # @return [::Google::Protobuf::Timestamp] + # The last time vulnerability scan results changed. class DiscoveryOccurrence include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -129,6 +135,24 @@ module VulnerabilityAttestationState end end + # @!attribute [rw] name + # @return [::String] + # @!attribute [rw] digest + # @return [::Google::Protobuf::Map{::String => ::String}] + class File + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + + # @!attribute [rw] key + # @return [::String] + # @!attribute [rw] value + # @return [::String] + class DigestEntry + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + end + # Whether the resource is continuously analyzed. module ContinuousAnalysis # Unknown. diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/grafeas.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/grafeas.rb index 855b05654..e9e28629e 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/grafeas.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/grafeas.rb @@ -243,6 +243,13 @@ class GetOccurrenceRequest # @!attribute [rw] page_token # @return [::String] # Token to provide to skip to a particular spot in the list. + # @!attribute [rw] return_partial_success + # @return [::Boolean] + # If set, the request will return all reachable Occurrences + # and report all unreachable regions in the `unreachable` field in + # the response. + # + # Only applicable for requests in the global region. class ListOccurrencesRequest include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -257,6 +264,12 @@ class ListOccurrencesRequest # The next pagination token in the list response. It should be used as # `page_token` for the following request. An empty value means no more # results. + # @!attribute [rw] unreachable + # @return [::Array<::String>] + # Unreachable regions. Populated for requests from the global region + # when `return_partial_success` is set. + # + # Format: `projects/[PROJECT_ID]/locations/[LOCATION]` class ListOccurrencesResponse include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -336,6 +349,13 @@ class GetOccurrenceNoteRequest # @!attribute [rw] page_token # @return [::String] # Token to provide to skip to a particular spot in the list. + # @!attribute [rw] return_partial_success + # @return [::Boolean] + # If set, the request will return all reachable Notes + # and report all unreachable regions in the `unreachable` field in + # the response. + # + # Only applicable for requests in the global region. class ListNotesRequest include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -350,6 +370,12 @@ class ListNotesRequest # The next pagination token in the list response. It should be used as # `page_token` for the following request. An empty value means no more # results. + # @!attribute [rw] unreachable + # @return [::Array<::String>] + # Unreachable regions. Populated for requests from the global region + # when `return_partial_success` is set. + # + # Format: `projects/[PROJECT_ID]/locations/[LOCATION]` class ListNotesResponse include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/risk.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/risk.rb new file mode 100644 index 000000000..368497cf7 --- /dev/null +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/risk.rb @@ -0,0 +1,57 @@ +# frozen_string_literal: true + +# Copyright 2026 Google LLC +# +# 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 +# +# https://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. + +# Auto-generated by gapic-generator-ruby. DO NOT EDIT! + + +module Grafeas + module V1 + # @!attribute [rw] cisa_kev + # @return [::Grafeas::V1::CISAKnownExploitedVulnerabilities] + # CISA maintains the authoritative source of vulnerabilities that have been + # exploited in the wild. + # @!attribute [rw] epss + # @return [::Grafeas::V1::ExploitPredictionScoringSystem] + # The Exploit Prediction Scoring System (EPSS) estimates the likelihood + # (probability) that a software vulnerability will be exploited in the wild. + class Risk + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # @!attribute [rw] known_ransomware_campaign_use + # @return [::String] + # Whether the vulnerability is known to have been leveraged as part of a + # ransomware campaign. + class CISAKnownExploitedVulnerabilities + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # @!attribute [rw] percentile + # @return [::Float] + # The percentile of the current score, the proportion of all scored + # vulnerabilities with the same or a lower EPSS score + # @!attribute [rw] score + # @return [::Float] + # The EPSS score representing the probability [0-1] of exploitation in the + # wild in the next 30 days + class ExploitPredictionScoringSystem + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + end +end diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/secret.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/secret.rb index 16e3567d6..19111283e 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/secret.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/secret.rb @@ -35,6 +35,13 @@ class SecretNote # @!attribute [rw] statuses # @return [::Array<::Grafeas::V1::SecretStatus>] # Status of the secret. + # @!attribute [rw] data + # @return [::Google::Protobuf::Any] + # Scan result of the secret. + # @!attribute [rw] digest + # @return [::Grafeas::V1::Digest] + # Hash value, typically a digest for the secret data, that allows unique + # identification of a specific secret. class SecretOccurrence include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -87,9 +94,72 @@ module SecretKind # The secret kind is unknown. SECRET_KIND_UNKNOWN = 1 - # A GCP service account key per: + # A Google Cloud service account key per: # https://cloud.google.com/iam/docs/creating-managing-service-account-keys SECRET_KIND_GCP_SERVICE_ACCOUNT_KEY = 2 + + # A Google Cloud API key per: + # https://cloud.google.com/docs/authentication/api-keys + SECRET_KIND_GCP_API_KEY = 3 + + # A Google Cloud OAuth2 client credentials per: + # https://developers.google.com/identity/protocols/oauth2 + SECRET_KIND_GCP_OAUTH2_CLIENT_CREDENTIALS = 4 + + # A Google Cloud OAuth2 access token per: + # https://cloud.google.com/docs/authentication/token-types#access + SECRET_KIND_GCP_OAUTH2_ACCESS_TOKEN = 5 + + # An Anthropic Admin API key. + SECRET_KIND_ANTHROPIC_ADMIN_API_KEY = 6 + + # An Anthropic API key. + SECRET_KIND_ANTHROPIC_API_KEY = 7 + + # An Azure access token. + SECRET_KIND_AZURE_ACCESS_TOKEN = 8 + + # An Azure Identity Platform ID token. + SECRET_KIND_AZURE_IDENTITY_TOKEN = 9 + + # A Docker Hub personal access token. + SECRET_KIND_DOCKER_HUB_PERSONAL_ACCESS_TOKEN = 10 + + # A GitHub App refresh token. + SECRET_KIND_GITHUB_APP_REFRESH_TOKEN = 11 + + # A GitHub App server-to-server token. + SECRET_KIND_GITHUB_APP_SERVER_TO_SERVER_TOKEN = 12 + + # A GitHub App user-to-server token. + SECRET_KIND_GITHUB_APP_USER_TO_SERVER_TOKEN = 13 + + # A GitHub personal access token (classic). + SECRET_KIND_GITHUB_CLASSIC_PERSONAL_ACCESS_TOKEN = 14 + + # A GitHub fine-grained personal access token. + SECRET_KIND_GITHUB_FINE_GRAINED_PERSONAL_ACCESS_TOKEN = 15 + + # A GitHub OAuth token. + SECRET_KIND_GITHUB_OAUTH_TOKEN = 16 + + # A Hugging Face API key. + SECRET_KIND_HUGGINGFACE_API_KEY = 17 + + # An OpenAI API key. + SECRET_KIND_OPENAI_API_KEY = 18 + + # A Perplexity API key. + SECRET_KIND_PERPLEXITY_API_KEY = 19 + + # A Stripe secret key. + SECRET_KIND_STRIPE_SECRET_KEY = 20 + + # A Stripe restricted key. + SECRET_KIND_STRIPE_RESTRICTED_KEY = 21 + + # A Stripe webhook secret. + SECRET_KIND_STRIPE_WEBHOOK_SECRET = 22 end end end diff --git a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/vulnerability.rb b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/vulnerability.rb index 86195f638..1c116d3d5 100644 --- a/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/vulnerability.rb +++ b/shared/output/cloud/grafeas_v1/proto_docs/grafeas/v1/vulnerability.rb @@ -50,6 +50,12 @@ module V1 # @!attribute [rw] cvss_v2 # @return [::Grafeas::V1::CVSS] # The full description of the v2 CVSS for this vulnerability. + # @!attribute [rw] advisory_publish_time + # @return [::Google::Protobuf::Timestamp] + # The time this advisory was published by the source. + # @!attribute [rw] cvss_v4 + # @return [::Grafeas::V1::CVSS] + # The full description of the v4 CVSS for this vulnerability. class VulnerabilityNote include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -216,6 +222,12 @@ class KnowledgeBase # @!attribute [rw] extra_details # @return [::String] # Occurrence-specific extra details about the vulnerability. + # @!attribute [rw] risk + # @return [::Grafeas::V1::Risk] + # Risk information about the vulnerability, such as CISA, EPSS, etc. + # @!attribute [rw] cvss_v4 + # @return [::Grafeas::V1::CVSS] + # The cvss v4 score for the vulnerability. class VulnerabilityOccurrence include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods diff --git a/shared/output/cloud/grafeas_v1/test/grafeas/v1/grafeas_test.rb b/shared/output/cloud/grafeas_v1/test/grafeas/v1/grafeas_test.rb index 69b6527cb..507c27f7f 100644 --- a/shared/output/cloud/grafeas_v1/test/grafeas/v1/grafeas_test.rb +++ b/shared/output/cloud/grafeas_v1/test/grafeas/v1/grafeas_test.rb @@ -133,6 +133,7 @@ def test_list_occurrences filter = "hello world" page_size = 42 page_token = "hello world" + return_partial_success = true list_occurrences_client_stub = ClientStub.new grpc_response, grpc_operation do |name, request, options:| assert_equal :list_occurrences, name @@ -141,6 +142,7 @@ def test_list_occurrences assert_equal "hello world", request["filter"] assert_equal 42, request["page_size"] assert_equal "hello world", request["page_token"] + assert_equal true, request["return_partial_success"] refute_nil options end @@ -151,35 +153,35 @@ def test_list_occurrences end # Use hash object - c.list_occurrences({ parent: parent, filter: filter, page_size: page_size, page_token: page_token }) do |response, operation| + c.list_occurrences({ parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success }) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use named arguments - c.list_occurrences parent: parent, filter: filter, page_size: page_size, page_token: page_token do |response, operation| + c.list_occurrences parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use protobuf object - c.list_occurrences ::Grafeas::V1::ListOccurrencesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token) do |response, operation| + c.list_occurrences ::Grafeas::V1::ListOccurrencesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use hash object with options - c.list_occurrences({ parent: parent, filter: filter, page_size: page_size, page_token: page_token }, grpc_options) do |response, operation| + c.list_occurrences({ parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success }, grpc_options) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use protobuf object with options - c.list_occurrences(::Grafeas::V1::ListOccurrencesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token), grpc_options) do |response, operation| + c.list_occurrences(::Grafeas::V1::ListOccurrencesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success), grpc_options) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation @@ -558,6 +560,7 @@ def test_list_notes filter = "hello world" page_size = 42 page_token = "hello world" + return_partial_success = true list_notes_client_stub = ClientStub.new grpc_response, grpc_operation do |name, request, options:| assert_equal :list_notes, name @@ -566,6 +569,7 @@ def test_list_notes assert_equal "hello world", request["filter"] assert_equal 42, request["page_size"] assert_equal "hello world", request["page_token"] + assert_equal true, request["return_partial_success"] refute_nil options end @@ -576,35 +580,35 @@ def test_list_notes end # Use hash object - c.list_notes({ parent: parent, filter: filter, page_size: page_size, page_token: page_token }) do |response, operation| + c.list_notes({ parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success }) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use named arguments - c.list_notes parent: parent, filter: filter, page_size: page_size, page_token: page_token do |response, operation| + c.list_notes parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use protobuf object - c.list_notes ::Grafeas::V1::ListNotesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token) do |response, operation| + c.list_notes ::Grafeas::V1::ListNotesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use hash object with options - c.list_notes({ parent: parent, filter: filter, page_size: page_size, page_token: page_token }, grpc_options) do |response, operation| + c.list_notes({ parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success }, grpc_options) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation end # Use protobuf object with options - c.list_notes(::Grafeas::V1::ListNotesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token), grpc_options) do |response, operation| + c.list_notes(::Grafeas::V1::ListNotesRequest.new(parent: parent, filter: filter, page_size: page_size, page_token: page_token, return_partial_success: return_partial_success), grpc_options) do |response, operation| assert_kind_of Gapic::PagedEnumerable, response assert_equal grpc_response, response.response assert_equal grpc_operation, operation diff --git a/shared/output/cloud/language_v1/proto_docs/google/api/client.rb b/shared/output/cloud/language_v1/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/language_v1/proto_docs/google/api/client.rb +++ b/shared/output/cloud/language_v1/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/language_v1beta2/proto_docs/google/api/client.rb b/shared/output/cloud/language_v1beta2/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/language_v1beta2/proto_docs/google/api/client.rb +++ b/shared/output/cloud/language_v1beta2/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/location/proto_docs/google/api/client.rb b/shared/output/cloud/location/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/location/proto_docs/google/api/client.rb +++ b/shared/output/cloud/location/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/secretmanager_v1beta1/proto_docs/google/api/client.rb b/shared/output/cloud/secretmanager_v1beta1/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/secretmanager_v1beta1/proto_docs/google/api/client.rb +++ b/shared/output/cloud/secretmanager_v1beta1/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/speech_v1/proto_docs/google/api/client.rb b/shared/output/cloud/speech_v1/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/speech_v1/proto_docs/google/api/client.rb +++ b/shared/output/cloud/speech_v1/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/vision_v1/proto_docs/google/api/client.rb b/shared/output/cloud/vision_v1/proto_docs/google/api/client.rb index d59ba51a5..3ab0b096d 100644 --- a/shared/output/cloud/vision_v1/proto_docs/google/api/client.rb +++ b/shared/output/cloud/vision_v1/proto_docs/google/api/client.rb @@ -31,6 +31,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -141,9 +143,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -155,11 +158,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -190,6 +193,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -318,10 +335,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -344,10 +363,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -356,14 +375,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -372,11 +391,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -411,6 +443,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -428,6 +462,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -469,5 +574,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/cloud/vision_v1/proto_docs/google/type/color.rb b/shared/output/cloud/vision_v1/proto_docs/google/type/color.rb index 246dafcb7..5728bc06b 100644 --- a/shared/output/cloud/vision_v1/proto_docs/google/type/color.rb +++ b/shared/output/cloud/vision_v1/proto_docs/google/type/color.rb @@ -20,22 +20,22 @@ module Google module Type # Represents a color in the RGBA color space. This representation is designed - # for simplicity of conversion to/from color representations in various + # for simplicity of conversion to and from color representations in various # languages over compactness. For example, the fields of this representation # can be trivially provided to the constructor of `java.awt.Color` in Java; it # can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` # method in iOS; and, with just a little work, it can be easily formatted into # a CSS `rgba()` string in JavaScript. # - # This reference page doesn't carry information about the absolute color - # space - # that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB, - # DCI-P3, BT.2020, etc.). By default, applications should assume the sRGB color + # This reference page doesn't have information about the absolute color + # space that should be used to interpret the RGB value—for example, sRGB, + # Adobe RGB, + # DCI-P3, and BT.2020. By default, applications should assume the sRGB color # space. # - # When color equality needs to be decided, implementations, unless - # documented otherwise, treat two colors as equal if all their red, - # green, blue, and alpha values each differ by at most 1e-5. + # When color equality needs to be decided, implementations, unless documented + # otherwise, treat two colors as equal if all their red, green, blue, and alpha + # values each differ by at most `1e-5`. # # Example (Java): # diff --git a/shared/output/cloud/vision_v1/proto_docs/google/type/latlng.rb b/shared/output/cloud/vision_v1/proto_docs/google/type/latlng.rb index c15e78a39..593314b4c 100644 --- a/shared/output/cloud/vision_v1/proto_docs/google/type/latlng.rb +++ b/shared/output/cloud/vision_v1/proto_docs/google/type/latlng.rb @@ -21,9 +21,9 @@ module Google module Type # An object that represents a latitude/longitude pair. This is expressed as a # pair of doubles to represent degrees latitude and degrees longitude. Unless - # specified otherwise, this must conform to the - # WGS84 - # standard. Values must be within normalized ranges. + # specified otherwise, this object must conform to the + # + # WGS84 standard. Values must be within normalized ranges. # @!attribute [rw] latitude # @return [::Float] # The latitude in degrees. It must be in the range [-90.0, +90.0]. diff --git a/shared/output/gapic/templates/garbage/proto_docs/google/api/client.rb b/shared/output/gapic/templates/garbage/proto_docs/google/api/client.rb index e8adcfbc3..fca6a8658 100644 --- a/shared/output/gapic/templates/garbage/proto_docs/google/api/client.rb +++ b/shared/output/gapic/templates/garbage/proto_docs/google/api/client.rb @@ -39,6 +39,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -149,9 +151,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -163,11 +166,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -198,6 +201,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -326,10 +343,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -352,10 +371,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -364,14 +383,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -380,11 +399,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -419,6 +451,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -436,6 +470,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -477,5 +582,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/compliance_pb.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/compliance_pb.rb index 354988e84..b7e054bed 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/compliance_pb.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/compliance_pb.rb @@ -8,7 +8,7 @@ require 'google/api/client_pb' -descriptor_data = "\n(google/showcase/v1beta1/compliance.proto\x12\x17google.showcase.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\"\xc3\x02\n\rRepeatRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x04info\x18\x02 \x01(\x0b\x32\'.google.showcase.v1beta1.ComplianceData\x12\x15\n\rserver_verify\x18\x03 \x01(\x08\x12!\n\x14intended_binding_uri\x18\n \x01(\tH\x00\x88\x01\x01\x12\x0f\n\x07\x66_int32\x18\x04 \x01(\x05\x12\x0f\n\x07\x66_int64\x18\x05 \x01(\x03\x12\x10\n\x08\x66_double\x18\x06 \x01(\x01\x12\x14\n\x07p_int32\x18\x07 \x01(\x05H\x01\x88\x01\x01\x12\x14\n\x07p_int64\x18\x08 \x01(\x03H\x02\x88\x01\x01\x12\x15\n\x08p_double\x18\t \x01(\x01H\x03\x88\x01\x01\x42\x17\n\x15_intended_binding_uriB\n\n\x08_p_int32B\n\n\x08_p_int64B\x0b\n\t_p_double\"^\n\x0eRepeatResponse\x12\x37\n\x07request\x18\x01 \x01(\x0b\x32&.google.showcase.v1beta1.RepeatRequest\x12\x13\n\x0b\x62inding_uri\x18\x02 \x01(\t\"J\n\x0f\x43omplianceSuite\x12\x37\n\x05group\x18\x01 \x03(\x0b\x32(.google.showcase.v1beta1.ComplianceGroup\"g\n\x0f\x43omplianceGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04rpcs\x18\x02 \x03(\t\x12\x38\n\x08requests\x18\x03 \x03(\x0b\x32&.google.showcase.v1beta1.RepeatRequest\"\xe0\x06\n\x0e\x43omplianceData\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x0f\n\x07\x66_int32\x18\x02 \x01(\x05\x12\x10\n\x08\x66_sint32\x18\x03 \x01(\x11\x12\x12\n\nf_sfixed32\x18\x04 \x01(\x0f\x12\x10\n\x08\x66_uint32\x18\x05 \x01(\r\x12\x11\n\tf_fixed32\x18\x06 \x01(\x07\x12\x0f\n\x07\x66_int64\x18\x07 \x01(\x03\x12\x10\n\x08\x66_sint64\x18\x08 \x01(\x12\x12\x12\n\nf_sfixed64\x18\t \x01(\x10\x12\x10\n\x08\x66_uint64\x18\n \x01(\x04\x12\x11\n\tf_fixed64\x18\x0b \x01(\x06\x12\x10\n\x08\x66_double\x18\x0c \x01(\x01\x12\x0f\n\x07\x66_float\x18\r \x01(\x02\x12\x0e\n\x06\x66_bool\x18\x0e \x01(\x08\x12\x0f\n\x07\x66_bytes\x18\x0f \x01(\x0c\x12\x46\n\tf_kingdom\x18\x16 \x01(\x0e\x32\x33.google.showcase.v1beta1.ComplianceData.LifeKingdom\x12=\n\x07\x66_child\x18\x10 \x01(\x0b\x32,.google.showcase.v1beta1.ComplianceDataChild\x12\x15\n\x08p_string\x18\x11 \x01(\tH\x00\x88\x01\x01\x12\x14\n\x07p_int32\x18\x12 \x01(\x05H\x01\x88\x01\x01\x12\x15\n\x08p_double\x18\x13 \x01(\x01H\x02\x88\x01\x01\x12\x13\n\x06p_bool\x18\x14 \x01(\x08H\x03\x88\x01\x01\x12K\n\tp_kingdom\x18\x17 \x01(\x0e\x32\x33.google.showcase.v1beta1.ComplianceData.LifeKingdomH\x04\x88\x01\x01\x12\x42\n\x07p_child\x18\x15 \x01(\x0b\x32,.google.showcase.v1beta1.ComplianceDataChildH\x05\x88\x01\x01\"\x83\x01\n\x0bLifeKingdom\x12\x1c\n\x18LIFE_KINGDOM_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x41RCHAEBACTERIA\x10\x01\x12\x0e\n\nEUBACTERIA\x10\x02\x12\x0c\n\x08PROTISTA\x10\x03\x12\t\n\x05\x46UNGI\x10\x04\x12\x0b\n\x07PLANTAE\x10\x05\x12\x0c\n\x08\x41NIMALIA\x10\x06\x42\x0b\n\t_p_stringB\n\n\x08_p_int32B\x0b\n\t_p_doubleB\t\n\x07_p_boolB\x0c\n\n_p_kingdomB\n\n\x08_p_child\"\xef\x03\n\x13\x43omplianceDataChild\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x0f\n\x07\x66_float\x18\x02 \x01(\x02\x12\x10\n\x08\x66_double\x18\x03 \x01(\x01\x12\x0e\n\x06\x66_bool\x18\x04 \x01(\x08\x12\x37\n\x0b\x66_continent\x18\x0b \x01(\x0e\x32\".google.showcase.v1beta1.Continent\x12\x42\n\x07\x66_child\x18\x05 \x01(\x0b\x32\x31.google.showcase.v1beta1.ComplianceDataGrandchild\x12\x15\n\x08p_string\x18\x06 \x01(\tH\x00\x88\x01\x01\x12\x14\n\x07p_float\x18\x07 \x01(\x02H\x01\x88\x01\x01\x12\x15\n\x08p_double\x18\x08 \x01(\x01H\x02\x88\x01\x01\x12\x13\n\x06p_bool\x18\t \x01(\x08H\x03\x88\x01\x01\x12\x37\n\x0bp_continent\x18\x0c \x01(\x0e\x32\".google.showcase.v1beta1.Continent\x12G\n\x07p_child\x18\n \x01(\x0b\x32\x31.google.showcase.v1beta1.ComplianceDataGrandchildH\x04\x88\x01\x01\x42\x0b\n\t_p_stringB\n\n\x08_p_floatB\x0b\n\t_p_doubleB\t\n\x07_p_boolB\n\n\x08_p_child\"N\n\x18\x43omplianceDataGrandchild\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x10\n\x08\x66_double\x18\x02 \x01(\x01\x12\x0e\n\x06\x66_bool\x18\x03 \x01(\x08\"#\n\x0b\x45numRequest\x12\x14\n\x0cunknown_enum\x18\x01 \x01(\x08\"|\n\x0c\x45numResponse\x12\x35\n\x07request\x18\x01 \x01(\x0b\x32$.google.showcase.v1beta1.EnumRequest\x12\x35\n\tcontinent\x18\x02 \x01(\x0e\x32\".google.showcase.v1beta1.Continent*i\n\tContinent\x12\x19\n\x15\x43ONTINENT_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x46RICA\x10\x01\x12\x0b\n\x07\x41MERICA\x10\x02\x12\r\n\tANTARTICA\x10\x03\x12\r\n\tAUSTRALIA\x10\x04\x12\n\n\x06\x45UROPE\x10\x05\x32\xd8\r\n\nCompliance\x12\x82\x01\n\x0eRepeatDataBody\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\x1f\x82\xd3\xe4\x93\x02\x19\"\x14/v1beta1/repeat:body:\x01*\x12\x8d\x01\n\x12RepeatDataBodyInfo\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"&\x82\xd3\xe4\x93\x02 \"\x18/v1beta1/repeat:bodyinfo:\x04info\x12\x81\x01\n\x0fRepeatDataQuery\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\x1d\x82\xd3\xe4\x93\x02\x17\x12\x15/v1beta1/repeat:query\x12\xd9\x01\n\x14RepeatDataSimplePath\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"p\x82\xd3\xe4\x93\x02j\x12h/v1beta1/repeat/{info.f_string}/{info.f_int32}/{info.f_double}/{info.f_bool}/{info.f_kingdom}:simplepath\x12\xd3\x02\n\x16RepeatDataPathResource\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\xe7\x01\x82\xd3\xe4\x93\x02\xe0\x01\x12h/v1beta1/repeat/{info.f_string=first/*}/{info.f_child.f_string=second/*}/bool/{info.f_bool}:pathresourceZt\x12r/v1beta1/repeat/{info.f_child.f_string=first/*}/{info.f_string=second/*}/bool/{info.f_bool}:childfirstpathresource\x12\xd9\x01\n\x1eRepeatDataPathTrailingResource\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"f\x82\xd3\xe4\x93\x02`\x12^/v1beta1/repeat/{info.f_string=first/*}/{info.f_child.f_string=second/**}:pathtrailingresource\x12\x88\x01\n\x11RepeatDataBodyPut\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\"\x82\xd3\xe4\x93\x02\x1c\x1a\x17/v1beta1/repeat:bodyput:\x01*\x12\x8c\x01\n\x13RepeatDataBodyPatch\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"$\x82\xd3\xe4\x93\x02\x1e\x32\x19/v1beta1/repeat:bodypatch:\x01*\x12x\n\x07GetEnum\x12$.google.showcase.v1beta1.EnumRequest\x1a%.google.showcase.v1beta1.EnumResponse\" \x82\xd3\xe4\x93\x02\x1a\x12\x18/v1beta1/compliance/enum\x12|\n\nVerifyEnum\x12%.google.showcase.v1beta1.EnumResponse\x1a%.google.showcase.v1beta1.EnumResponse\" \x82\xd3\xe4\x93\x02\x1a\"\x18/v1beta1/compliance/enum\x1a\x11\xca\x41\x0elocalhost:7469Bq\n\x1b\x63om.google.showcase.v1beta1P\x01Z4github.com/googleapis/gapic-showcase/server/genproto\xea\x02\x19Google::Showcase::V1beta1b\x06proto3" +descriptor_data = "\n(google/showcase/v1beta1/compliance.proto\x12\x17google.showcase.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\"\xc3\x02\n\rRepeatRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x04info\x18\x02 \x01(\x0b\x32\'.google.showcase.v1beta1.ComplianceData\x12\x15\n\rserver_verify\x18\x03 \x01(\x08\x12!\n\x14intended_binding_uri\x18\n \x01(\tH\x00\x88\x01\x01\x12\x0f\n\x07\x66_int32\x18\x04 \x01(\x05\x12\x0f\n\x07\x66_int64\x18\x05 \x01(\x03\x12\x10\n\x08\x66_double\x18\x06 \x01(\x01\x12\x14\n\x07p_int32\x18\x07 \x01(\x05H\x01\x88\x01\x01\x12\x14\n\x07p_int64\x18\x08 \x01(\x03H\x02\x88\x01\x01\x12\x15\n\x08p_double\x18\t \x01(\x01H\x03\x88\x01\x01\x42\x17\n\x15_intended_binding_uriB\n\n\x08_p_int32B\n\n\x08_p_int64B\x0b\n\t_p_double\"^\n\x0eRepeatResponse\x12\x37\n\x07request\x18\x01 \x01(\x0b\x32&.google.showcase.v1beta1.RepeatRequest\x12\x13\n\x0b\x62inding_uri\x18\x02 \x01(\t\"J\n\x0f\x43omplianceSuite\x12\x37\n\x05group\x18\x01 \x03(\x0b\x32(.google.showcase.v1beta1.ComplianceGroup\"g\n\x0f\x43omplianceGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04rpcs\x18\x02 \x03(\t\x12\x38\n\x08requests\x18\x03 \x03(\x0b\x32&.google.showcase.v1beta1.RepeatRequest\"\xd0\t\n\x0e\x43omplianceData\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x0f\n\x07\x66_int32\x18\x02 \x01(\x05\x12\x10\n\x08\x66_sint32\x18\x03 \x01(\x11\x12\x12\n\nf_sfixed32\x18\x04 \x01(\x0f\x12\x10\n\x08\x66_uint32\x18\x05 \x01(\r\x12\x11\n\tf_fixed32\x18\x06 \x01(\x07\x12\x0f\n\x07\x66_int64\x18\x07 \x01(\x03\x12\x10\n\x08\x66_sint64\x18\x08 \x01(\x12\x12\x12\n\nf_sfixed64\x18\t \x01(\x10\x12\x10\n\x08\x66_uint64\x18\n \x01(\x04\x12\x11\n\tf_fixed64\x18\x0b \x01(\x06\x12\x10\n\x08\x66_double\x18\x0c \x01(\x01\x12\x0f\n\x07\x66_float\x18\r \x01(\x02\x12\x0e\n\x06\x66_bool\x18\x0e \x01(\x08\x12\x0f\n\x07\x66_bytes\x18\x0f \x01(\x0c\x12\x46\n\tf_kingdom\x18\x16 \x01(\x0e\x32\x33.google.showcase.v1beta1.ComplianceData.LifeKingdom\x12=\n\x07\x66_child\x18\x10 \x01(\x0b\x32,.google.showcase.v1beta1.ComplianceDataChild\x12\x15\n\x08p_string\x18\x11 \x01(\tH\x00\x88\x01\x01\x12\x14\n\x07p_int32\x18\x12 \x01(\x05H\x01\x88\x01\x01\x12\x15\n\x08p_sint32\x18\' \x01(\x11H\x02\x88\x01\x01\x12\x17\n\np_sfixed32\x18( \x01(\x0fH\x03\x88\x01\x01\x12\x15\n\x08p_uint32\x18) \x01(\rH\x04\x88\x01\x01\x12\x16\n\tp_fixed32\x18* \x01(\x07H\x05\x88\x01\x01\x12\x14\n\x07p_int64\x18+ \x01(\x03H\x06\x88\x01\x01\x12\x15\n\x08p_sint64\x18, \x01(\x12H\x07\x88\x01\x01\x12\x17\n\np_sfixed64\x18- \x01(\x10H\x08\x88\x01\x01\x12\x15\n\x08p_uint64\x18. \x01(\x04H\t\x88\x01\x01\x12\x16\n\tp_fixed64\x18/ \x01(\x06H\n\x88\x01\x01\x12\x14\n\x07p_float\x18\x30 \x01(\x02H\x0b\x88\x01\x01\x12\x15\n\x08p_double\x18\x13 \x01(\x01H\x0c\x88\x01\x01\x12\x13\n\x06p_bool\x18\x14 \x01(\x08H\r\x88\x01\x01\x12K\n\tp_kingdom\x18\x17 \x01(\x0e\x32\x33.google.showcase.v1beta1.ComplianceData.LifeKingdomH\x0e\x88\x01\x01\x12\x42\n\x07p_child\x18\x15 \x01(\x0b\x32,.google.showcase.v1beta1.ComplianceDataChildH\x0f\x88\x01\x01\"\x83\x01\n\x0bLifeKingdom\x12\x1c\n\x18LIFE_KINGDOM_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x41RCHAEBACTERIA\x10\x01\x12\x0e\n\nEUBACTERIA\x10\x02\x12\x0c\n\x08PROTISTA\x10\x03\x12\t\n\x05\x46UNGI\x10\x04\x12\x0b\n\x07PLANTAE\x10\x05\x12\x0c\n\x08\x41NIMALIA\x10\x06\x42\x0b\n\t_p_stringB\n\n\x08_p_int32B\x0b\n\t_p_sint32B\r\n\x0b_p_sfixed32B\x0b\n\t_p_uint32B\x0c\n\n_p_fixed32B\n\n\x08_p_int64B\x0b\n\t_p_sint64B\r\n\x0b_p_sfixed64B\x0b\n\t_p_uint64B\x0c\n\n_p_fixed64B\n\n\x08_p_floatB\x0b\n\t_p_doubleB\t\n\x07_p_boolB\x0c\n\n_p_kingdomB\n\n\x08_p_child\"\xef\x03\n\x13\x43omplianceDataChild\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x0f\n\x07\x66_float\x18\x02 \x01(\x02\x12\x10\n\x08\x66_double\x18\x03 \x01(\x01\x12\x0e\n\x06\x66_bool\x18\x04 \x01(\x08\x12\x37\n\x0b\x66_continent\x18\x0b \x01(\x0e\x32\".google.showcase.v1beta1.Continent\x12\x42\n\x07\x66_child\x18\x05 \x01(\x0b\x32\x31.google.showcase.v1beta1.ComplianceDataGrandchild\x12\x15\n\x08p_string\x18\x06 \x01(\tH\x00\x88\x01\x01\x12\x14\n\x07p_float\x18\x07 \x01(\x02H\x01\x88\x01\x01\x12\x15\n\x08p_double\x18\x08 \x01(\x01H\x02\x88\x01\x01\x12\x13\n\x06p_bool\x18\t \x01(\x08H\x03\x88\x01\x01\x12\x37\n\x0bp_continent\x18\x0c \x01(\x0e\x32\".google.showcase.v1beta1.Continent\x12G\n\x07p_child\x18\n \x01(\x0b\x32\x31.google.showcase.v1beta1.ComplianceDataGrandchildH\x04\x88\x01\x01\x42\x0b\n\t_p_stringB\n\n\x08_p_floatB\x0b\n\t_p_doubleB\t\n\x07_p_boolB\n\n\x08_p_child\"N\n\x18\x43omplianceDataGrandchild\x12\x10\n\x08\x66_string\x18\x01 \x01(\t\x12\x10\n\x08\x66_double\x18\x02 \x01(\x01\x12\x0e\n\x06\x66_bool\x18\x03 \x01(\x08\"#\n\x0b\x45numRequest\x12\x14\n\x0cunknown_enum\x18\x01 \x01(\x08\"|\n\x0c\x45numResponse\x12\x35\n\x07request\x18\x01 \x01(\x0b\x32$.google.showcase.v1beta1.EnumRequest\x12\x35\n\tcontinent\x18\x02 \x01(\x0e\x32\".google.showcase.v1beta1.Continent*i\n\tContinent\x12\x19\n\x15\x43ONTINENT_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x46RICA\x10\x01\x12\x0b\n\x07\x41MERICA\x10\x02\x12\r\n\tANTARTICA\x10\x03\x12\r\n\tAUSTRALIA\x10\x04\x12\n\n\x06\x45UROPE\x10\x05\x32\xd8\r\n\nCompliance\x12\x82\x01\n\x0eRepeatDataBody\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\x1f\x82\xd3\xe4\x93\x02\x19\"\x14/v1beta1/repeat:body:\x01*\x12\x8d\x01\n\x12RepeatDataBodyInfo\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"&\x82\xd3\xe4\x93\x02 \"\x18/v1beta1/repeat:bodyinfo:\x04info\x12\x81\x01\n\x0fRepeatDataQuery\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\x1d\x82\xd3\xe4\x93\x02\x17\x12\x15/v1beta1/repeat:query\x12\xd9\x01\n\x14RepeatDataSimplePath\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"p\x82\xd3\xe4\x93\x02j\x12h/v1beta1/repeat/{info.f_string}/{info.f_int32}/{info.f_double}/{info.f_bool}/{info.f_kingdom}:simplepath\x12\xd3\x02\n\x16RepeatDataPathResource\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\xe7\x01\x82\xd3\xe4\x93\x02\xe0\x01\x12h/v1beta1/repeat/{info.f_string=first/*}/{info.f_child.f_string=second/*}/bool/{info.f_bool}:pathresourceZt\x12r/v1beta1/repeat/{info.f_child.f_string=first/*}/{info.f_string=second/*}/bool/{info.f_bool}:childfirstpathresource\x12\xd9\x01\n\x1eRepeatDataPathTrailingResource\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"f\x82\xd3\xe4\x93\x02`\x12^/v1beta1/repeat/{info.f_string=first/*}/{info.f_child.f_string=second/**}:pathtrailingresource\x12\x88\x01\n\x11RepeatDataBodyPut\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"\"\x82\xd3\xe4\x93\x02\x1c\x1a\x17/v1beta1/repeat:bodyput:\x01*\x12\x8c\x01\n\x13RepeatDataBodyPatch\x12&.google.showcase.v1beta1.RepeatRequest\x1a\'.google.showcase.v1beta1.RepeatResponse\"$\x82\xd3\xe4\x93\x02\x1e\x32\x19/v1beta1/repeat:bodypatch:\x01*\x12x\n\x07GetEnum\x12$.google.showcase.v1beta1.EnumRequest\x1a%.google.showcase.v1beta1.EnumResponse\" \x82\xd3\xe4\x93\x02\x1a\x12\x18/v1beta1/compliance/enum\x12|\n\nVerifyEnum\x12%.google.showcase.v1beta1.EnumResponse\x1a%.google.showcase.v1beta1.EnumResponse\" \x82\xd3\xe4\x93\x02\x1a\"\x18/v1beta1/compliance/enum\x1a\x11\xca\x41\x0elocalhost:7469Bq\n\x1b\x63om.google.showcase.v1beta1P\x01Z4github.com/googleapis/gapic-showcase/server/genproto\xea\x02\x19Google::Showcase::V1beta1b\x06proto3" pool = ::Google::Protobuf::DescriptorPool.generated_pool pool.add_serialized_file(descriptor_data) diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service.rb index e0580c978..b5010f972 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service.rb @@ -39,6 +39,9 @@ module Google module Showcase module V1beta1 ## + # A service that enables testing of unary and server streaming calls + # by specifying a specific, predictable sequence of responses from the service + # # @example Load this service and instantiate a gRPC client # # require "google/showcase/v1beta1/sequence_service" diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/client.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/client.rb index 777362fde..8d89ec562 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/client.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/client.rb @@ -35,6 +35,9 @@ module SequenceService ## # Client for the SequenceService service. # + # A service that enables testing of unary and server streaming calls + # by specifying a specific, predictable sequence of responses from the service + # class Client # @private API_VERSION = "" @@ -213,7 +216,7 @@ def logger # Service calls ## - # Creates a sequence. + # Create a sequence of responses to be returned as unary calls # # @overload create_sequence(request, options = nil) # Pass arguments to `create_sequence` via a request object, either of type @@ -287,7 +290,7 @@ def create_sequence request, options = nil end ## - # Creates a sequence. + # Creates a sequence of responses to be returned in a server streaming call # # @overload create_streaming_sequence(request, options = nil) # Pass arguments to `create_streaming_sequence` via a request object, either of type @@ -362,7 +365,8 @@ def create_streaming_sequence request, options = nil end ## - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information about a + # sequence of unary calls. # # @overload get_sequence_report(request, options = nil) # Pass arguments to `get_sequence_report` via a request object, either of type @@ -444,7 +448,8 @@ def get_sequence_report request, options = nil end ## - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information + # about a sequences of responses in a server streaming call. # # @overload get_streaming_sequence_report(request, options = nil) # Pass arguments to `get_streaming_sequence_report` via a request object, either of type @@ -527,7 +532,7 @@ def get_streaming_sequence_report request, options = nil end ## - # Attempts a sequence. + # Attempts a sequence of unary responses. # # @overload attempt_sequence(request, options = nil) # Pass arguments to `attempt_sequence` via a request object, either of type @@ -609,7 +614,8 @@ def attempt_sequence request, options = nil end ## - # Attempts a streaming sequence. + # Attempts a server streaming call with a sequence of responses + # Can be used to test retries and stream resumption logic # May not function as expected in HTTP mode due to when http statuses are sent # See https://github.com/googleapis/gapic-showcase/issues/1377 for more details # diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest.rb index e524062ba..8975eb76f 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest.rb @@ -39,6 +39,9 @@ module Google module Showcase module V1beta1 ## + # A service that enables testing of unary and server streaming calls + # by specifying a specific, predictable sequence of responses from the service + # # To load this service and instantiate a REST client: # # require "google/showcase/v1beta1/sequence_service/rest" diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest/client.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest/client.rb index 6600191ec..d747b3f55 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest/client.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_service/rest/client.rb @@ -37,6 +37,9 @@ module Rest ## # REST client for the SequenceService service. # + # A service that enables testing of unary and server streaming calls + # by specifying a specific, predictable sequence of responses from the service + # class Client # @private API_VERSION = "" @@ -208,7 +211,7 @@ def logger # Service calls ## - # Creates a sequence. + # Create a sequence of responses to be returned as unary calls # # @overload create_sequence(request, options = nil) # Pass arguments to `create_sequence` via a request object, either of type @@ -285,7 +288,7 @@ def create_sequence request, options = nil end ## - # Creates a sequence. + # Creates a sequence of responses to be returned in a server streaming call # # @overload create_streaming_sequence(request, options = nil) # Pass arguments to `create_streaming_sequence` via a request object, either of type @@ -362,7 +365,8 @@ def create_streaming_sequence request, options = nil end ## - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information about a + # sequence of unary calls. # # @overload get_sequence_report(request, options = nil) # Pass arguments to `get_sequence_report` via a request object, either of type @@ -439,7 +443,8 @@ def get_sequence_report request, options = nil end ## - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information + # about a sequences of responses in a server streaming call. # # @overload get_streaming_sequence_report(request, options = nil) # Pass arguments to `get_streaming_sequence_report` via a request object, either of type @@ -516,7 +521,7 @@ def get_streaming_sequence_report request, options = nil end ## - # Attempts a sequence. + # Attempts a sequence of unary responses. # # @overload attempt_sequence(request, options = nil) # Pass arguments to `attempt_sequence` via a request object, either of type @@ -593,7 +598,8 @@ def attempt_sequence request, options = nil end ## - # Attempts a streaming sequence. + # Attempts a server streaming call with a sequence of responses + # Can be used to test retries and stream resumption logic # May not function as expected in HTTP mode due to when http statuses are sent # See https://github.com/googleapis/gapic-showcase/issues/1377 for more details # diff --git a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_services_pb.rb b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_services_pb.rb index 4ed7b4378..0b2d6c04e 100644 --- a/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_services_pb.rb +++ b/shared/output/gapic/templates/showcase/lib/google/showcase/v1beta1/sequence_services_pb.rb @@ -23,6 +23,8 @@ module Google module Showcase module V1beta1 module SequenceService + # A service that enables testing of unary and server streaming calls + # by specifying a specific, predictable sequence of responses from the service class Service include ::GRPC::GenericService @@ -31,17 +33,20 @@ class Service self.unmarshal_class_method = :decode self.service_name = 'google.showcase.v1beta1.SequenceService' - # Creates a sequence. + # Create a sequence of responses to be returned as unary calls rpc :CreateSequence, ::Google::Showcase::V1beta1::CreateSequenceRequest, ::Google::Showcase::V1beta1::Sequence - # Creates a sequence. + # Creates a sequence of responses to be returned in a server streaming call rpc :CreateStreamingSequence, ::Google::Showcase::V1beta1::CreateStreamingSequenceRequest, ::Google::Showcase::V1beta1::StreamingSequence - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information about a + # sequence of unary calls. rpc :GetSequenceReport, ::Google::Showcase::V1beta1::GetSequenceReportRequest, ::Google::Showcase::V1beta1::SequenceReport - # Retrieves a sequence. + # Retrieves a sequence report which can be used to retrieve information + # about a sequences of responses in a server streaming call. rpc :GetStreamingSequenceReport, ::Google::Showcase::V1beta1::GetStreamingSequenceReportRequest, ::Google::Showcase::V1beta1::StreamingSequenceReport - # Attempts a sequence. + # Attempts a sequence of unary responses. rpc :AttemptSequence, ::Google::Showcase::V1beta1::AttemptSequenceRequest, ::Google::Protobuf::Empty - # Attempts a streaming sequence. + # Attempts a server streaming call with a sequence of responses + # Can be used to test retries and stream resumption logic # May not function as expected in HTTP mode due to when http statuses are sent # See https://github.com/googleapis/gapic-showcase/issues/1377 for more details rpc :AttemptStreamingSequence, ::Google::Showcase::V1beta1::AttemptStreamingSequenceRequest, stream(::Google::Showcase::V1beta1::AttemptStreamingSequenceResponse) diff --git a/shared/output/gapic/templates/showcase/proto_docs/google/api/client.rb b/shared/output/gapic/templates/showcase/proto_docs/google/api/client.rb index e8adcfbc3..fca6a8658 100644 --- a/shared/output/gapic/templates/showcase/proto_docs/google/api/client.rb +++ b/shared/output/gapic/templates/showcase/proto_docs/google/api/client.rb @@ -39,6 +39,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -149,9 +151,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -163,11 +166,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -198,6 +201,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -326,10 +343,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -352,10 +371,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -364,14 +383,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -380,11 +399,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -419,6 +451,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -436,6 +470,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -477,5 +582,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/gapic/templates/showcase/proto_docs/google/api/routing.rb b/shared/output/gapic/templates/showcase/proto_docs/google/api/routing.rb index 381fe9abb..9fb985574 100644 --- a/shared/output/gapic/templates/showcase/proto_docs/google/api/routing.rb +++ b/shared/output/gapic/templates/showcase/proto_docs/google/api/routing.rb @@ -57,9 +57,13 @@ module Api # app_profile_id: profiles/prof_qux # } # - # The routing header consists of one or multiple key-value pairs. Every key - # and value must be percent-encoded, and joined together in the format of - # `key1=value1&key2=value2`. + # The routing header consists of one or multiple key-value pairs. The order of + # the key-value pairs is undefined, the order of the `routing_parameters` in + # the `RoutingRule` only matters for the evaluation order of the path + # templates when `field` is the same. See the examples below for more details. + # + # Every key and value in the routing header must be percent-encoded, + # and joined together in the following format: `key1=value1&key2=value2`. # The examples below skip the percent-encoding for readability. # # Example 1 diff --git a/shared/output/gapic/templates/showcase/proto_docs/google/rpc/error_details.rb b/shared/output/gapic/templates/showcase/proto_docs/google/rpc/error_details.rb index 60e45fd18..df55a9a35 100644 --- a/shared/output/gapic/templates/showcase/proto_docs/google/rpc/error_details.rb +++ b/shared/output/gapic/templates/showcase/proto_docs/google/rpc/error_details.rb @@ -310,17 +310,17 @@ class BadRequest # In this example, in proto `field` could take one of the following values: # # * `full_name` for a violation in the `full_name` value - # * `email_addresses[1].email` for a violation in the `email` field of the + # * `email_addresses[0].email` for a violation in the `email` field of the # first `email_addresses` message - # * `email_addresses[3].type[2]` for a violation in the second `type` + # * `email_addresses[2].type[1]` for a violation in the second `type` # value in the third `email_addresses` message. # # In JSON, the same values are represented as: # # * `fullName` for a violation in the `fullName` value - # * `emailAddresses[1].email` for a violation in the `email` field of the + # * `emailAddresses[0].email` for a violation in the `email` field of the # first `emailAddresses` message - # * `emailAddresses[3].type[2]` for a violation in the second `type` + # * `emailAddresses[2].type[1]` for a violation in the second `type` # value in the third `emailAddresses` message. # @!attribute [rw] description # @return [::String] diff --git a/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/compliance.rb b/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/compliance.rb index 14ad396a8..13b928625 100644 --- a/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/compliance.rb +++ b/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/compliance.rb @@ -132,6 +132,26 @@ class ComplianceGroup # @return [::String] # @!attribute [rw] p_int32 # @return [::Integer] + # @!attribute [rw] p_sint32 + # @return [::Integer] + # @!attribute [rw] p_sfixed32 + # @return [::Integer] + # @!attribute [rw] p_uint32 + # @return [::Integer] + # @!attribute [rw] p_fixed32 + # @return [::Integer] + # @!attribute [rw] p_int64 + # @return [::Integer] + # @!attribute [rw] p_sint64 + # @return [::Integer] + # @!attribute [rw] p_sfixed64 + # @return [::Integer] + # @!attribute [rw] p_uint64 + # @return [::Integer] + # @!attribute [rw] p_fixed64 + # @return [::Integer] + # @!attribute [rw] p_float + # @return [::Float] # @!attribute [rw] p_double # @return [::Float] # @!attribute [rw] p_bool diff --git a/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/sequence.rb b/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/sequence.rb index db78b2da3..cd5585f1a 100644 --- a/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/sequence.rb +++ b/shared/output/gapic/templates/showcase/proto_docs/google/showcase/v1beta1/sequence.rb @@ -28,6 +28,7 @@ module Google module Showcase module V1beta1 + # A sequence of responses to be returned in order for each unary call attempt # @!attribute [r] name # @return [::String] # @!attribute [rw] responses @@ -51,11 +52,15 @@ class Response end end + # A sequence of responses to be returned in order at the delay specified + # as part of the server streaming call # @!attribute [r] name # @return [::String] + # The name of the streaming sequence. # @!attribute [rw] content # @return [::String] - # The Content that the stream will send + # The content that the stream will send + # this was specified when the sequence was created # @!attribute [rw] responses # @return [::Array<::Google::Showcase::V1beta1::StreamingSequence::Response>] # Sequence of responses to return in order for each attempt. If empty, the @@ -73,13 +78,14 @@ class StreamingSequence # The amount of time to delay sending the response. # @!attribute [rw] response_index # @return [::Integer] - # The index that the status should be sent + # The index that the status should be sent at class Response include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods end end + # A report of the results of a streaming sequence. # @!attribute [r] name # @return [::String] # @!attribute [rw] attempts @@ -113,6 +119,7 @@ class Attempt end end + # A report of the results of a sequence of unary responses # @!attribute [r] name # @return [::String] # @!attribute [rw] attempts @@ -146,6 +153,7 @@ class Attempt end end + # Request message for creating a sequence of unary calls # @!attribute [rw] sequence # @return [::Google::Showcase::V1beta1::Sequence] class CreateSequenceRequest @@ -153,6 +161,7 @@ class CreateSequenceRequest extend ::Google::Protobuf::MessageExts::ClassMethods end + # Request message for the sequences of responses to be sent in a server streaming call # @!attribute [rw] streaming_sequence # @return [::Google::Showcase::V1beta1::StreamingSequence] class CreateStreamingSequenceRequest @@ -160,6 +169,7 @@ class CreateStreamingSequenceRequest extend ::Google::Protobuf::MessageExts::ClassMethods end + # Request message for the unary AttemptSequence method # @!attribute [rw] name # @return [::String] class AttemptSequenceRequest @@ -167,6 +177,7 @@ class AttemptSequenceRequest extend ::Google::Protobuf::MessageExts::ClassMethods end + # Request message for the AttemptStreamingSequence method. # @!attribute [rw] name # @return [::String] # @!attribute [rw] last_fail_index @@ -179,7 +190,7 @@ class AttemptStreamingSequenceRequest extend ::Google::Protobuf::MessageExts::ClassMethods end - # The response message for the Echo methods. + # The response message for the AttemptStreamingSequence method. # @!attribute [rw] content # @return [::String] # The content specified in the request. diff --git a/shared/output/gapic/templates/testing/proto_docs/google/api/client.rb b/shared/output/gapic/templates/testing/proto_docs/google/api/client.rb index e8adcfbc3..fca6a8658 100644 --- a/shared/output/gapic/templates/testing/proto_docs/google/api/client.rb +++ b/shared/output/gapic/templates/testing/proto_docs/google/api/client.rb @@ -39,6 +39,8 @@ module Api # @!attribute [rw] selective_gapic_generation # @return [::Google::Api::SelectiveGapicGeneration] # Configuration for which RPCs should be generated in the GAPIC client. + # + # Note: This field should not be used in most cases. class CommonLanguageSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -149,9 +151,10 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # library_package: com.google.cloud.pubsub.v1 + # publishing: + # library_settings: + # java_settings: + # library_package: com.google.cloud.pubsub.v1 # @!attribute [rw] service_class_names # @return [::Google::Protobuf::Map{::String => ::String}] # Configure the Java class name to use instead of the service's for its @@ -163,11 +166,11 @@ class Publishing # # Example of a YAML configuration:: # - # publishing: - # java_settings: - # service_class_names: - # - google.pubsub.v1.Publisher: TopicAdmin - # - google.pubsub.v1.Subscriber: SubscriptionAdmin + # publishing: + # java_settings: + # service_class_names: + # - google.pubsub.v1.Publisher: TopicAdmin + # - google.pubsub.v1.Subscriber: SubscriptionAdmin # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. @@ -198,6 +201,20 @@ class CppSettings # @!attribute [rw] common # @return [::Google::Api::CommonLanguageSettings] # Some settings. + # @!attribute [rw] library_package + # @return [::String] + # The package name to use in Php. Clobbers the php_namespace option + # set in the protobuf. This should be used **only** by APIs + # who have already set the language_settings.php.package_name" field + # in gapic.yaml. API teams should use the protobuf php_namespace option + # where possible. + # + # Example of a YAML configuration:: + # + # publishing: + # library_settings: + # php_settings: + # library_package: Google\Cloud\PubSub\V1 class PhpSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -326,10 +343,12 @@ class RubySettings # service names and values are the name to be used for the service client # and call options. # - # publishing: - # go_settings: - # renamed_services: - # Publisher: TopicAdmin + # Example: + # + # publishing: + # go_settings: + # renamed_services: + # Publisher: TopicAdmin class GoSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -352,10 +371,10 @@ class RenamedServicesEntry # # Example: # - # publishing: - # method_settings: - # - selector: google.storage.control.v2.StorageControl.CreateFolder - # # method settings for CreateFolder... + # publishing: + # method_settings: + # - selector: google.storage.control.v2.StorageControl.CreateFolder + # # method settings for CreateFolder... # @!attribute [rw] long_running # @return [::Google::Api::MethodSettings::LongRunning] # Describes settings to use for long-running operations when generating @@ -364,14 +383,14 @@ class RenamedServicesEntry # # Example of a YAML configuration:: # - # publishing: - # method_settings: - # - selector: google.cloud.speech.v2.Speech.BatchRecognize - # long_running: - # initial_poll_delay: 60s # 1 minute - # poll_delay_multiplier: 1.5 - # max_poll_delay: 360s # 6 minutes - # total_poll_timeout: 54000s # 90 minutes + # publishing: + # method_settings: + # - selector: google.cloud.speech.v2.Speech.BatchRecognize + # long_running: + # initial_poll_delay: 60s # 1 minute + # poll_delay_multiplier: 1.5 + # max_poll_delay: 360s # 6 minutes + # total_poll_timeout: 54000s # 90 minutes # @!attribute [rw] auto_populated_fields # @return [::Array<::String>] # List of top-level fields of the request message, that should be @@ -380,11 +399,24 @@ class RenamedServicesEntry # # Example of a YAML configuration: # - # publishing: - # method_settings: - # - selector: google.example.v1.ExampleService.CreateExample - # auto_populated_fields: - # - request_id + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.CreateExample + # auto_populated_fields: + # - request_id + # @!attribute [rw] batching + # @return [::Google::Api::BatchingConfigProto] + # Batching configuration for an API method in client libraries. + # + # Example of a YAML configuration: + # + # publishing: + # method_settings: + # - selector: google.example.v1.ExampleService.BatchCreateExample + # batching: + # element_count_threshold: 1000 + # request_byte_threshold: 100000000 + # delay_threshold_millis: 10 class MethodSettings include ::Google::Protobuf::MessageExts extend ::Google::Protobuf::MessageExts::ClassMethods @@ -419,6 +451,8 @@ class LongRunning # This message is used to configure the generation of a subset of the RPCs in # a service for client libraries. + # + # Note: This feature should not be used in most cases. # @!attribute [rw] methods # @return [::Array<::String>] # An allowlist of the fully qualified names of RPCs that should be included @@ -436,6 +470,77 @@ class SelectiveGapicGeneration extend ::Google::Protobuf::MessageExts::ClassMethods end + # `BatchingConfigProto` defines the batching configuration for an API method. + # @!attribute [rw] thresholds + # @return [::Google::Api::BatchingSettingsProto] + # The thresholds which trigger a batched request to be sent. + # @!attribute [rw] batch_descriptor + # @return [::Google::Api::BatchingDescriptorProto] + # The request and response fields used in batching. + class BatchingConfigProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingSettingsProto` specifies a set of batching thresholds, each of + # which acts as a trigger to send a batch of messages as a request. At least + # one threshold must be positive nonzero. + # @!attribute [rw] element_count_threshold + # @return [::Integer] + # The number of elements of a field collected into a batch which, if + # exceeded, causes the batch to be sent. + # @!attribute [rw] request_byte_threshold + # @return [::Integer] + # The aggregated size of the batched field which, if exceeded, causes the + # batch to be sent. This size is computed by aggregating the sizes of the + # request field to be batched, not of the entire request message. + # @!attribute [rw] delay_threshold + # @return [::Google::Protobuf::Duration] + # The duration after which a batch should be sent, starting from the addition + # of the first message to that batch. + # @!attribute [rw] element_count_limit + # @return [::Integer] + # The maximum number of elements collected in a batch that could be accepted + # by server. + # @!attribute [rw] request_byte_limit + # @return [::Integer] + # The maximum size of the request that could be accepted by server. + # @!attribute [rw] flow_control_element_limit + # @return [::Integer] + # The maximum number of elements allowed by flow control. + # @!attribute [rw] flow_control_byte_limit + # @return [::Integer] + # The maximum size of data allowed by flow control. + # @!attribute [rw] flow_control_limit_exceeded_behavior + # @return [::Google::Api::FlowControlLimitExceededBehaviorProto] + # The behavior to take when the flow control limit is exceeded. + class BatchingSettingsProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + + # `BatchingDescriptorProto` specifies the fields of the request message to be + # used for batching, and, optionally, the fields of the response message to be + # used for demultiplexing. + # @!attribute [rw] batched_field + # @return [::String] + # The repeated field in the request message to be aggregated by batching. + # @!attribute [rw] discriminator_fields + # @return [::Array<::String>] + # A list of the fields in the request message. Two requests will be batched + # together only if the values of every field specified in + # `request_discriminator_fields` is equal between the two requests. + # @!attribute [rw] subresponse_field + # @return [::String] + # Optional. When present, indicates the field in the response message to be + # used to demultiplex the response into multiple response messages, in + # correspondence with the multiple request messages originally batched + # together. + class BatchingDescriptorProto + include ::Google::Protobuf::MessageExts + extend ::Google::Protobuf::MessageExts::ClassMethods + end + # The organization for which the client libraries are being published. # Affects the url where generated docs are published, etc. module ClientLibraryOrganization @@ -477,5 +582,20 @@ module ClientLibraryDestination # Publish the library to package managers like nuget.org and npmjs.com. PACKAGE_MANAGER = 20 end + + # The behavior to take when the flow control limit is exceeded. + module FlowControlLimitExceededBehaviorProto + # Default behavior, system-defined. + UNSET_BEHAVIOR = 0 + + # Stop operation, raise error. + THROW_EXCEPTION = 1 + + # Pause operation until limit clears. + BLOCK = 2 + + # Continue operation, disregard limit. + IGNORE = 3 + end end end diff --git a/shared/output/gapic/templates/testing/proto_docs/google/api/routing.rb b/shared/output/gapic/templates/testing/proto_docs/google/api/routing.rb index 381fe9abb..9fb985574 100644 --- a/shared/output/gapic/templates/testing/proto_docs/google/api/routing.rb +++ b/shared/output/gapic/templates/testing/proto_docs/google/api/routing.rb @@ -57,9 +57,13 @@ module Api # app_profile_id: profiles/prof_qux # } # - # The routing header consists of one or multiple key-value pairs. Every key - # and value must be percent-encoded, and joined together in the format of - # `key1=value1&key2=value2`. + # The routing header consists of one or multiple key-value pairs. The order of + # the key-value pairs is undefined, the order of the `routing_parameters` in + # the `RoutingRule` only matters for the evaluation order of the path + # templates when `field` is the same. See the examples below for more details. + # + # Every key and value in the routing header must be percent-encoded, + # and joined together in the following format: `key1=value1&key2=value2`. # The examples below skip the percent-encoding for readability. # # Example 1