Expand description
The messages and enums that are part of this client library.
Modules§
- backend_
rule - Defines additional types related to BackendRule.
- billing
- Defines additional types related to Billing.
- distribution
- Defines additional types related to Distribution.
- field_
info - Defines additional types related to FieldInfo.
- http_
rule - Defines additional types related to HttpRule.
- jwt_
location - Defines additional types related to JwtLocation.
- label_
descriptor - Defines additional types related to LabelDescriptor.
- logging
- Defines additional types related to Logging.
- method_
settings - Defines additional types related to MethodSettings.
- metric_
descriptor - Defines additional types related to MetricDescriptor.
- monitoring
- Defines additional types related to Monitoring.
- property
- Defines additional types related to Property.
- python_
settings - Defines additional types related to PythonSettings.
- resource_
descriptor - Defines additional types related to ResourceDescriptor.
Structs§
- Advice
- Generated advice about this change, used for providing more information about how a change will affect the existing service.
- Auth
Provider - Configuration for an authentication provider, including support for JSON Web Token (JWT).
- Auth
Requirement - User-defined authentication requirements, including support for JSON Web Token (JWT).
- Authentication
Authentication
defines the authentication configuration for API methods provided by an API service.- Authentication
Rule - Authentication rules for the service.
- Backend
Backend
defines the backend configuration for a service.- Backend
Rule - A backend rule provides configuration for an individual API element.
- Billing
- Billing related configuration of the service.
- Client
Library Settings - Details about how and where to publish client libraries.
- Common
Language Settings - Required information for every language.
- Config
Change - Output generated from semantically comparing two versions of a service configuration.
- Context
Context
defines which contexts an API requests.- Context
Rule - A context rule provides information about the context for an individual API element.
- Control
- Selects and configures the service controller used by the service.
- CppSettings
- Settings for C++ client libraries.
- Custom
Http Pattern - A custom pattern is used for defining custom HTTP verb.
- Distribution
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
Documentation
provides the information for describing a service.- Documentation
Rule - A documentation rule provides information about individual API elements.
- Dotnet
Settings - Settings for Dotnet client libraries.
- Endpoint
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.- Field
Info - Rich semantic information of an API field beyond basic typing.
- Field
Policy - Google API Policy Annotation
- GoSettings
- Settings for Go client libraries.
- Http
- Defines the HTTP configuration for an API service. It contains a list of HttpRule, each specifying the mapping of an RPC method to one or more HTTP REST API methods.
- Http
Body - 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.
- Http
Rule - gRPC Transcoding
- Java
Settings - Settings for Java client libraries.
- JwtLocation
- Specifies a location to extract JWT from an API request.
- Label
Descriptor - A description of a label.
- LogDescriptor
- A description of a log type. Example in YAML format:
- Logging
- Logging configuration of the service.
- Method
Policy - Defines policies applying to an RPC method.
- Method
Settings - Describes the generator configuration for a method.
- Metric
- A specific metric, identified by specifying values for all of the
labels of a
MetricDescriptor
. - Metric
Descriptor - 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.
- Metric
Rule - Bind API methods to metrics. Binding a method to a metric causes that metric’s configured quota behaviors to apply to the method call.
- Monitored
Resource - 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 object that describes the resource’s schema. Information in thelabels
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 for"gce_instance"
has labels"project_id"
,"instance_id"
and"zone"
: - Monitored
Resource Descriptor - An object that describes the schema of a
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. - Monitored
Resource Metadata - Auxiliary metadata for a MonitoredResource object. 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
- Monitoring configuration of the service.
- Node
Settings - Settings for Node client libraries.
- OAuth
Requirements - 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.
- Page
- Represents a documentation page. A page can contain subpages to represent nested documentation set structure.
- PhpSettings
- Settings for Php client libraries.
- Project
Properties - 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.
- Property
- Defines project properties.
- Publishing
- This message configures the settings for publishing Google Cloud Client libraries generated from the service config.
- Python
Settings - Settings for Python client libraries.
- Quota
- Quota configuration helps to achieve fairness and budgeting in service usage.
- Quota
Limit 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 aQuotaGroup
.- Resource
Descriptor - A simple descriptor of a resource type.
- Resource
Reference - Defines a proto annotation that describes a string field that refers to an API resource.
- Routing
Parameter - A projection from an input message to the GRPC or REST header.
- Routing
Rule - 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.
- Ruby
Settings - Settings for Ruby client libraries.
- Selective
Gapic Generation - This message is used to configure the generation of a subset of the RPCs in a service for client libraries.
- Service
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
Info - Source information used to create a Service Config
- System
Parameter - 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.
- System
Parameter Rule - Define a system parameter rule mapping system parameter definitions to methods.
- System
Parameters - System parameter configuration
- Type
Reference - A reference to a message type, for use in FieldInfo.
- Usage
- Configuration controlling usage of a service.
- Usage
Rule - Usage configuration rules for the service.
- Visibility
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.- Visibility
Rule - A visibility rule provides visibility configuration for an individual API element.
Enums§
- Change
Type - Classifies set of possible modifications to an object in the service configuration.
- Client
Library Destination - To where should client libraries be published?
- Client
Library Organization - The organization for which the client libraries are being published. Affects the url where generated docs are published, etc.
- Error
Reason - Defines the supported values for
google.rpc.ErrorInfo.reason
for thegoogleapis.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. - Field
Behavior - 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.
- Launch
Stage - The launch stage as defined by Google Cloud Platform Launch Stages.