google-cloud-ces-v1 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0d8a8c2230e072687fea56a6d7cae554ab3cba061dc84befb7b6c7d52e5f0283
4
- data.tar.gz: 8aa2c3331133af9617236fddb6fbe265ad13bfeebecf09413c60d5f5843f1f5b
3
+ metadata.gz: a027e5978979525d5be3e48143f2b1c3848ab18e8ec96e9944359c2d311971cf
4
+ data.tar.gz: ca244647fb70938fa168ac26c52ae013ae8a59e1386b31013f40d3c13a51b964
5
5
  SHA512:
6
- metadata.gz: 639e54904bba6d520e60aec1f810b8cb7e9df82a819fc4bcc9eadcf09960b6cc1747f0479d942bfcc710dd77f3aab3d7efa10d9c3fc89150950f4f35d0a62c0f
7
- data.tar.gz: df7ca1a1f0b62b56a40d90eff70667cd637672a174e6cc22ebedea4a0aaf75f2f2dce1c8d5687c6fba8615d3b4516788a8b38654afbcba3df2ddc313467f0a4b
6
+ metadata.gz: 68d9431c8482194420cd036350399e15a42572b86ab2b1de106ddf09b2ee8111239b6afdc6a2bc1e32941344e7b8a88b7b083c5fa2bb2fe79e046d4db0f2de82
7
+ data.tar.gz: fd0965da9eebc1706d7daa34431e483b4503f28c5fc475bf9748c8226313b5d956f26e69416caa10e5c461c2e57cdf265623c518bb1327763f1441436379457a
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 3.0+.
89
+ This library is supported on Ruby 3.2+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -4876,6 +4876,7 @@ module Google
4876
4876
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
4877
4877
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
4878
4878
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
4879
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
4879
4880
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
4880
4881
  # trigger a retry.
4881
4882
  # @return [::Hash]
@@ -4959,6 +4960,7 @@ module Google
4959
4960
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
4960
4961
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
4961
4962
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
4963
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
4962
4964
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
4963
4965
  # trigger a retry.
4964
4966
  #
@@ -703,6 +703,7 @@ module Google
703
703
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
704
704
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
705
705
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
706
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
706
707
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
707
708
  # trigger a retry.
708
709
  # @return [::Hash]
@@ -786,6 +787,7 @@ module Google
786
787
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
787
788
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
788
789
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
790
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
789
791
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
790
792
  # trigger a retry.
791
793
  #
@@ -4508,6 +4508,7 @@ module Google
4508
4508
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
4509
4509
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
4510
4510
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
4511
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
4511
4512
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
4512
4513
  # trigger a retry.
4513
4514
  # @return [::Hash]
@@ -4587,6 +4588,7 @@ module Google
4587
4588
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
4588
4589
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
4589
4590
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
4591
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
4590
4592
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
4591
4593
  # trigger a retry.
4592
4594
  #
@@ -541,6 +541,7 @@ module Google
541
541
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
542
542
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
543
543
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
544
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
544
545
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
545
546
  # trigger a retry.
546
547
  # @return [::Hash]
@@ -613,6 +614,7 @@ module Google
613
614
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
614
615
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
615
616
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
617
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
616
618
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
617
619
  # trigger a retry.
618
620
  #
@@ -635,6 +635,7 @@ module Google
635
635
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
636
636
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
637
637
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
638
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
638
639
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
639
640
  # trigger a retry.
640
641
  # @return [::Hash]
@@ -718,6 +719,7 @@ module Google
718
719
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
719
720
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
720
721
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
722
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
721
723
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
722
724
  # trigger a retry.
723
725
  #
@@ -446,6 +446,7 @@ module Google
446
446
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
447
447
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
448
448
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
449
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
449
450
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
450
451
  # trigger a retry.
451
452
  # @return [::Hash]
@@ -525,6 +526,7 @@ module Google
525
526
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
526
527
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
527
528
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
529
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
528
530
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
529
531
  # trigger a retry.
530
532
  #
@@ -8,13 +8,14 @@ require 'google/api/annotations_pb'
8
8
  require 'google/api/client_pb'
9
9
  require 'google/api/field_behavior_pb'
10
10
  require 'google/api/resource_pb'
11
+ require 'google/api/routing_pb'
11
12
  require 'google/cloud/ces/v1/common_pb'
12
13
  require 'google/cloud/ces/v1/example_pb'
13
14
  require 'google/cloud/ces/v1/search_suggestions_pb'
14
15
  require 'google/protobuf/struct_pb'
15
16
 
16
17
 
17
- descriptor_data = "\n)google/cloud/ces/v1/session_service.proto\x12\x13google.cloud.ces.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a google/cloud/ces/v1/common.proto\x1a!google/cloud/ces/v1/example.proto\x1a,google/cloud/ces/v1/search_suggestions.proto\x1a\x1cgoogle/protobuf/struct.proto\"\x99\x01\n\x10InputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\x12$\n\x17noise_suppression_level\x18\x06 \x01(\tB\x03\xe0\x41\x01\"t\n\x11OutputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\"\xed\x06\n\rSessionConfig\x12\x33\n\x07session\x18\x01 \x01(\tB\"\xe0\x41\x02\xfa\x41\x1c\n\x1a\x63\x65s.googleapis.com/Session\x12\x46\n\x12input_audio_config\x18\x02 \x01(\x0b\x32%.google.cloud.ces.v1.InputAudioConfigB\x03\xe0\x41\x01\x12H\n\x13output_audio_config\x18\x03 \x01(\x0b\x32&.google.cloud.ces.v1.OutputAudioConfigB\x03\xe0\x41\x01\x12>\n\x13historical_contexts\x18\x05 \x03(\x0b\x32\x1c.google.cloud.ces.v1.MessageB\x03\xe0\x41\x01\x12\x35\n\x0b\x65ntry_agent\x18\x0c \x01(\tB \xe0\x41\x01\xfa\x41\x1a\n\x18\x63\x65s.googleapis.com/Agent\x12\x17\n\ndeployment\x18\x08 \x01(\tB\x03\xe0\x41\x01\x12\x16\n\ttime_zone\x18\x0b \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0euse_tool_fakes\x18\x0e \x01(\x08\x42\x03\xe0\x41\x01\x12s\n\"remote_dialogflow_query_parameters\x18\x0f \x01(\x0b\x32\x42.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParametersB\x03\xe0\x41\x01\x12\"\n\x15\x65nable_text_streaming\x18\x12 \x01(\x08\x42\x03\xe0\x41\x01\x1a\xb6\x02\n\x1fRemoteDialogflowQueryParameters\x12t\n\x0fwebhook_headers\x18\x01 \x03(\x0b\x32V.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParameters.WebhookHeadersEntryB\x03\xe0\x41\x01\x12-\n\x07payload\x18\x02 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x12\x37\n\x11\x65nd_user_metadata\x18\x03 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x1a\x35\n\x13WebhookHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"C\n\tToolCalls\x12\x36\n\ntool_calls\x18\x01 \x03(\x0b\x32\x1d.google.cloud.ces.v1.ToolCallB\x03\xe0\x41\x01\"O\n\rToolResponses\x12>\n\x0etool_responses\x18\x01 \x03(\x0b\x32!.google.cloud.ces.v1.ToolResponseB\x03\xe0\x41\x01\"\x84\x01\n\tCitations\x12?\n\x0c\x63ited_chunks\x18\x01 \x03(\x0b\x32).google.cloud.ces.v1.Citations.CitedChunk\x1a\x36\n\nCitedChunk\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x0c\n\x04text\x18\x03 \x01(\t\"\x1b\n\x05\x45vent\x12\x12\n\x05\x65vent\x18\x01 \x01(\tB\x03\xe0\x41\x02\"\x82\x03\n\x0cSessionInput\x12\x13\n\x04text\x18\x01 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x13\n\x04\x64tmf\x18\x06 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x14\n\x05\x61udio\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x01H\x00\x12\x41\n\x0etool_responses\x18\x03 \x01(\x0b\x32\".google.cloud.ces.v1.ToolResponsesB\x03\xe0\x41\x01H\x00\x12\x30\n\x05image\x18\x04 \x01(\x0b\x32\x1a.google.cloud.ces.v1.ImageB\x03\xe0\x41\x01H\x00\x12.\n\x04\x62lob\x18\x07 \x01(\x0b\x32\x19.google.cloud.ces.v1.BlobB\x03\xe0\x41\x01H\x00\x12\x31\n\tvariables\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01H\x00\x12\x30\n\x05\x65vent\x18\t \x01(\x0b\x32\x1a.google.cloud.ces.v1.EventB\x03\xe0\x41\x01H\x00\x12\x1a\n\rwill_continue\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x42\x0c\n\ninput_type\"\xce\x04\n\rSessionOutput\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\x0f\n\x05\x61udio\x18\x02 \x01(\x0cH\x00\x12\x34\n\ntool_calls\x18\x03 \x01(\x0b\x32\x1e.google.cloud.ces.v1.ToolCallsH\x00\x12\x33\n\tcitations\x18\x08 \x01(\x0b\x32\x1e.google.cloud.ces.v1.CitationsH\x00\x12Q\n\x19google_search_suggestions\x18\n \x01(\x0b\x32,.google.cloud.ces.v1.GoogleSearchSuggestionsH\x00\x12\x36\n\x0b\x65nd_session\x18\t \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionH\x00\x12*\n\x07payload\x18\x0b \x01(\x0b\x32\x17.google.protobuf.StructH\x00\x12\x12\n\nturn_index\x18\x06 \x01(\x05\x12\x16\n\x0eturn_completed\x18\x04 \x01(\x08\x12O\n\x0f\x64iagnostic_info\x18\x07 \x01(\x0b\x32\x31.google.cloud.ces.v1.SessionOutput.DiagnosticInfoB\x03\xe0\x41\x01\x1an\n\x0e\x44iagnosticInfo\x12.\n\x08messages\x18\x01 \x03(\x0b\x32\x1c.google.cloud.ces.v1.Message\x12,\n\troot_span\x18\x03 \x01(\x0b\x32\x19.google.cloud.ces.v1.SpanB\r\n\x0boutput_type\",\n\x11RecognitionResult\x12\x17\n\ntranscript\x18\x01 \x01(\tB\x03\xe0\x41\x01\"&\n\x12InterruptionSignal\x12\x10\n\x08\x62\x61rge_in\x18\x01 \x01(\x08\"<\n\nEndSession\x12.\n\x08metadata\x18\x01 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\"\x08\n\x06GoAway\"\x84\x01\n\x11RunSessionRequest\x12\x37\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x02\x12\x36\n\x06inputs\x18\x03 \x03(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x02\"I\n\x12RunSessionResponse\x12\x33\n\x07outputs\x18\x01 \x03(\x0b\x32\".google.cloud.ces.v1.SessionOutput\"\xa7\x01\n\x18\x42idiSessionClientMessage\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x01H\x00\x12@\n\x0erealtime_input\x18\x02 \x01(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type\"\xf7\x02\n\x18\x42idiSessionServerMessage\x12\x41\n\x0esession_output\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionOutputB\x03\xe0\x41\x01H\x00\x12I\n\x12recognition_result\x18\x02 \x01(\x0b\x32&.google.cloud.ces.v1.RecognitionResultB\x03\xe0\x41\x01H\x00\x12K\n\x13interruption_signal\x18\x03 \x01(\x0b\x32\'.google.cloud.ces.v1.InterruptionSignalB\x03\xe0\x41\x01H\x00\x12;\n\x0b\x65nd_session\x18\x05 \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionB\x03\xe0\x41\x01H\x00\x12\x33\n\x07go_away\x18\x06 \x01(\x0b\x32\x1b.google.cloud.ces.v1.GoAwayB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type*R\n\rAudioEncoding\x12\x1e\n\x1a\x41UDIO_ENCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\t\n\x05MULAW\x10\x02\x12\x08\n\x04\x41LAW\x10\x03\x32\xea\x04\n\x0eSessionService\x12\xb2\x01\n\nRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"S\x82\xd3\xe4\x93\x02M\"H/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession:\x01*\x12\xc0\x01\n\x10StreamRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"Y\x82\xd3\xe4\x93\x02S\"N/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession:\x01*0\x01\x12t\n\x0e\x42idiRunSession\x12-.google.cloud.ces.v1.BidiSessionClientMessage\x1a-.google.cloud.ces.v1.BidiSessionServerMessage\"\x00(\x01\x30\x01\x1aj\xca\x41\x12\x63\x65s.googleapis.com\xd2\x41Rhttps://www.googleapis.com/auth/ces,https://www.googleapis.com/auth/cloud-platformB\xc1\x01\n\x17\x63om.google.cloud.ces.v1B\x13SessionServiceProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespb\xea\x41\x63\n\x1a\x63\x65s.googleapis.com/Session\x12\x45projects/{project}/locations/{location}/apps/{app}/sessions/{session}b\x06proto3"
18
+ descriptor_data = "\n)google/cloud/ces/v1/session_service.proto\x12\x13google.cloud.ces.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x18google/api/routing.proto\x1a google/cloud/ces/v1/common.proto\x1a!google/cloud/ces/v1/example.proto\x1a,google/cloud/ces/v1/search_suggestions.proto\x1a\x1cgoogle/protobuf/struct.proto\"\x99\x01\n\x10InputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\x12$\n\x17noise_suppression_level\x18\x06 \x01(\tB\x03\xe0\x41\x01\"t\n\x11OutputAudioConfig\x12?\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\".google.cloud.ces.v1.AudioEncodingB\x03\xe0\x41\x02\x12\x1e\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\"\xed\x06\n\rSessionConfig\x12\x33\n\x07session\x18\x01 \x01(\tB\"\xe0\x41\x02\xfa\x41\x1c\n\x1a\x63\x65s.googleapis.com/Session\x12\x46\n\x12input_audio_config\x18\x02 \x01(\x0b\x32%.google.cloud.ces.v1.InputAudioConfigB\x03\xe0\x41\x01\x12H\n\x13output_audio_config\x18\x03 \x01(\x0b\x32&.google.cloud.ces.v1.OutputAudioConfigB\x03\xe0\x41\x01\x12>\n\x13historical_contexts\x18\x05 \x03(\x0b\x32\x1c.google.cloud.ces.v1.MessageB\x03\xe0\x41\x01\x12\x35\n\x0b\x65ntry_agent\x18\x0c \x01(\tB \xe0\x41\x01\xfa\x41\x1a\n\x18\x63\x65s.googleapis.com/Agent\x12\x17\n\ndeployment\x18\x08 \x01(\tB\x03\xe0\x41\x01\x12\x16\n\ttime_zone\x18\x0b \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0euse_tool_fakes\x18\x0e \x01(\x08\x42\x03\xe0\x41\x01\x12s\n\"remote_dialogflow_query_parameters\x18\x0f \x01(\x0b\x32\x42.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParametersB\x03\xe0\x41\x01\x12\"\n\x15\x65nable_text_streaming\x18\x12 \x01(\x08\x42\x03\xe0\x41\x01\x1a\xb6\x02\n\x1fRemoteDialogflowQueryParameters\x12t\n\x0fwebhook_headers\x18\x01 \x03(\x0b\x32V.google.cloud.ces.v1.SessionConfig.RemoteDialogflowQueryParameters.WebhookHeadersEntryB\x03\xe0\x41\x01\x12-\n\x07payload\x18\x02 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x12\x37\n\x11\x65nd_user_metadata\x18\x03 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x1a\x35\n\x13WebhookHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"C\n\tToolCalls\x12\x36\n\ntool_calls\x18\x01 \x03(\x0b\x32\x1d.google.cloud.ces.v1.ToolCallB\x03\xe0\x41\x01\"O\n\rToolResponses\x12>\n\x0etool_responses\x18\x01 \x03(\x0b\x32!.google.cloud.ces.v1.ToolResponseB\x03\xe0\x41\x01\"\x84\x01\n\tCitations\x12?\n\x0c\x63ited_chunks\x18\x01 \x03(\x0b\x32).google.cloud.ces.v1.Citations.CitedChunk\x1a\x36\n\nCitedChunk\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x0c\n\x04text\x18\x03 \x01(\t\"\x1b\n\x05\x45vent\x12\x12\n\x05\x65vent\x18\x01 \x01(\tB\x03\xe0\x41\x02\"\x82\x03\n\x0cSessionInput\x12\x13\n\x04text\x18\x01 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x13\n\x04\x64tmf\x18\x06 \x01(\tB\x03\xe0\x41\x01H\x00\x12\x14\n\x05\x61udio\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x01H\x00\x12\x41\n\x0etool_responses\x18\x03 \x01(\x0b\x32\".google.cloud.ces.v1.ToolResponsesB\x03\xe0\x41\x01H\x00\x12\x30\n\x05image\x18\x04 \x01(\x0b\x32\x1a.google.cloud.ces.v1.ImageB\x03\xe0\x41\x01H\x00\x12.\n\x04\x62lob\x18\x07 \x01(\x0b\x32\x19.google.cloud.ces.v1.BlobB\x03\xe0\x41\x01H\x00\x12\x31\n\tvariables\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01H\x00\x12\x30\n\x05\x65vent\x18\t \x01(\x0b\x32\x1a.google.cloud.ces.v1.EventB\x03\xe0\x41\x01H\x00\x12\x1a\n\rwill_continue\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x42\x0c\n\ninput_type\"\xce\x04\n\rSessionOutput\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\x0f\n\x05\x61udio\x18\x02 \x01(\x0cH\x00\x12\x34\n\ntool_calls\x18\x03 \x01(\x0b\x32\x1e.google.cloud.ces.v1.ToolCallsH\x00\x12\x33\n\tcitations\x18\x08 \x01(\x0b\x32\x1e.google.cloud.ces.v1.CitationsH\x00\x12Q\n\x19google_search_suggestions\x18\n \x01(\x0b\x32,.google.cloud.ces.v1.GoogleSearchSuggestionsH\x00\x12\x36\n\x0b\x65nd_session\x18\t \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionH\x00\x12*\n\x07payload\x18\x0b \x01(\x0b\x32\x17.google.protobuf.StructH\x00\x12\x12\n\nturn_index\x18\x06 \x01(\x05\x12\x16\n\x0eturn_completed\x18\x04 \x01(\x08\x12O\n\x0f\x64iagnostic_info\x18\x07 \x01(\x0b\x32\x31.google.cloud.ces.v1.SessionOutput.DiagnosticInfoB\x03\xe0\x41\x01\x1an\n\x0e\x44iagnosticInfo\x12.\n\x08messages\x18\x01 \x03(\x0b\x32\x1c.google.cloud.ces.v1.Message\x12,\n\troot_span\x18\x03 \x01(\x0b\x32\x19.google.cloud.ces.v1.SpanB\r\n\x0boutput_type\",\n\x11RecognitionResult\x12\x17\n\ntranscript\x18\x01 \x01(\tB\x03\xe0\x41\x01\"&\n\x12InterruptionSignal\x12\x10\n\x08\x62\x61rge_in\x18\x01 \x01(\x08\"<\n\nEndSession\x12.\n\x08metadata\x18\x01 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\"\x08\n\x06GoAway\"\x84\x01\n\x11RunSessionRequest\x12\x37\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x02\x12\x36\n\x06inputs\x18\x03 \x03(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x02\"I\n\x12RunSessionResponse\x12\x33\n\x07outputs\x18\x01 \x03(\x0b\x32\".google.cloud.ces.v1.SessionOutput\"\xa7\x01\n\x18\x42idiSessionClientMessage\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionConfigB\x03\xe0\x41\x01H\x00\x12@\n\x0erealtime_input\x18\x02 \x01(\x0b\x32!.google.cloud.ces.v1.SessionInputB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type\"\xf7\x02\n\x18\x42idiSessionServerMessage\x12\x41\n\x0esession_output\x18\x01 \x01(\x0b\x32\".google.cloud.ces.v1.SessionOutputB\x03\xe0\x41\x01H\x00\x12I\n\x12recognition_result\x18\x02 \x01(\x0b\x32&.google.cloud.ces.v1.RecognitionResultB\x03\xe0\x41\x01H\x00\x12K\n\x13interruption_signal\x18\x03 \x01(\x0b\x32\'.google.cloud.ces.v1.InterruptionSignalB\x03\xe0\x41\x01H\x00\x12;\n\x0b\x65nd_session\x18\x05 \x01(\x0b\x32\x1f.google.cloud.ces.v1.EndSessionB\x03\xe0\x41\x01H\x00\x12\x33\n\x07go_away\x18\x06 \x01(\x0b\x32\x1b.google.cloud.ces.v1.GoAwayB\x03\xe0\x41\x01H\x00\x42\x0e\n\x0cmessage_type*R\n\rAudioEncoding\x12\x1e\n\x1a\x41UDIO_ENCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\t\n\x05MULAW\x10\x02\x12\x08\n\x04\x41LAW\x10\x03\x32\xb7\x05\n\x0eSessionService\x12\xb2\x01\n\nRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"S\x82\xd3\xe4\x93\x02M\"H/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession:\x01*\x12\xc0\x01\n\x10StreamRunSession\x12&.google.cloud.ces.v1.RunSessionRequest\x1a\'.google.cloud.ces.v1.RunSessionResponse\"Y\x82\xd3\xe4\x93\x02S\"N/v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession:\x01*0\x01\x12\xc0\x01\n\x0e\x42idiRunSession\x12-.google.cloud.ces.v1.BidiSessionClientMessage\x1a-.google.cloud.ces.v1.BidiSessionServerMessage\"L\x8a\xd3\xe4\x93\x02\x46\x12\x44\n\x0e\x63onfig.session\x12\x32{session=projects/*/locations/*/apps/*/sessions/*}(\x01\x30\x01\x1aj\xca\x41\x12\x63\x65s.googleapis.com\xd2\x41Rhttps://www.googleapis.com/auth/ces,https://www.googleapis.com/auth/cloud-platformB\xc1\x01\n\x17\x63om.google.cloud.ces.v1B\x13SessionServiceProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespb\xea\x41\x63\n\x1a\x63\x65s.googleapis.com/Session\x12\x45projects/{project}/locations/{location}/apps/{app}/sessions/{session}b\x06proto3"
18
19
 
19
20
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
20
21
  pool.add_serialized_file(descriptor_data)
@@ -599,6 +599,7 @@ module Google
599
599
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
600
600
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
601
601
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
602
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
602
603
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
603
604
  # trigger a retry.
604
605
  # @return [::Hash]
@@ -682,6 +683,7 @@ module Google
682
683
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
683
684
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
684
685
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
686
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
685
687
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
686
688
  # trigger a retry.
687
689
  #
@@ -546,6 +546,7 @@ module Google
546
546
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
547
547
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
548
548
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
549
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
549
550
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
550
551
  # trigger a retry.
551
552
  # @return [::Hash]
@@ -625,6 +626,7 @@ module Google
625
626
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
626
627
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
627
628
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
629
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
628
630
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
629
631
  # trigger a retry.
630
632
  #
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Ces
23
23
  module V1
24
- VERSION = "0.1.0"
24
+ VERSION = "0.2.1"
25
25
  end
26
26
  end
27
27
  end
@@ -391,6 +391,7 @@ module Google
391
391
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
392
392
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
393
393
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
394
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
394
395
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
395
396
  # trigger a retry.
396
397
  # @return [::Hash]
@@ -474,6 +475,7 @@ module Google
474
475
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
475
476
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
476
477
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
478
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
477
479
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
478
480
  # trigger a retry.
479
481
  #
@@ -352,6 +352,7 @@ module Google
352
352
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
353
353
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
354
354
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
355
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
355
356
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
356
357
  # trigger a retry.
357
358
  # @return [::Hash]
@@ -431,6 +432,7 @@ module Google
431
432
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
432
433
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
433
434
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
435
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
434
436
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
435
437
  # trigger a retry.
436
438
  #
@@ -0,0 +1,463 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Specifies the routing information that should be sent along with the request
23
+ # in the form of routing header.
24
+ # **NOTE:** All service configuration rules follow the "last one wins" order.
25
+ #
26
+ # The examples below will apply to an RPC which has the following request type:
27
+ #
28
+ # Message Definition:
29
+ #
30
+ # message Request {
31
+ # // The name of the Table
32
+ # // Values can be of the following formats:
33
+ # // - `projects/<project>/tables/<table>`
34
+ # // - `projects/<project>/instances/<instance>/tables/<table>`
35
+ # // - `region/<region>/zones/<zone>/tables/<table>`
36
+ # string table_name = 1;
37
+ #
38
+ # // This value specifies routing for replication.
39
+ # // It can be in the following formats:
40
+ # // - `profiles/<profile_id>`
41
+ # // - a legacy `profile_id` that can be any string
42
+ # string app_profile_id = 2;
43
+ # }
44
+ #
45
+ # Example message:
46
+ #
47
+ # {
48
+ # table_name: projects/proj_foo/instances/instance_bar/table/table_baz,
49
+ # app_profile_id: profiles/prof_qux
50
+ # }
51
+ #
52
+ # The routing header consists of one or multiple key-value pairs. The order of
53
+ # the key-value pairs is undefined, the order of the `routing_parameters` in
54
+ # the `RoutingRule` only matters for the evaluation order of the path
55
+ # templates when `field` is the same. See the examples below for more details.
56
+ #
57
+ # Every key and value in the routing header must be percent-encoded,
58
+ # and joined together in the following format: `key1=value1&key2=value2`.
59
+ # The examples below skip the percent-encoding for readability.
60
+ #
61
+ # Example 1
62
+ #
63
+ # Extracting a field from the request to put into the routing header
64
+ # unchanged, with the key equal to the field name.
65
+ #
66
+ # annotation:
67
+ #
68
+ # option (google.api.routing) = {
69
+ # // Take the `app_profile_id`.
70
+ # routing_parameters {
71
+ # field: "app_profile_id"
72
+ # }
73
+ # };
74
+ #
75
+ # result:
76
+ #
77
+ # x-goog-request-params: app_profile_id=profiles/prof_qux
78
+ #
79
+ # Example 2
80
+ #
81
+ # Extracting a field from the request to put into the routing header
82
+ # unchanged, with the key different from the field name.
83
+ #
84
+ # annotation:
85
+ #
86
+ # option (google.api.routing) = {
87
+ # // Take the `app_profile_id`, but name it `routing_id` in the header.
88
+ # routing_parameters {
89
+ # field: "app_profile_id"
90
+ # path_template: "{routing_id=**}"
91
+ # }
92
+ # };
93
+ #
94
+ # result:
95
+ #
96
+ # x-goog-request-params: routing_id=profiles/prof_qux
97
+ #
98
+ # Example 3
99
+ #
100
+ # Extracting a field from the request to put into the routing
101
+ # header, while matching a path template syntax on the field's value.
102
+ #
103
+ # NB: it is more useful to send nothing than to send garbage for the purpose
104
+ # of dynamic routing, since garbage pollutes cache. Thus the matching.
105
+ #
106
+ # Sub-example 3a
107
+ #
108
+ # The field matches the template.
109
+ #
110
+ # annotation:
111
+ #
112
+ # option (google.api.routing) = {
113
+ # // Take the `table_name`, if it's well-formed (with project-based
114
+ # // syntax).
115
+ # routing_parameters {
116
+ # field: "table_name"
117
+ # path_template: "{table_name=projects/*/instances/*/**}"
118
+ # }
119
+ # };
120
+ #
121
+ # result:
122
+ #
123
+ # x-goog-request-params:
124
+ # table_name=projects/proj_foo/instances/instance_bar/table/table_baz
125
+ #
126
+ # Sub-example 3b
127
+ #
128
+ # The field does not match the template.
129
+ #
130
+ # annotation:
131
+ #
132
+ # option (google.api.routing) = {
133
+ # // Take the `table_name`, if it's well-formed (with region-based
134
+ # // syntax).
135
+ # routing_parameters {
136
+ # field: "table_name"
137
+ # path_template: "{table_name=regions/*/zones/*/**}"
138
+ # }
139
+ # };
140
+ #
141
+ # result:
142
+ #
143
+ # <no routing header will be sent>
144
+ #
145
+ # Sub-example 3c
146
+ #
147
+ # Multiple alternative conflictingly named path templates are
148
+ # specified. The one that matches is used to construct the header.
149
+ #
150
+ # annotation:
151
+ #
152
+ # option (google.api.routing) = {
153
+ # // Take the `table_name`, if it's well-formed, whether
154
+ # // using the region- or projects-based syntax.
155
+ #
156
+ # routing_parameters {
157
+ # field: "table_name"
158
+ # path_template: "{table_name=regions/*/zones/*/**}"
159
+ # }
160
+ # routing_parameters {
161
+ # field: "table_name"
162
+ # path_template: "{table_name=projects/*/instances/*/**}"
163
+ # }
164
+ # };
165
+ #
166
+ # result:
167
+ #
168
+ # x-goog-request-params:
169
+ # table_name=projects/proj_foo/instances/instance_bar/table/table_baz
170
+ #
171
+ # Example 4
172
+ #
173
+ # Extracting a single routing header key-value pair by matching a
174
+ # template syntax on (a part of) a single request field.
175
+ #
176
+ # annotation:
177
+ #
178
+ # option (google.api.routing) = {
179
+ # // Take just the project id from the `table_name` field.
180
+ # routing_parameters {
181
+ # field: "table_name"
182
+ # path_template: "{routing_id=projects/*}/**"
183
+ # }
184
+ # };
185
+ #
186
+ # result:
187
+ #
188
+ # x-goog-request-params: routing_id=projects/proj_foo
189
+ #
190
+ # Example 5
191
+ #
192
+ # Extracting a single routing header key-value pair by matching
193
+ # several conflictingly named path templates on (parts of) a single request
194
+ # field. The last template to match "wins" the conflict.
195
+ #
196
+ # annotation:
197
+ #
198
+ # option (google.api.routing) = {
199
+ # // If the `table_name` does not have instances information,
200
+ # // take just the project id for routing.
201
+ # // Otherwise take project + instance.
202
+ #
203
+ # routing_parameters {
204
+ # field: "table_name"
205
+ # path_template: "{routing_id=projects/*}/**"
206
+ # }
207
+ # routing_parameters {
208
+ # field: "table_name"
209
+ # path_template: "{routing_id=projects/*/instances/*}/**"
210
+ # }
211
+ # };
212
+ #
213
+ # result:
214
+ #
215
+ # x-goog-request-params:
216
+ # routing_id=projects/proj_foo/instances/instance_bar
217
+ #
218
+ # Example 6
219
+ #
220
+ # Extracting multiple routing header key-value pairs by matching
221
+ # several non-conflicting path templates on (parts of) a single request field.
222
+ #
223
+ # Sub-example 6a
224
+ #
225
+ # Make the templates strict, so that if the `table_name` does not
226
+ # have an instance information, nothing is sent.
227
+ #
228
+ # annotation:
229
+ #
230
+ # option (google.api.routing) = {
231
+ # // The routing code needs two keys instead of one composite
232
+ # // but works only for the tables with the "project-instance" name
233
+ # // syntax.
234
+ #
235
+ # routing_parameters {
236
+ # field: "table_name"
237
+ # path_template: "{project_id=projects/*}/instances/*/**"
238
+ # }
239
+ # routing_parameters {
240
+ # field: "table_name"
241
+ # path_template: "projects/*/{instance_id=instances/*}/**"
242
+ # }
243
+ # };
244
+ #
245
+ # result:
246
+ #
247
+ # x-goog-request-params:
248
+ # project_id=projects/proj_foo&instance_id=instances/instance_bar
249
+ #
250
+ # Sub-example 6b
251
+ #
252
+ # Make the templates loose, so that if the `table_name` does not
253
+ # have an instance information, just the project id part is sent.
254
+ #
255
+ # annotation:
256
+ #
257
+ # option (google.api.routing) = {
258
+ # // The routing code wants two keys instead of one composite
259
+ # // but will work with just the `project_id` for tables without
260
+ # // an instance in the `table_name`.
261
+ #
262
+ # routing_parameters {
263
+ # field: "table_name"
264
+ # path_template: "{project_id=projects/*}/**"
265
+ # }
266
+ # routing_parameters {
267
+ # field: "table_name"
268
+ # path_template: "projects/*/{instance_id=instances/*}/**"
269
+ # }
270
+ # };
271
+ #
272
+ # result (is the same as 6a for our example message because it has the instance
273
+ # information):
274
+ #
275
+ # x-goog-request-params:
276
+ # project_id=projects/proj_foo&instance_id=instances/instance_bar
277
+ #
278
+ # Example 7
279
+ #
280
+ # Extracting multiple routing header key-value pairs by matching
281
+ # several path templates on multiple request fields.
282
+ #
283
+ # NB: note that here there is no way to specify sending nothing if one of the
284
+ # fields does not match its template. E.g. if the `table_name` is in the wrong
285
+ # format, the `project_id` will not be sent, but the `routing_id` will be.
286
+ # The backend routing code has to be aware of that and be prepared to not
287
+ # receive a full complement of keys if it expects multiple.
288
+ #
289
+ # annotation:
290
+ #
291
+ # option (google.api.routing) = {
292
+ # // The routing needs both `project_id` and `routing_id`
293
+ # // (from the `app_profile_id` field) for routing.
294
+ #
295
+ # routing_parameters {
296
+ # field: "table_name"
297
+ # path_template: "{project_id=projects/*}/**"
298
+ # }
299
+ # routing_parameters {
300
+ # field: "app_profile_id"
301
+ # path_template: "{routing_id=**}"
302
+ # }
303
+ # };
304
+ #
305
+ # result:
306
+ #
307
+ # x-goog-request-params:
308
+ # project_id=projects/proj_foo&routing_id=profiles/prof_qux
309
+ #
310
+ # Example 8
311
+ #
312
+ # Extracting a single routing header key-value pair by matching
313
+ # several conflictingly named path templates on several request fields. The
314
+ # last template to match "wins" the conflict.
315
+ #
316
+ # annotation:
317
+ #
318
+ # option (google.api.routing) = {
319
+ # // The `routing_id` can be a project id or a region id depending on
320
+ # // the table name format, but only if the `app_profile_id` is not set.
321
+ # // If `app_profile_id` is set it should be used instead.
322
+ #
323
+ # routing_parameters {
324
+ # field: "table_name"
325
+ # path_template: "{routing_id=projects/*}/**"
326
+ # }
327
+ # routing_parameters {
328
+ # field: "table_name"
329
+ # path_template: "{routing_id=regions/*}/**"
330
+ # }
331
+ # routing_parameters {
332
+ # field: "app_profile_id"
333
+ # path_template: "{routing_id=**}"
334
+ # }
335
+ # };
336
+ #
337
+ # result:
338
+ #
339
+ # x-goog-request-params: routing_id=profiles/prof_qux
340
+ #
341
+ # Example 9
342
+ #
343
+ # Bringing it all together.
344
+ #
345
+ # annotation:
346
+ #
347
+ # option (google.api.routing) = {
348
+ # // For routing both `table_location` and a `routing_id` are needed.
349
+ # //
350
+ # // table_location can be either an instance id or a region+zone id.
351
+ # //
352
+ # // For `routing_id`, take the value of `app_profile_id`
353
+ # // - If it's in the format `profiles/<profile_id>`, send
354
+ # // just the `<profile_id>` part.
355
+ # // - If it's any other literal, send it as is.
356
+ # // If the `app_profile_id` is empty, and the `table_name` starts with
357
+ # // the project_id, send that instead.
358
+ #
359
+ # routing_parameters {
360
+ # field: "table_name"
361
+ # path_template: "projects/*/{table_location=instances/*}/tables/*"
362
+ # }
363
+ # routing_parameters {
364
+ # field: "table_name"
365
+ # path_template: "{table_location=regions/*/zones/*}/tables/*"
366
+ # }
367
+ # routing_parameters {
368
+ # field: "table_name"
369
+ # path_template: "{routing_id=projects/*}/**"
370
+ # }
371
+ # routing_parameters {
372
+ # field: "app_profile_id"
373
+ # path_template: "{routing_id=**}"
374
+ # }
375
+ # routing_parameters {
376
+ # field: "app_profile_id"
377
+ # path_template: "profiles/{routing_id=*}"
378
+ # }
379
+ # };
380
+ #
381
+ # result:
382
+ #
383
+ # x-goog-request-params:
384
+ # table_location=instances/instance_bar&routing_id=prof_qux
385
+ # @!attribute [rw] routing_parameters
386
+ # @return [::Array<::Google::Api::RoutingParameter>]
387
+ # A collection of Routing Parameter specifications.
388
+ # **NOTE:** If multiple Routing Parameters describe the same key
389
+ # (via the `path_template` field or via the `field` field when
390
+ # `path_template` is not provided), "last one wins" rule
391
+ # determines which Parameter gets used.
392
+ # See the examples for more details.
393
+ class RoutingRule
394
+ include ::Google::Protobuf::MessageExts
395
+ extend ::Google::Protobuf::MessageExts::ClassMethods
396
+ end
397
+
398
+ # A projection from an input message to the GRPC or REST header.
399
+ # @!attribute [rw] field
400
+ # @return [::String]
401
+ # A request field to extract the header key-value pair from.
402
+ # @!attribute [rw] path_template
403
+ # @return [::String]
404
+ # A pattern matching the key-value field. Optional.
405
+ # If not specified, the whole field specified in the `field` field will be
406
+ # taken as value, and its name used as key. If specified, it MUST contain
407
+ # exactly one named segment (along with any number of unnamed segments) The
408
+ # pattern will be matched over the field specified in the `field` field, then
409
+ # if the match is successful:
410
+ # - the name of the single named segment will be used as a header name,
411
+ # - the match value of the segment will be used as a header value;
412
+ # if the match is NOT successful, nothing will be sent.
413
+ #
414
+ # Example:
415
+ #
416
+ # -- This is a field in the request message
417
+ # | that the header value will be extracted from.
418
+ # |
419
+ # | -- This is the key name in the
420
+ # | | routing header.
421
+ # V |
422
+ # field: "table_name" v
423
+ # path_template: "projects/*/{table_location=instances/*}/tables/*"
424
+ # ^ ^
425
+ # | |
426
+ # In the {} brackets is the pattern that -- |
427
+ # specifies what to extract from the |
428
+ # field as a value to be sent. |
429
+ # |
430
+ # The string in the field must match the whole pattern --
431
+ # before brackets, inside brackets, after brackets.
432
+ #
433
+ # When looking at this specific example, we can see that:
434
+ # - A key-value pair with the key `table_location`
435
+ # and the value matching `instances/*` should be added
436
+ # to the x-goog-request-params routing header.
437
+ # - The value is extracted from the request message's `table_name` field
438
+ # if it matches the full pattern specified:
439
+ # `projects/*/instances/*/tables/*`.
440
+ #
441
+ # **NB:** If the `path_template` field is not provided, the key name is
442
+ # equal to the field name, and the whole field should be sent as a value.
443
+ # This makes the pattern for the field and the value functionally equivalent
444
+ # to `**`, and the configuration
445
+ #
446
+ # {
447
+ # field: "table_name"
448
+ # }
449
+ #
450
+ # is a functionally equivalent shorthand to:
451
+ #
452
+ # {
453
+ # field: "table_name"
454
+ # path_template: "{table_name=**}"
455
+ # }
456
+ #
457
+ # See Example 1 for more details.
458
+ class RoutingParameter
459
+ include ::Google::Protobuf::MessageExts
460
+ extend ::Google::Protobuf::MessageExts::ClassMethods
461
+ end
462
+ end
463
+ end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-ces-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -15,14 +15,14 @@ dependencies:
15
15
  requirements:
16
16
  - - "~>"
17
17
  - !ruby/object:Gem::Version
18
- version: '1.2'
18
+ version: '1.3'
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - "~>"
24
24
  - !ruby/object:Gem::Version
25
- version: '1.2'
25
+ version: '1.3'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement
@@ -148,6 +148,7 @@ files:
148
148
  - proto_docs/google/api/field_behavior.rb
149
149
  - proto_docs/google/api/launch_stage.rb
150
150
  - proto_docs/google/api/resource.rb
151
+ - proto_docs/google/api/routing.rb
151
152
  - proto_docs/google/cloud/ces/v1/agent.rb
152
153
  - proto_docs/google/cloud/ces/v1/agent_service.rb
153
154
  - proto_docs/google/cloud/ces/v1/agent_tool.rb