@devvit/protos 0.11.17-next-2025-05-29-91b3cf49f.0 → 0.11.17-next-2025-05-29-de9726085.0

package/schema/.snootobuf/deps/google/api/quota.proto

@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2024 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,19 +16,16 @@ syntax = "proto3";
 
 package google.api;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig";
 option java_multiple_files = true;
 option java_outer_classname = "QuotaProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-
 // Quota configuration helps to achieve fairness and budgeting in service
 // usage.
 //
-// The quota configuration works this way:
+// The metric based quota configuration works this way:
 // - The service configuration defines a set of metrics.
 // - For API calls, the quota.metric_rules maps methods to metrics with
 //   corresponding costs.
@@ -46,10 +43,11 @@ option objc_class_prefix = "GAPI";
 //        values:
 //          STANDARD: 10000
 //
-//      # The metric rules bind all methods to the read_calls metric,
-//      # except for the UpdateBook and DeleteBook methods. These two methods
-//      # are mapped to the write_calls metric, with the UpdateBook method
-//      # consuming at twice rate as the DeleteBook method.
+//
+//      (The metric rules bind all methods to the read_calls metric,
+//       except for the UpdateBook and DeleteBook methods. These two methods
+//       are mapped to the write_calls metric, with the UpdateBook method
+//       consuming at twice rate as the DeleteBook method.)
 //      metric_rules:
 //      - selector: "*"
 //        metric_costs:
@@ -74,28 +72,23 @@ option objc_class_prefix = "GAPI";
 //        metric_kind: DELTA
 //        value_type: INT64
 //
+//
 message Quota {
-  // List of `QuotaLimit` definitions for the service.
-  //
-  // Used by metric-based quotas only.
+  // List of QuotaLimit definitions for the service.
   repeated QuotaLimit limits = 3;
 
-  // List of `MetricRule` definitions, each one mapping a selected method to one
+  // List of MetricRule definitions, each one mapping a selected method to one
   // or more metrics.
-  //
-  // Used by metric-based quotas only.
   repeated MetricRule metric_rules = 4;
 }
 
 // Bind API methods to metrics. Binding a method to a metric causes that
-// metric's configured quota, billing, and monitoring behaviors to apply to the
-// method call.
-//
-// Used by metric-based quotas only.
+// metric's configured quota behaviors to apply to the method call.
 message MetricRule {
   // Selects the methods to which this rule applies.
   //
-  // Refer to [selector][google.api.DocumentationRule.selector] for syntax details.
+  // Refer to [selector][google.api.DocumentationRule.selector] for syntax
+  // details.
   string selector = 1;
 
   // Metrics to update when the selected methods are called, and the associated
@@ -111,24 +104,12 @@ message MetricRule {
 // for a limit type. There can be at most one limit for a duration and limit
 // type combination defined within a `QuotaGroup`.
 message QuotaLimit {
-  // Name of the quota limit. The name is used to refer to the limit when
-  // overriding the default limit on per-consumer basis.
-  //
-  // For group-based quota limits, the name must be unique within the quota
-  // group. If a name is not provided, it will be generated from the limit_by
-  // and duration fields.
+  // Name of the quota limit.
   //
-  // For metric-based quota limits, the name must be provided, and it must be
-  // unique within the service. The name can only include alphanumeric
-  // characters as well as '-'.
+  // The name must be provided, and it must be unique within the service. The
+  // name can only include alphanumeric characters as well as '-'.
   //
   // The maximum length of the limit name is 64 characters.
-  //
-  // The name of a limit is used as a unique identifier for this limit.
-  // Therefore, once a limit has been put into use, its name should be
-  // immutable. You can use the display_name field to provide a user-friendly
-  // name for the limit. The display name can be evolved over time without
-  // affecting the identity of the limit.
   string name = 6;
 
   // Optional. User-visible, extended description for this quota limit.
@@ -169,10 +150,7 @@ message QuotaLimit {
   // Used by group-based quotas only.
   int64 free_tier = 7;
 
-  // Duration of this limit in textual notation. Example: "100s", "24h", "1d".
-  // For duration longer than a day, only multiple of days is supported. We
-  // support only "100s" and "1d" for now. Additional support will be added in
-  // the future. "0" indicates indefinite duration.
+  // Duration of this limit in textual notation. Must be "100s" or "1d".
   //
   // Used by group-based quotas only.
   string duration = 5;
@@ -180,75 +158,22 @@ message QuotaLimit {
   // The name of the metric this quota limit applies to. The quota limits with
   // the same metric will be checked together during runtime. The metric must be
   // defined within the service config.
-  //
-  // Used by metric-based quotas only.
   string metric = 8;
 
   // Specify the unit of the quota limit. It uses the same syntax as
   // [Metric.unit][]. The supported unit kinds are determined by the quota
   // backend system.
   //
-  // The [Google Service Control](https://cloud.google.com/service-control)
-  // supports the following unit components:
-  // * One of the time intevals:
-  //   * "/min"  for quota every minute.
-  //   * "/d"  for quota every 24 hours, starting 00:00 US Pacific Time.
-  //   * Otherwise the quota won't be reset by time, such as storage limit.
-  // * One and only one of the granted containers:
-  //   * "/{organization}" quota for an organization.
-  //   * "/{project}" quota for a project.
-  //   * "/{folder}" quota for a folder.
-  //   * "/{resource}" quota for a universal resource.
-  // * Zero or more quota segmentation dimension. Not all combos are valid.
-  //   * "/{region}" quota for every region. Not to be used with time intervals.
-  //   * Otherwise the resources granted on the target is not segmented.
-  //   * "/{zone}" quota for every zone. Not to be used with time intervals.
-  //   * Otherwise the resources granted on the target is not segmented.
-  //   * "/{resource}" quota for a resource associated with a project or org.
-  //
   // Here are some examples:
   // * "1/min/{project}" for quota per minute per project.
-  // * "1/min/{user}" for quota per minute per user.
-  // * "1/min/{organization}" for quota per minute per organization.
   //
   // Note: the order of unit components is insignificant.
   // The "1" at the beginning is required to follow the metric unit syntax.
-  //
-  // Used by metric-based quotas only.
   string unit = 9;
 
-  // Tiered limit values. Also allows for regional or zone overrides for these
-  // values if "/{region}" or "/{zone}" is specified in the unit field.
-  //
-  // Currently supported tiers from low to high:
-  // VERY_LOW, LOW, STANDARD, HIGH, VERY_HIGH
-  //
-  // To apply different limit values for users according to their tiers, specify
-  // the values for the tiers you want to differentiate. For example:
-  // {LOW:100, STANDARD:500, HIGH:1000, VERY_HIGH:5000}
-  //
-  // The limit value for each tier is optional except for the tier STANDARD.
-  // The limit value for an unspecified tier falls to the value of its next
-  // tier towards tier STANDARD. For the above example, the limit value for tier
-  // STANDARD is 500.
-  //
-  // To apply the same limit value for all users, just specify limit value for
-  // tier STANDARD. For example: {STANDARD:500}.
-  //
-  // To apply a regional overide for a tier, add a map entry with key
-  // "<TIER>/<region>", where <region> is a region name. Similarly, for a zone
-  // override, add a map entry with key "<TIER>/{zone}".
-  // Further, a wildcard can be used at the end of a zone name in order to
-  // specify zone level overrides. For example:
-  // LOW: 10, STANDARD: 50, HIGH: 100,
-  // LOW/us-central1: 20, STANDARD/us-central1: 60, HIGH/us-central1: 200,
-  // LOW/us-central1-*: 10, STANDARD/us-central1-*: 20, HIGH/us-central1-*: 80
-  //
-  // The regional overrides tier set for each region must be the same as
-  // the tier set for default limit values. Same rule applies for zone overrides
-  // tier as well.
-  //
-  // Used by metric-based quotas only.
+  // Tiered limit values. You must specify this as a key:value pair, with an
+  // integer value that is the maximum number of requests allowed for the
+  // specified unit. Currently only STANDARD is supported.
   map<string, int64> values = 10;
 
   // User-visible display name for this limit.

package/schema/.snootobuf/deps/google/api/resource.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -57,11 +57,7 @@ extend google.protobuf.MessageOptions {
 //       // For Kubernetes resources, the format is {api group}/{kind}.
 //       option (google.api.resource) = {
 //         type: "pubsub.googleapis.com/Topic"
-//         name_descriptor: {
-//           pattern: "projects/{project}/topics/{topic}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         }
+//         pattern: "projects/{project}/topics/{topic}"
 //       };
 //     }
 //
@@ -69,10 +65,7 @@ extend google.protobuf.MessageOptions {
 //
 //     resources:
 //     - type: "pubsub.googleapis.com/Topic"
-//       name_descriptor:
-//         - pattern: "projects/{project}/topics/{topic}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
+//       pattern: "projects/{project}/topics/{topic}"
 //
 // Sometimes, resources have multiple patterns, typically because they can
 // live under multiple parents.
@@ -82,26 +75,10 @@ extend google.protobuf.MessageOptions {
 //     message LogEntry {
 //       option (google.api.resource) = {
 //         type: "logging.googleapis.com/LogEntry"
-//         name_descriptor: {
-//           pattern: "projects/{project}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         }
-//         name_descriptor: {
-//           pattern: "folders/{folder}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//           parent_name_extractor: "folders/{folder}"
-//         }
-//         name_descriptor: {
-//           pattern: "organizations/{organization}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-//           parent_name_extractor: "organizations/{organization}"
-//         }
-//         name_descriptor: {
-//           pattern: "billingAccounts/{billing_account}/logs/{log}"
-//           parent_type: "billing.googleapis.com/BillingAccount"
-//           parent_name_extractor: "billingAccounts/{billing_account}"
-//         }
+//         pattern: "projects/{project}/logs/{log}"
+//         pattern: "folders/{folder}/logs/{log}"
+//         pattern: "organizations/{organization}/logs/{log}"
+//         pattern: "billingAccounts/{billing_account}/logs/{log}"
 //       };
 //     }
 //
@@ -109,48 +86,10 @@ extend google.protobuf.MessageOptions {
 //
 //     resources:
 //     - type: 'logging.googleapis.com/LogEntry'
-//       name_descriptor:
-//         - pattern: "projects/{project}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//           parent_name_extractor: "projects/{project}"
-//         - pattern: "folders/{folder}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//           parent_name_extractor: "folders/{folder}"
-//         - pattern: "organizations/{organization}/logs/{log}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-//           parent_name_extractor: "organizations/{organization}"
-//         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-//           parent_type: "billing.googleapis.com/BillingAccount"
-//           parent_name_extractor: "billingAccounts/{billing_account}"
-//
-// For flexible resources, the resource name doesn't contain parent names, but
-// the resource itself has parents for policy evaluation.
-//
-// Example:
-//
-//     message Shelf {
-//       option (google.api.resource) = {
-//         type: "library.googleapis.com/Shelf"
-//         name_descriptor: {
-//           pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//         }
-//         name_descriptor: {
-//           pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-//         }
-//       };
-//     }
-//
-// The ResourceDescriptor Yaml config will look like:
-//
-//     resources:
-//     - type: 'library.googleapis.com/Shelf'
-//       name_descriptor:
-//         - pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Project"
-//         - pattern: "shelves/{shelf}"
-//           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+//       pattern: "projects/{project}/logs/{log}"
+//       pattern: "folders/{folder}/logs/{log}"
+//       pattern: "organizations/{organization}/logs/{log}"
+//       pattern: "billingAccounts/{billing_account}/logs/{log}"
 message ResourceDescriptor {
   // A description of the historical or future-looking state of the
   // resource pattern.
@@ -240,8 +179,13 @@ message ResourceDescriptor {
 
   // The plural name used in the resource name and permission names, such as
   // 'projects' for the resource name of 'projects/{project}' and the permission
-  // name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-  // concept of the `plural` field in k8s CRD spec
+  // name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+  // to this is for Nested Collections that have stuttering names, as defined
+  // in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+  // collection ID in the resource name pattern does not necessarily directly
+  // match the `plural` value.
+  //
+  // It is the same concept of the `plural` field in k8s CRD spec
   // https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
   //
   // Note: The plural form is required even for singleton resources. See

package/schema/.snootobuf/deps/google/api/routing.proto

@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/schema/.snootobuf/deps/google/api/service.proto

@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2024 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,10 +16,10 @@ syntax = "proto3";
 
 package google.api;
 
-import "google/api/annotations.proto";
 import "google/api/auth.proto";
 import "google/api/backend.proto";
 import "google/api/billing.proto";
+import "google/api/client.proto";
 import "google/api/context.proto";
 import "google/api/control.proto";
 import "google/api/documentation.proto";
@@ -44,21 +44,30 @@ option java_outer_classname = "ServiceProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-
-// `Service` is the root object of Google service configuration schema. It
-// describes basic information about a service, such as the name and the
-// title, and delegates other aspects to sub-sections. Each sub-section is
-// either a proto message or a repeated proto message that configures a
-// specific aspect, such as auth. See each proto message definition for details.
+// `Service` is the root object of Google API service configuration (service
+// config). It describes the basic information about a logical service,
+// such as the service name and the user-facing title, and delegates other
+// aspects to sub-sections. Each sub-section is either a proto message or a
+// repeated proto message that configures a specific aspect, such as auth.
+// For more information, see each proto message definition.
 //
 // Example:
 //
 //     type: google.api.Service
-//     config_version: 3
 //     name: calendar.googleapis.com
 //     title: Google Calendar API
 //     apis:
 //     - name: google.calendar.v3.Calendar
+//
+//     visibility:
+//       rules:
+//       - selector: "google.calendar.v3.*"
+//         restriction: PREVIEW
+//     backend:
+//       rules:
+//       - selector: "google.calendar.v3.*"
+//         address: calendar.example.com
+//
 //     authentication:
 //       providers:
 //       - id: google_calendar_auth
@@ -69,48 +78,46 @@ option objc_class_prefix = "GAPI";
 //         requirements:
 //           provider_id: google_calendar_auth
 message Service {
-  // The semantic version of the service configuration. The config version
-  // affects the interpretation of the service configuration. For example,
-  // certain features are enabled by default for certain config versions.
-  // The latest config version is `3`.
-  google.protobuf.UInt32Value config_version = 20;
-
-  // The DNS address at which this service is available,
-  // e.g. `calendar.googleapis.com`.
+  // The service name, which is a DNS-like logical identifier for the
+  // service, such as `calendar.googleapis.com`. The service name
+  // typically goes through DNS verification to make sure the owner
+  // of the service also owns the DNS name.
   string name = 1;
 
-  // A unique ID for a specific instance of this message, typically assigned
-  // by the client for tracking purpose. If empty, the server may choose to
-  // generate one instead.
-  string id = 33;
-
-  // The product title for this service.
+  // The product title for this service, it is the name displayed in Google
+  // Cloud Console.
   string title = 2;
 
   // The Google project that owns this service.
   string producer_project_id = 22;
 
+  // A unique ID for a specific instance of this message, typically assigned
+  // by the client for tracking purpose. Must be no longer than 63 characters
+  // and only lower case letters, digits, '.', '_' and '-' are allowed. If
+  // empty, the server may choose to generate one instead.
+  string id = 33;
+
   // A list of API interfaces exported by this service. Only the `name` field
-  // of the [google.protobuf.Api][google.protobuf.Api] needs to be provided by the configuration
-  // author, as the remaining fields will be derived from the IDL during the
-  // normalization process. It is an error to specify an API interface here
-  // which cannot be resolved against the associated IDL files.
+  // of the [google.protobuf.Api][google.protobuf.Api] needs to be provided by
+  // the configuration author, as the remaining fields will be derived from the
+  // IDL during the normalization process. It is an error to specify an API
+  // interface here which cannot be resolved against the associated IDL files.
   repeated google.protobuf.Api apis = 3;
 
   // A list of all proto message types included in this API service.
-  // Types referenced directly or indirectly by the `apis` are
-  // automatically included.  Messages which are not referenced but
-  // shall be included, such as types used by the `google.protobuf.Any` type,
-  // should be listed here by name. Example:
+  // Types referenced directly or indirectly by the `apis` are automatically
+  // included.  Messages which are not referenced but shall be included, such as
+  // types used by the `google.protobuf.Any` type, should be listed here by
+  // name by the configuration author. Example:
   //
   //     types:
   //     - name: google.protobuf.Int32
   repeated google.protobuf.Type types = 4;
 
-  // A list of all enum types included in this API service.  Enums
-  // referenced directly or indirectly by the `apis` are automatically
-  // included.  Enums which are not referenced but shall be included
-  // should be listed here by name. Example:
+  // A list of all enum types included in this API service.  Enums referenced
+  // directly or indirectly by the `apis` are automatically included.  Enums
+  // which are not referenced but shall be included should be listed here by
+  // name by the configuration author. Example:
   //
   //     enums:
   //     - name: google.someapi.v1.SomeEnum
@@ -152,7 +159,8 @@ message Service {
   repeated MetricDescriptor metrics = 24;
 
   // Defines the monitored resources used by this service. This is required
-  // by the [Service.monitoring][google.api.Service.monitoring] and [Service.logging][google.api.Service.logging] configurations.
+  // by the [Service.monitoring][google.api.Service.monitoring] and
+  // [Service.logging][google.api.Service.logging] configurations.
   repeated MonitoredResourceDescriptor monitored_resources = 25;
 
   // Billing configuration.
@@ -170,6 +178,14 @@ message Service {
   // Output only. The source information for this configuration if available.
   SourceInfo source_info = 37;
 
-  // Experimental configuration.
-  reserved 101;
+  // Settings for [Google Cloud Client
+  // libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
+  // generated from APIs defined as protocol buffers.
+  Publishing publishing = 45;
+
+  // Obsolete. Do not use.
+  //
+  // This field has no semantic meaning. The service config compiler always
+  // sets this field to `3`.
+  google.protobuf.UInt32Value config_version = 20;
 }

package/schema/.snootobuf/deps/google/api/source_info.proto

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -24,7 +24,6 @@ option java_outer_classname = "SourceInfoProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-
 // Source information used to create a Service Config
 message SourceInfo {
   // All files used during config generation.

package/schema/.snootobuf/deps/google/api/system_parameter.proto

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -22,7 +22,6 @@ option java_outer_classname = "SystemParameterProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-
 // ### System parameter configuration
 //
 // A system parameter is a special kind of parameter defined by the API
@@ -68,7 +67,8 @@ message SystemParameterRule {
   // Selects the methods to which this rule applies. Use '*' to indicate all
   // methods in all APIs.
   //
-  // Refer to [selector][google.api.DocumentationRule.selector] for syntax details.
+  // Refer to [selector][google.api.DocumentationRule.selector] for syntax
+  // details.
   string selector = 1;
 
   // Define parameters. Multiple names may be defined for a parameter.

package/schema/.snootobuf/deps/google/api/usage.proto

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2024 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,20 +16,23 @@ syntax = "proto3";
 
 package google.api;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig";
 option java_multiple_files = true;
 option java_outer_classname = "UsageProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-
 // Configuration controlling usage of a service.
 message Usage {
   // Requirements that must be satisfied before a consumer project can use the
   // service. Each requirement is of the form <service.name>/<requirement-id>;
   // for example 'serviceusage.googleapis.com/billing-enabled'.
+  //
+  // For Google APIs, a Terms of Service requirement must be included here.
+  // Google Cloud APIs must include "serviceusage.googleapis.com/tos/cloud".
+  // Other Google APIs should include
+  // "serviceusage.googleapis.com/tos/universal". Additional ToS can be
+  // included based on the business needs.
   repeated string requirements = 1;
 
   // A list of usage rules that apply to individual API methods.
@@ -77,7 +80,8 @@ message UsageRule {
   // Selects the methods to which this rule applies. Use '*' to indicate all
   // methods in all APIs.
   //
-  // Refer to [selector][google.api.DocumentationRule.selector] for syntax details.
+  // Refer to [selector][google.api.DocumentationRule.selector] for syntax
+  // details.
   string selector = 1;
 
   // If true, the selected method allows unregistered calls, e.g. calls