opentelemetry-stackdriver: Update Stackdriver schema

opentelemetry-stackdriver/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## vNext
 
+- Bump proto versions adds documentation and versioning fields [#61]
 - Bump yup-oauth2 to 8.3.3 [#58](https://github.com/open-telemetry/opentelemetry-rust-contrib/pull/58)
 - Bump hyper-rustls to 0.25 [#58](https://github.com/open-telemetry/opentelemetry-rust-contrib/pull/58)
 

opentelemetry-stackdriver/proto/google/api/client.proto

@@ -98,6 +98,22 @@ extend google.protobuf.ServiceOptions {
   //     ...
   //   }
   string oauth_scopes = 1050;
+
+  // The API version of this service, which should be sent by version-aware
+  // clients to the service. This allows services to abide by the schema and
+  // behavior of the service at the time this API version was deployed.
+  // The format of the API version must be treated as opaque by clients.
+  // Services may use a format with an apparent structure, but clients must
+  // not rely on this to determine components within an API version, or attempt
+  // to construct other valid API versions. Note that this is for upcoming
+  // functionality and may not be implemented for all services.
+  //
+  // Example:
+  //
+  //   service Foo {
+  //     option (google.api.api_version) = "v1_20230821_preview";
+  //   }
+  string api_version = 525000001;
 }
 
 // Required information for every language.
@@ -192,6 +208,10 @@ message Publishing {
   // Optional link to proto reference documentation.  Example:
   // https://cloud.google.com/pubsub/lite/docs/reference/rpc
   string proto_reference_documentation_uri = 110;
+
+  // Optional link to REST reference documentation.  Example:
+  // https://cloud.google.com/pubsub/lite/docs/reference/rest
+  string rest_reference_documentation_uri = 111;
 }
 
 // Settings for Java client libraries.

opentelemetry-stackdriver/proto/google/api/monitored_resource.proto

@@ -49,7 +49,7 @@ message MonitoredResourceDescriptor {
 
   // Required. The monitored resource type. For example, the type
   // `"cloudsql_database"` represents databases in Google Cloud SQL.
-  //  For a list of types, see [Monitoring resource
+  //  For a list of types, see [Monitored resource
   //  types](https://cloud.google.com/monitoring/api/resources)
   // and [Logging resource
   // types](https://cloud.google.com/logging/docs/api/v2/resource-list).

opentelemetry-stackdriver/src/proto/api.rs

@@ -545,6 +545,10 @@ pub struct Publishing {
     /// <https://cloud.google.com/pubsub/lite/docs/reference/rpc>
     #[prost(string, tag = "110")]
     pub proto_reference_documentation_uri: ::prost::alloc::string::String,
+    /// Optional link to REST reference documentation.  Example:
+    /// <https://cloud.google.com/pubsub/lite/docs/reference/rest>
+    #[prost(string, tag = "111")]
+    pub rest_reference_documentation_uri: ::prost::alloc::string::String,
 }
 /// Settings for Java client libraries.
 #[allow(clippy::derive_partial_eq_without_eq)]
@@ -1237,7 +1241,7 @@ pub struct MonitoredResourceDescriptor {
     pub name: ::prost::alloc::string::String,
     /// Required. The monitored resource type. For example, the type
     /// `"cloudsql_database"` represents databases in Google Cloud SQL.
-    ///   For a list of types, see [Monitoring resource
+    ///   For a list of types, see [Monitored resource
     ///   types](<https://cloud.google.com/monitoring/api/resources>)
     /// and [Logging resource
     /// types](<https://cloud.google.com/logging/docs/api/v2/resource-list>).