@devvit/protos 0.11.17-next-2025-05-28-417d95f5a.0 → 0.11.17-next-2025-05-29-91b3cf49f.0

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2017 Google Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,16 +16,19 @@ 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 metric based quota configuration works this way:
+// The 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.
@@ -43,11 +46,10 @@ 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:
@@ -72,23 +74,28 @@ option objc_class_prefix = "GAPI";
 //        metric_kind: DELTA
 //        value_type: INT64
 //
-//
 message Quota {
-  // List of QuotaLimit definitions for the service.
+  // List of `QuotaLimit` definitions for the service.
+  //
+  // Used by metric-based quotas only.
   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 behaviors to apply to the method call.
+// metric's configured quota, billing, and monitoring behaviors to apply to the
+// method call.
+//
+// Used by metric-based quotas only.
 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
@@ -104,12 +111,24 @@ 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.
+  // 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.
   //
-  // The name must be provided, and it must be unique within the service. The
-  // name can only include alphanumeric characters as well as '-'.
+  // 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 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.
@@ -150,7 +169,10 @@ message QuotaLimit {
   // Used by group-based quotas only.
   int64 free_tier = 7;
 
-  // Duration of this limit in textual notation. Must be "100s" or "1d".
+  // 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.
   //
   // Used by group-based quotas only.
   string duration = 5;
@@ -158,22 +180,75 @@ 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. 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.
+  // 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.
   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 2024 Google LLC
+// Copyright 2020 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,7 +57,11 @@ extend google.protobuf.MessageOptions {
 //       // For Kubernetes resources, the format is {api group}/{kind}.
 //       option (google.api.resource) = {
 //         type: "pubsub.googleapis.com/Topic"
-//         pattern: "projects/{project}/topics/{topic}"
+//         name_descriptor: {
+//           pattern: "projects/{project}/topics/{topic}"
+//           parent_type: "cloudresourcemanager.googleapis.com/Project"
+//           parent_name_extractor: "projects/{project}"
+//         }
 //       };
 //     }
 //
@@ -65,7 +69,10 @@ extend google.protobuf.MessageOptions {
 //
 //     resources:
 //     - type: "pubsub.googleapis.com/Topic"
-//       pattern: "projects/{project}/topics/{topic}"
+//       name_descriptor:
+//         - pattern: "projects/{project}/topics/{topic}"
+//           parent_type: "cloudresourcemanager.googleapis.com/Project"
+//           parent_name_extractor: "projects/{project}"
 //
 // Sometimes, resources have multiple patterns, typically because they can
 // live under multiple parents.
@@ -75,10 +82,26 @@ extend google.protobuf.MessageOptions {
 //     message LogEntry {
 //       option (google.api.resource) = {
 //         type: "logging.googleapis.com/LogEntry"
-//         pattern: "projects/{project}/logs/{log}"
-//         pattern: "folders/{folder}/logs/{log}"
-//         pattern: "organizations/{organization}/logs/{log}"
-//         pattern: "billingAccounts/{billing_account}/logs/{log}"
+//         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}"
+//         }
 //       };
 //     }
 //
@@ -86,10 +109,48 @@ extend google.protobuf.MessageOptions {
 //
 //     resources:
 //     - type: 'logging.googleapis.com/LogEntry'
-//       pattern: "projects/{project}/logs/{log}"
-//       pattern: "folders/{folder}/logs/{log}"
-//       pattern: "organizations/{organization}/logs/{log}"
-//       pattern: "billingAccounts/{billing_account}/logs/{log}"
+//       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"
 message ResourceDescriptor {
   // A description of the historical or future-looking state of the
   // resource pattern.
@@ -179,13 +240,8 @@ 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'. 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
+  // name of 'cloudresourcemanager.googleapis.com/projects.get'. 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 2024 Google LLC
+// Copyright 2021 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 2024 Google LLC
+// Copyright 2017 Google Inc.
 //
 // 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,30 +44,21 @@ option java_outer_classname = "ServiceProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-// `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.
+
+// `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.
 //
 // 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
@@ -78,46 +69,48 @@ option objc_class_prefix = "GAPI";
 //         requirements:
 //           provider_id: google_calendar_auth
 message Service {
-  // 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.
+  // 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`.
   string name = 1;
 
-  // The product title for this service, it is the name displayed in Google
-  // Cloud Console.
+  // 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.
   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 by the configuration author. 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. 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 by the configuration author. 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. Example:
   //
   //     enums:
   //     - name: google.someapi.v1.SomeEnum
@@ -159,8 +152,7 @@ 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.
@@ -178,14 +170,6 @@ message Service {
   // Output only. The source information for this configuration if available.
   SourceInfo source_info = 37;
 
-  // 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;
+  // Experimental configuration.
+  reserved 101;
 }

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

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2018 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,6 +24,7 @@ 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 2024 Google LLC
+// Copyright 2018 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,6 +22,7 @@ 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
@@ -67,8 +68,7 @@ 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 2024 Google LLC
+// Copyright 2018 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,23 +16,20 @@ 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.
@@ -80,8 +77,7 @@ 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