feat: update gRPC schemas for Stackdriver (#208)

gruebel · web-flow · commit 7999eb5b3581 · 2025-03-21T17:41:42.000-07:00
diff --git a/opentelemetry-stackdriver/CHANGELOG.md b/opentelemetry-stackdriver/CHANGELOG.md
@@ -2,6 +2,8 @@
 
 ## vNext
 
+- Update gRPC schemas
+
 ### Changed
 
 ## v0.25.0
diff --git a/opentelemetry-stackdriver/proto/google/api/annotations.proto b/opentelemetry-stackdriver/proto/google/api/annotations.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/api/client.proto b/opentelemetry-stackdriver/proto/google/api/client.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -281,6 +281,12 @@ message PythonSettings {
     // enabled by default 1 month after launching the feature in preview
     // packages.
     bool protobuf_pythonic_types_enabled = 2;
+
+    // Disables generation of an unversioned Python package for this client
+    // library. This means that the module names will need to be versioned in
+    // import statements. For example `import google.cloud.library_v2` instead
+    // of `import google.cloud.library`.
+    bool unversioned_package_disabled = 3;
   }
 
   // Some settings.
@@ -342,6 +348,16 @@ message RubySettings {
 message GoSettings {
   // Some settings.
   CommonLanguageSettings common = 1;
+
+  // Map of service names to renamed services. Keys are the package relative
+  // service names and values are the name to be used for the service client
+  // and call options.
+  //
+  // publishing:
+  //   go_settings:
+  //     renamed_services:
+  //       Publisher: TopicAdmin
+  map<string, string> renamed_services = 2;
 }
 
 // Describes the generator configuration for a method.
@@ -459,4 +475,12 @@ message SelectiveGapicGeneration {
   // An allowlist of the fully qualified names of RPCs that should be included
   // on public client surfaces.
   repeated string methods = 1;
+
+  // Setting this to true indicates to the client generators that methods
+  // that would be excluded from the generation should instead be generated
+  // in a way that indicates these methods should not be consumed by
+  // end users. How this is expressed is up to individual language
+  // implementations to decide. Some examples may be: added annotations,
+  // obfuscated identifiers, or other language idiomatic patterns.
+  bool generate_omitted_as_internal = 2;
 }
diff --git a/opentelemetry-stackdriver/proto/google/api/field_behavior.proto b/opentelemetry-stackdriver/proto/google/api/field_behavior.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/api/http.proto b/opentelemetry-stackdriver/proto/google/api/http.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.api;
 
-option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/api/annotations;annotations";
 option java_multiple_files = true;
 option java_outer_classname = "HttpProto";
diff --git a/opentelemetry-stackdriver/proto/google/api/label.proto b/opentelemetry-stackdriver/proto/google/api/label.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.api;
 
-option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/api/label;label";
 option java_multiple_files = true;
 option java_outer_classname = "LabelProto";
diff --git a/opentelemetry-stackdriver/proto/google/api/launch_stage.proto b/opentelemetry-stackdriver/proto/google/api/launch_stage.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/api/monitored_resource.proto b/opentelemetry-stackdriver/proto/google/api/monitored_resource.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -20,7 +20,6 @@ import "google/api/label.proto";
 import "google/api/launch_stage.proto";
 import "google/protobuf/struct.proto";
 
-option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/api/monitoredres;monitoredres";
 option java_multiple_files = true;
 option java_outer_classname = "MonitoredResourceProto";
diff --git a/opentelemetry-stackdriver/proto/google/api/resource.proto b/opentelemetry-stackdriver/proto/google/api/resource.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.api;
 
 import "google/protobuf/descriptor.proto";
 
-option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/api/annotations;annotations";
 option java_multiple_files = true;
 option java_outer_classname = "ResourceProto";
diff --git a/opentelemetry-stackdriver/proto/google/devtools/cloudtrace/v2/trace.proto b/opentelemetry-stackdriver/proto/google/devtools/cloudtrace/v2/trace.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/devtools/cloudtrace/v2/tracing.proto b/opentelemetry-stackdriver/proto/google/devtools/cloudtrace/v2/tracing.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/logging/type/http_request.proto b/opentelemetry-stackdriver/proto/google/logging/type/http_request.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/logging/type/log_severity.proto b/opentelemetry-stackdriver/proto/google/logging/type/log_severity.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/logging/v2/log_entry.proto b/opentelemetry-stackdriver/proto/google/logging/v2/log_entry.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/logging/v2/logging.proto b/opentelemetry-stackdriver/proto/google/logging/v2/logging.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/logging/v2/logging_config.proto b/opentelemetry-stackdriver/proto/google/logging/v2/logging_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/proto/google/rpc/status.proto b/opentelemetry-stackdriver/proto/google/rpc/status.proto
@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/opentelemetry-stackdriver/src/proto/api.rs b/opentelemetry-stackdriver/src/proto/api.rs
@@ -618,6 +618,12 @@ pub mod python_settings {
         /// packages.
         #[prost(bool, tag = "2")]
         pub protobuf_pythonic_types_enabled: bool,
+        /// Disables generation of an unversioned Python package for this client
+        /// library. This means that the module names will need to be versioned in
+        /// import statements. For example `import google.cloud.library_v2` instead
+        /// of `import google.cloud.library`.
+        #[prost(bool, tag = "3")]
+        pub unversioned_package_disabled: bool,
     }
 }
 /// Settings for Node client libraries.
@@ -679,6 +685,17 @@ pub struct GoSettings {
     /// Some settings.
     #[prost(message, optional, tag = "1")]
     pub common: ::core::option::Option<CommonLanguageSettings>,
+    /// Map of service names to renamed services. Keys are the package relative
+    /// service names and values are the name to be used for the service client
+    /// and call options.
+    ///
+    /// publishing:
+    ///    go_settings:
+    ///      renamed_services:
+    ///        Publisher: TopicAdmin
+    #[prost(map = "string, string", tag = "2")]
+    pub renamed_services:
+        ::std::collections::HashMap<::prost::alloc::string::String, ::prost::alloc::string::String>,
 }
 /// Describes the generator configuration for a method.
 #[derive(Clone, PartialEq, ::prost::Message)]
@@ -760,6 +777,14 @@ pub struct SelectiveGapicGeneration {
     /// on public client surfaces.
     #[prost(string, repeated, tag = "1")]
     pub methods: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+    /// Setting this to true indicates to the client generators that methods
+    /// that would be excluded from the generation should instead be generated
+    /// in a way that indicates these methods should not be consumed by
+    /// end users. How this is expressed is up to individual language
+    /// implementations to decide. Some examples may be: added annotations,
+    /// obfuscated identifiers, or other language idiomatic patterns.
+    #[prost(bool, tag = "2")]
+    pub generate_omitted_as_internal: bool,
 }
 /// The organization for which the client libraries are being published.
 /// Affects the url where generated docs are published, etc.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Copyright 2024 Google LLC`
	`1`	`+// Copyright 2025 Google LLC`
`2`	`2`	`//`
`3`	`3`	`// Licensed under the Apache License, Version 2.0 (the "License");`
`4`	`4`	`// you may not use this file except in compliance with the License.`