Module google_api_proto::google::api

source ·

Modules§

Structs§

  • Generated advice about this change, used for providing more information about how a change will affect the existing service.
  • Configuration for an authentication provider, including support for JSON Web Token (JWT).
  • User-defined authentication requirements, including support for JSON Web Token (JWT).
  • Authentication defines the authentication configuration for API methods provided by an API service.
  • Authentication rules for the service.
  • Backend defines the backend configuration for a service.
  • A backend rule provides configuration for an individual API element.
  • Billing related configuration of the service.
  • Details about how and where to publish client libraries.
  • Required information for every language.
  • Output generated from semantically comparing two versions of a service configuration.
  • Context defines which contexts an API requests.
  • A context rule provides information about the context for an individual API element.
  • Selects and configures the service controller used by the service.
  • Settings for C++ client libraries.
  • A custom pattern is used for defining custom HTTP verb.
  • Distribution contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets.
  • Documentation provides the information for describing a service.
  • A documentation rule provides information about individual API elements.
  • Settings for Dotnet client libraries.
  • Endpoint describes a network address of a service that serves a set of APIs. It is commonly known as a service endpoint. A service may expose any number of service endpoints, and all service endpoints share the same service definition, such as quota limits and monitoring metrics.
  • Rich semantic information of an API field beyond basic typing.
  • Google API Policy Annotation
  • Settings for Go client libraries.
  • Defines the HTTP configuration for an API service. It contains a list of [HttpRule][google.api.HttpRule], each specifying the mapping of an RPC method to one or more HTTP REST API methods.
  • Message that represents an arbitrary HTTP body. It should only be used for payload formats that can’t be represented as JSON, such as raw binary or an HTML page.
  • gRPC Transcoding
  • Settings for Java client libraries.
  • Specifies a location to extract JWT from an API request.
  • A description of a label.
  • A description of a log type. Example in YAML format:
  • Logging configuration of the service.
  • Defines policies applying to an RPC method.
  • Describes the generator configuration for a method.
  • A specific metric, identified by specifying values for all of the labels of a [MetricDescriptor][google.api.MetricDescriptor].
  • Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type’s existing data unusable.
  • Bind API methods to metrics. Binding a method to a metric causes that metric’s configured quota behaviors to apply to the method call.
  • An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a [MonitoredResourceDescriptor][google.api.MonitoredResourceDescriptor] object that describes the resource’s schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the [MonitoredResourceDescriptor][google.api.MonitoredResourceDescriptor] for "gce_instance" has labels "project_id", "instance_id" and "zone":
  • An object that describes the schema of a [MonitoredResource][google.api.MonitoredResource] object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.
  • Auxiliary metadata for a [MonitoredResource][google.api.MonitoredResource] object. [MonitoredResource][google.api.MonitoredResource] objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.
  • Monitoring configuration of the service.
  • Settings for Node client libraries.
  • OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for “Read-only access to Google Calendar” and “Access to Cloud Platform”. Users can consent to a scope for an application, giving it permission to access that data on their behalf.
  • Represents a documentation page. A page can contain subpages to represent nested documentation set structure.
  • Settings for Php client libraries.
  • A descriptor for defining project properties for a service. One service may have many consumer projects, and the service may want to behave differently depending on some properties on the project. For example, a project may be associated with a school, or a business, or a government agency, a business type property on the project may affect how a service responds to the client. This descriptor defines which properties are allowed to be set on a project.
  • Defines project properties.
  • This message configures the settings for publishing Google Cloud Client libraries generated from the service config.
  • Settings for Python client libraries.
  • Quota configuration helps to achieve fairness and budgeting in service usage.
  • QuotaLimit defines a specific limit that applies over a specified duration for a limit type. There can be at most one limit for a duration and limit type combination defined within a QuotaGroup.
  • A simple descriptor of a resource type.
  • Defines a proto annotation that describes a string field that refers to an API resource.
  • A projection from an input message to the GRPC or REST header.
  • Specifies the routing information that should be sent along with the request in the form of routing header. NOTE: All service configuration rules follow the “last one wins” order.
  • Settings for Ruby client libraries.
  • 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.
  • Source information used to create a Service Config
  • Define a parameter’s name and location. The parameter may be passed as either an HTTP header or a URL query parameter, and if both are passed the behavior is implementation-dependent.
  • Define a system parameter rule mapping system parameter definitions to methods.
  • System parameter configuration
  • A reference to a message type, for use in [FieldInfo][google.api.FieldInfo].
  • Configuration controlling usage of a service.
  • Usage configuration rules for the service.
  • Visibility restricts service consumer’s access to service elements, such as whether an application can call a visibility-restricted method. The restriction is expressed by applying visibility labels on service elements. The visibility labels are elsewhere linked to service consumers.
  • A visibility rule provides visibility configuration for an individual API element.

Enums§

  • Classifies set of possible modifications to an object in the service configuration.
  • To where should client libraries be published?
  • The organization for which the client libraries are being published. Affects the url where generated docs are published, etc.
  • Defines the supported values for google.rpc.ErrorInfo.reason for the googleapis.com error domain. This error domain is reserved for Service Infrastructure. For each error info of this domain, the metadata key “service” refers to the logical identifier of an API service, such as “pubsub.googleapis.com”. The “consumer” refers to the entity that consumes an API Service. It typically is a Google project that owns the client application or the server resource, such as “projects/123”. Other metadata keys are specific to each error reason. For more information, see the definition of the specific error reason.
  • An indicator of the behavior of a given field (for example, that a field is required in requests, or given as output but ignored as input). This does not change the behavior in protocol buffers itself; it only denotes the behavior and may affect how API tooling handles the field.
  • The launch stage as defined by Google Cloud Platform Launch Stages.