HttpRule

google.api.HttpRule

type HttpRule

google.api.HttpRule

Field

Type

Description

selector

string

Selects a method to which this rule applies. Refer to

[selector][google.api.DocumentationRule.selector]

for syntax details.

pattern

oneof

FieldTypeDescription
getstringMaps to HTTP GET. Used for listing and getting information about resources.
putstringMaps to HTTP PUT. Used for replacing a resource.
poststringMaps to HTTP POST. Used for creating a resource or performing an action.
deletestringMaps to HTTP DELETE. Used for deleting a resource.
patchstringMaps to HTTP PATCH. Used for updating a resource.
customCustomHttpPatternThe custom pattern is used for specifying an HTTP method that is not included in the pattern field, such as HEAD, or “*“ to leave the HTTP method unspecified for this rule. The wild-card rule is useful for services that provide content to Web (HTML) clients.

body

string

The name of the request field whose value is mapped to the HTTP request body, or

*

for mapping all request fields not captured by the path pattern to the HTTP body, or omitted for not having any HTTP request body. NOTE: the referred field must be present at the top-level of the request message type.

response_body

string

Optional. The name of the response field whose value is mapped to the HTTP response body. When omitted, the entire response message will be used as the HTTP response body. NOTE: The referred field must be present at the top-level of the response message type.

additional_bindings

HttpRule

repeated

Additional HTTP bindings for the selector. Nested bindings must not contain an

additional_bindings

field themselves (that is, the nesting may only be one level deep).

GOOGLE EXAMPLE