fusen-auth/proto/google/api
2023-10-23 18:27:42 +08:00
..
apikeys test 2023-10-23 18:27:42 +08:00
expr test 2023-10-23 18:27:42 +08:00
servicecontrol test 2023-10-23 18:27:42 +08:00
servicemanagement test 2023-10-23 18:27:42 +08:00
serviceusage test 2023-10-23 18:27:42 +08:00
annotations.proto test 2023-10-23 18:27:42 +08:00
auth.proto test 2023-10-23 18:27:42 +08:00
backend.proto test 2023-10-23 18:27:42 +08:00
billing.proto test 2023-10-23 18:27:42 +08:00
BUILD.bazel test 2023-10-23 18:27:42 +08:00
client.proto test 2023-10-23 18:27:42 +08:00
config_change.proto test 2023-10-23 18:27:42 +08:00
consumer.proto test 2023-10-23 18:27:42 +08:00
context.proto test 2023-10-23 18:27:42 +08:00
control.proto test 2023-10-23 18:27:42 +08:00
distribution.proto test 2023-10-23 18:27:42 +08:00
documentation.proto test 2023-10-23 18:27:42 +08:00
endpoint.proto test 2023-10-23 18:27:42 +08:00
error_reason.proto test 2023-10-23 18:27:42 +08:00
field_behavior.proto test 2023-10-23 18:27:42 +08:00
field_info.proto test 2023-10-23 18:27:42 +08:00
http.proto test 2023-10-23 18:27:42 +08:00
httpbody.proto test 2023-10-23 18:27:42 +08:00
label.proto test 2023-10-23 18:27:42 +08:00
launch_stage.proto test 2023-10-23 18:27:42 +08:00
log.proto test 2023-10-23 18:27:42 +08:00
logging.proto test 2023-10-23 18:27:42 +08:00
metric.proto test 2023-10-23 18:27:42 +08:00
monitored_resource.proto test 2023-10-23 18:27:42 +08:00
monitoring.proto test 2023-10-23 18:27:42 +08:00
policy.proto test 2023-10-23 18:27:42 +08:00
quota.proto test 2023-10-23 18:27:42 +08:00
README.md test 2023-10-23 18:27:42 +08:00
resource.proto test 2023-10-23 18:27:42 +08:00
routing.proto test 2023-10-23 18:27:42 +08:00
service.proto test 2023-10-23 18:27:42 +08:00
serviceconfig.yaml test 2023-10-23 18:27:42 +08:00
source_info.proto test 2023-10-23 18:27:42 +08:00
system_parameter.proto test 2023-10-23 18:27:42 +08:00
usage.proto test 2023-10-23 18:27:42 +08:00
visibility.proto test 2023-10-23 18:27:42 +08:00

API Protos

This folder contains the schema of the configuration model for Google's internal API serving platform, which handles routing, quotas, monitoring, logging, and the like.

Google refers to this configuration colloquially as the "service config", and the service.proto file in this directory is the entry point for understanding these.

Using these protos

To be honest, we probably open sourced way too much of this (basically by accident). There are a couple files in here you are most likely to be interested in: http.proto, documentation.proto, auth.proto, and annotations.proto.

HTTP and REST

The http.proto file contains the Http message (which then is wrapped in an annotation in annotations.proto), which provides a specification for REST endpoints and verbs (GET, POST, etc.) on RPC methods. We recommend use of this annotation for describing the relationship between RPCs and REST endpoints.

Documentation

The documentation.proto file contains a Documentation message which provides a mechanism to fully describe an API, allowing a tool to build structured documentation artifacts.

Authentication

The auth.proto file contains descriptions of both authentication rules and authentication providers, allowing you to describe what your services expect and accept from clients.