diff --git a/google/assistant/embedded/v1alpha1/embedded_assistant.proto b/google/assistant/embedded/v1alpha1/embedded_assistant.proto index 361c326d..79aa6cbc 100644 --- a/google/assistant/embedded/v1alpha1/embedded_assistant.proto +++ b/google/assistant/embedded/v1alpha1/embedded_assistant.proto @@ -24,7 +24,6 @@ option java_multiple_files = true; option java_outer_classname = "AssistantProto"; option java_package = "com.google.assistant.embedded.v1alpha1"; - // Service that implements Google Assistant API. service EmbeddedAssistant { // Initiates or continues a conversation with the embedded assistant service. @@ -85,7 +84,8 @@ message ConverseConfig { // Specifies how to process the `audio_in` data that will be provided in // subsequent requests. For recommended settings, see the Google Assistant SDK -// [best practices](https://developers.google.com/assistant/sdk/develop/grpc/best-practices/audio). +// [best +// practices](https://developers.google.com/assistant/sdk/develop/grpc/best-practices/audio). message AudioInConfig { // Audio encoding of the data sent in the audio message. // Audio must be one-channel (mono). The only language supported is "en-US". @@ -263,10 +263,10 @@ message ConverseResponse { // Exactly one of these fields will be populated in each `ConverseResponse`. oneof converse_response { - // *Output-only* If set, returns a [google.rpc.Status][google.rpc.Status] message that - // specifies the error for the operation. - // If an error occurs during processing, this message will be set and there - // will be no further messages sent. + // *Output-only* If set, returns a [google.rpc.Status][google.rpc.Status] + // message that specifies the error for the operation. If an error occurs + // during processing, this message will be set and there will be no further + // messages sent. google.rpc.Status error = 1; // *Output-only* Indicates the type of event. diff --git a/google/assistant/embedded/v1alpha2/embedded_assistant.proto b/google/assistant/embedded/v1alpha2/embedded_assistant.proto index b5787e1a..eccd1761 100755 --- a/google/assistant/embedded/v1alpha2/embedded_assistant.proto +++ b/google/assistant/embedded/v1alpha2/embedded_assistant.proto @@ -25,7 +25,6 @@ option java_outer_classname = "AssistantProto"; option java_package = "com.google.assistant.embedded.v1alpha2"; option objc_class_prefix = "ASTSDK"; - // Service that implements the Google Assistant API. service EmbeddedAssistant { // Initiates or continues a conversation with the embedded Assistant Service. @@ -161,7 +160,8 @@ message DebugInfo { message AssistConfig { oneof type { // Specifies how to process the subsequent incoming audio. Required if - // [AssistRequest.audio_in][google.assistant.embedded.v1alpha2.AssistRequest.audio_in] bytes will be provided in subsequent requests. + // [AssistRequest.audio_in][google.assistant.embedded.v1alpha2.AssistRequest.audio_in] + // bytes will be provided in subsequent requests. AudioInConfig audio_in_config = 1; // The text input to be sent to the Assistant. This can be populated from a @@ -188,7 +188,8 @@ message AssistConfig { // Specifies how to process the `audio_in` data that will be provided in // subsequent requests. For recommended settings, see the Google Assistant SDK -// [best practices](https://developers.google.com/assistant/sdk/guides/service/python/best-practices/audio). +// [best +// practices](https://developers.google.com/assistant/sdk/guides/service/python/best-practices/audio). message AudioInConfig { // Audio encoding of the data sent in the audio message. // Audio must be one-channel (mono). @@ -282,17 +283,20 @@ message ScreenOutConfig { // Provides information about the current dialog state. message DialogStateIn { // *Required* This field must always be set to the - // [DialogStateOut.conversation_state][google.assistant.embedded.v1alpha2.DialogStateOut.conversation_state] value that was returned in the prior - // `Assist` RPC. It should only be omitted (field not set) if there was no - // prior `Assist` RPC because this is the first `Assist` RPC made by this - // device after it was first setup and/or a factory-default reset. + // [DialogStateOut.conversation_state][google.assistant.embedded.v1alpha2.DialogStateOut.conversation_state] + // value that was returned in the prior `Assist` RPC. It should only be + // omitted (field not set) if there was no prior `Assist` RPC because this is + // the first `Assist` RPC made by this device after it was first setup and/or + // a factory-default reset. bytes conversation_state = 1; // *Required* Language of the request in // [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) (for example, - // "en-US"). See [Language Support](https://developers.google.com/assistant/sdk/reference/rpc/languages) + // "en-US"). See [Language + // Support](https://developers.google.com/assistant/sdk/reference/rpc/languages) // for more information. If you have selected a language for this `device_id` - // using the [Settings](https://developers.google.com/assistant/sdk/reference/assistant-app/assistant-settings) + // using the + // [Settings](https://developers.google.com/assistant/sdk/reference/assistant-app/assistant-settings) // menu in your phone's Google Assistant app, that selection will override // this value. string language_code = 2; diff --git a/google/example/library/v1/library.proto b/google/example/library/v1/library.proto index c31f7720..064efb20 100644 --- a/google/example/library/v1/library.proto +++ b/google/example/library/v1/library.proto @@ -24,7 +24,6 @@ option java_multiple_files = true; option java_outer_classname = "LibraryProto"; option java_package = "com.google.example.library.v1"; - // This API represents a simple digital library. It lets you manage Shelf // resources and Book resources in the library. It defines the following // resource model: @@ -37,23 +36,32 @@ option java_package = "com.google.example.library.v1"; service LibraryService { // Creates a shelf, and returns the new Shelf. rpc CreateShelf(CreateShelfRequest) returns (Shelf) { - option (google.api.http) = { post: "/v1/shelves" body: "shelf" }; + option (google.api.http) = { + post: "/v1/shelves" + body: "shelf" + }; } // Gets a shelf. Returns NOT_FOUND if the shelf does not exist. rpc GetShelf(GetShelfRequest) returns (Shelf) { - option (google.api.http) = { get: "/v1/{name=shelves/*}" }; + option (google.api.http) = { + get: "/v1/{name=shelves/*}" + }; } // Lists shelves. The order is unspecified but deterministic. Newly created // shelves will not necessarily be added to the end of this list. rpc ListShelves(ListShelvesRequest) returns (ListShelvesResponse) { - option (google.api.http) = { get: "/v1/shelves" }; + option (google.api.http) = { + get: "/v1/shelves" + }; } // Deletes a shelf. Returns NOT_FOUND if the shelf does not exist. rpc DeleteShelf(DeleteShelfRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/{name=shelves/*}" }; + option (google.api.http) = { + delete: "/v1/{name=shelves/*}" + }; } // Merges two shelves by adding all books from the shelf named @@ -64,41 +72,59 @@ service LibraryService { // Returns NOT_FOUND if either shelf does not exist. // This call is a no-op if the specified shelves are the same. rpc MergeShelves(MergeShelvesRequest) returns (Shelf) { - option (google.api.http) = { post: "/v1/{name=shelves/*}:merge" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=shelves/*}:merge" + body: "*" + }; } // Creates a book, and returns the new Book. rpc CreateBook(CreateBookRequest) returns (Book) { - option (google.api.http) = { post: "/v1/{name=shelves/*}/books" body: "book" }; + option (google.api.http) = { + post: "/v1/{name=shelves/*}/books" + body: "book" + }; } // Gets a book. Returns NOT_FOUND if the book does not exist. rpc GetBook(GetBookRequest) returns (Book) { - option (google.api.http) = { get: "/v1/{name=shelves/*/books/*}" }; + option (google.api.http) = { + get: "/v1/{name=shelves/*/books/*}" + }; } // Lists books in a shelf. The order is unspecified but deterministic. Newly // created books will not necessarily be added to the end of this list. // Returns NOT_FOUND if the shelf does not exist. rpc ListBooks(ListBooksRequest) returns (ListBooksResponse) { - option (google.api.http) = { get: "/v1/{name=shelves/*}/books" }; + option (google.api.http) = { + get: "/v1/{name=shelves/*}/books" + }; } // Deletes a book. Returns NOT_FOUND if the book does not exist. rpc DeleteBook(DeleteBookRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/{name=shelves/*/books/*}" }; + option (google.api.http) = { + delete: "/v1/{name=shelves/*/books/*}" + }; } // Updates a book. Returns INVALID_ARGUMENT if the name of the book // is non-empty and does equal the previous name. rpc UpdateBook(UpdateBookRequest) returns (Book) { - option (google.api.http) = { put: "/v1/{name=shelves/*/books/*}" body: "book" }; + option (google.api.http) = { + put: "/v1/{name=shelves/*/books/*}" + body: "book" + }; } // Moves a book to another shelf, and returns the new book. The book // id of the new book may not be the same as the original book. rpc MoveBook(MoveBookRequest) returns (Book) { - option (google.api.http) = { post: "/v1/{name=shelves/*/books/*}:move" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=shelves/*/books/*}:move" + body: "*" + }; } } diff --git a/google/home/graph/v1/device.proto b/google/home/graph/v1/device.proto index 62021289..2c959951 100644 --- a/google/home/graph/v1/device.proto +++ b/google/home/graph/v1/device.proto @@ -22,7 +22,6 @@ option go_package = "google.golang.org/genproto/googleapis/home/graph/v1;graph"; option java_outer_classname = "DeviceProto"; option java_package = "com.google.home.graph.v1"; - // Third-party partner's device definition. message Device { // Third-party partner's device ID. diff --git a/google/home/graph/v1/homegraph.proto b/google/home/graph/v1/homegraph.proto index 0d50665b..b8b277ad 100644 --- a/google/home/graph/v1/homegraph.proto +++ b/google/home/graph/v1/homegraph.proto @@ -35,10 +35,12 @@ service HomeGraphApiService { // // // Third-party user's identity is passed in as agent_user_id. - // (see [RequestSyncDevicesRequest][google.home.graph.v1.RequestSyncDevicesRequest]) and forwarded back to the agent. - // Agent is identified by the API key or JWT signed by the partner's service - // account. - rpc RequestSyncDevices(RequestSyncDevicesRequest) returns (RequestSyncDevicesResponse) { + // (see + // [RequestSyncDevicesRequest][google.home.graph.v1.RequestSyncDevicesRequest]) + // and forwarded back to the agent. Agent is identified by the API key or JWT + // signed by the partner's service account. + rpc RequestSyncDevices(RequestSyncDevicesRequest) + returns (RequestSyncDevicesResponse) { option (google.api.http) = { post: "/v1/devices:requestSync" body: "*" @@ -56,7 +58,8 @@ service HomeGraphApiService { // // Third-party user's identity is passed in as agent_user_id. // Agent is identified by the JWT signed by the partner's service account. - rpc ReportStateAndNotification(ReportStateAndNotificationRequest) returns (ReportStateAndNotificationResponse) { + rpc ReportStateAndNotification(ReportStateAndNotificationRequest) + returns (ReportStateAndNotificationResponse) { option (google.api.http) = { post: "/v1/devices:reportStateAndNotification" body: "*" @@ -125,9 +128,7 @@ message RequestSyncDevicesRequest { // Response type for RequestSyncDevices call. Intentionally empty upon success. // An HTTP response code is returned with more details upon failure. -message RequestSyncDevicesResponse { - -} +message RequestSyncDevicesResponse {} // Sample ReportStateAndNotificationRequest, with states and notifications // defined per device_id (eg: "123" and "456" in the following example): diff --git a/google/iam/admin/v1/iam.proto b/google/iam/admin/v1/iam.proto index 8632b4d2..174e79bd 100644 --- a/google/iam/admin/v1/iam.proto +++ b/google/iam/admin/v1/iam.proto @@ -29,7 +29,6 @@ option java_multiple_files = true; option java_outer_classname = "IamProto"; option java_package = "com.google.iam.admin.v1"; - // Creates and manages service account objects. // // Service account is an account that belongs to your project instead @@ -48,19 +47,28 @@ option java_package = "com.google.iam.admin.v1"; // `unique_id` of the service account. service IAM { // Lists [ServiceAccounts][google.iam.admin.v1.ServiceAccount] for a project. - rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse) { - option (google.api.http) = { get: "/v1/{name=projects/*}/serviceAccounts" }; + rpc ListServiceAccounts(ListServiceAccountsRequest) + returns (ListServiceAccountsResponse) { + option (google.api.http) = { + get: "/v1/{name=projects/*}/serviceAccounts" + }; } // Gets a [ServiceAccount][google.iam.admin.v1.ServiceAccount]. rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount) { - option (google.api.http) = { get: "/v1/{name=projects/*/serviceAccounts/*}" }; + option (google.api.http) = { + get: "/v1/{name=projects/*/serviceAccounts/*}" + }; } // Creates a [ServiceAccount][google.iam.admin.v1.ServiceAccount] // and returns it. - rpc CreateServiceAccount(CreateServiceAccountRequest) returns (ServiceAccount) { - option (google.api.http) = { post: "/v1/{name=projects/*}/serviceAccounts" body: "*" }; + rpc CreateServiceAccount(CreateServiceAccountRequest) + returns (ServiceAccount) { + option (google.api.http) = { + post: "/v1/{name=projects/*}/serviceAccounts" + body: "*" + }; } // Updates a [ServiceAccount][google.iam.admin.v1.ServiceAccount]. @@ -69,39 +77,61 @@ service IAM { // `display_name` . // The `etag` is mandatory. rpc UpdateServiceAccount(ServiceAccount) returns (ServiceAccount) { - option (google.api.http) = { put: "/v1/{name=projects/*/serviceAccounts/*}" body: "*" }; + option (google.api.http) = { + put: "/v1/{name=projects/*/serviceAccounts/*}" + body: "*" + }; } // Deletes a [ServiceAccount][google.iam.admin.v1.ServiceAccount]. - rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/{name=projects/*/serviceAccounts/*}" }; + rpc DeleteServiceAccount(DeleteServiceAccountRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/serviceAccounts/*}" + }; } // Lists [ServiceAccountKeys][google.iam.admin.v1.ServiceAccountKey]. - rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) returns (ListServiceAccountKeysResponse) { - option (google.api.http) = { get: "/v1/{name=projects/*/serviceAccounts/*}/keys" }; + rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) + returns (ListServiceAccountKeysResponse) { + option (google.api.http) = { + get: "/v1/{name=projects/*/serviceAccounts/*}/keys" + }; } // Gets the [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey] // by key id. - rpc GetServiceAccountKey(GetServiceAccountKeyRequest) returns (ServiceAccountKey) { - option (google.api.http) = { get: "/v1/{name=projects/*/serviceAccounts/*/keys/*}" }; + rpc GetServiceAccountKey(GetServiceAccountKeyRequest) + returns (ServiceAccountKey) { + option (google.api.http) = { + get: "/v1/{name=projects/*/serviceAccounts/*/keys/*}" + }; } // Creates a [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey] // and returns it. - rpc CreateServiceAccountKey(CreateServiceAccountKeyRequest) returns (ServiceAccountKey) { - option (google.api.http) = { post: "/v1/{name=projects/*/serviceAccounts/*}/keys" body: "*" }; + rpc CreateServiceAccountKey(CreateServiceAccountKeyRequest) + returns (ServiceAccountKey) { + option (google.api.http) = { + post: "/v1/{name=projects/*/serviceAccounts/*}/keys" + body: "*" + }; } // Deletes a [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey]. - rpc DeleteServiceAccountKey(DeleteServiceAccountKeyRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/{name=projects/*/serviceAccounts/*/keys/*}" }; + rpc DeleteServiceAccountKey(DeleteServiceAccountKeyRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/serviceAccounts/*/keys/*}" + }; } // Signs a blob using a service account's system-managed private key. rpc SignBlob(SignBlobRequest) returns (SignBlobResponse) { - option (google.api.http) = { post: "/v1/{name=projects/*/serviceAccounts/*}:signBlob" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=projects/*/serviceAccounts/*}:signBlob" + body: "*" + }; } // Signs a JWT using a service account's system-managed private key. @@ -110,52 +140,81 @@ service IAM { // an expiry time of one hour by default. If you request an expiry time of // more than one hour, the request will fail. rpc SignJwt(SignJwtRequest) returns (SignJwtResponse) { - option (google.api.http) = { post: "/v1/{name=projects/*/serviceAccounts/*}:signJwt" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=projects/*/serviceAccounts/*}:signJwt" + body: "*" + }; } // Returns the IAM access control policy for a // [ServiceAccount][google.iam.admin.v1.ServiceAccount]. - rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { - option (google.api.http) = { post: "/v1/{resource=projects/*/serviceAccounts/*}:getIamPolicy" body: "" }; + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/serviceAccounts/*}:getIamPolicy" + body: "" + }; } // Sets the IAM access control policy for a // [ServiceAccount][google.iam.admin.v1.ServiceAccount]. - rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { - option (google.api.http) = { post: "/v1/{resource=projects/*/serviceAccounts/*}:setIamPolicy" body: "*" }; + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/serviceAccounts/*}:setIamPolicy" + body: "*" + }; } // Tests the specified permissions against the IAM access control policy // for a [ServiceAccount][google.iam.admin.v1.ServiceAccount]. - rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { - option (google.api.http) = { post: "/v1/{resource=projects/*/serviceAccounts/*}:testIamPermissions" body: "*" }; + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) + returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/serviceAccounts/*}:testIamPermissions" + body: "*" + }; } // Queries roles that can be granted on a particular resource. // A role is grantable if it can be used as the role in a binding for a policy // for that resource. - rpc QueryGrantableRoles(QueryGrantableRolesRequest) returns (QueryGrantableRolesResponse) { - option (google.api.http) = { post: "/v1/roles:queryGrantableRoles" body: "*" }; + rpc QueryGrantableRoles(QueryGrantableRolesRequest) + returns (QueryGrantableRolesResponse) { + option (google.api.http) = { + post: "/v1/roles:queryGrantableRoles" + body: "*" + }; } // Lists the Roles defined on a resource. rpc ListRoles(ListRolesRequest) returns (ListRolesResponse) { - option (google.api.http) = { get: "/v1/roles" }; + option (google.api.http) = { + get: "/v1/roles" + }; } // Gets a Role definition. rpc GetRole(GetRoleRequest) returns (Role) { - option (google.api.http) = { get: "/v1/{name=roles/*}" }; + option (google.api.http) = { + get: "/v1/{name=roles/*}" + }; } // Creates a new Role. rpc CreateRole(CreateRoleRequest) returns (Role) { - option (google.api.http) = { post: "/v1/{parent=organizations/*}/roles" body: "*" }; + option (google.api.http) = { + post: "/v1/{parent=organizations/*}/roles" + body: "*" + }; } // Updates a Role definition. rpc UpdateRole(UpdateRoleRequest) returns (Role) { - option (google.api.http) = { patch: "/v1/{name=organizations/*/roles/*}" body: "role" }; + option (google.api.http) = { + patch: "/v1/{name=organizations/*/roles/*}" + body: "role" + }; } // Soft deletes a role. The role is suspended and cannot be used to create new @@ -166,18 +225,27 @@ service IAM { // within 7 days. After 7 days the Role is deleted and all Bindings associated // with the role are removed. rpc DeleteRole(DeleteRoleRequest) returns (Role) { - option (google.api.http) = { delete: "/v1/{name=organizations/*/roles/*}" }; + option (google.api.http) = { + delete: "/v1/{name=organizations/*/roles/*}" + }; } // Undelete a Role, bringing it back in its previous state. rpc UndeleteRole(UndeleteRoleRequest) returns (Role) { - option (google.api.http) = { post: "/v1/{name=organizations/*/roles/*}:undelete" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=organizations/*/roles/*}:undelete" + body: "*" + }; } // Lists the permissions testable on a resource. // A permission is testable if it can be tested for an identity on a resource. - rpc QueryTestablePermissions(QueryTestablePermissionsRequest) returns (QueryTestablePermissionsResponse) { - option (google.api.http) = { post: "/v1/permissions:queryTestablePermissions" body: "*" }; + rpc QueryTestablePermissions(QueryTestablePermissionsRequest) + returns (QueryTestablePermissionsResponse) { + option (google.api.http) = { + post: "/v1/permissions:queryTestablePermissions" + body: "*" + }; } } @@ -244,8 +312,8 @@ message CreateServiceAccountRequest { // `[a-z]([-a-z0-9]*[a-z0-9])` to comply with RFC1035. string account_id = 2; - // The [ServiceAccount][google.iam.admin.v1.ServiceAccount] resource to create. - // Currently, only the following values are user assignable: + // The [ServiceAccount][google.iam.admin.v1.ServiceAccount] resource to + // create. Currently, only the following values are user assignable: // `display_name` . ServiceAccount service_account = 3; } diff --git a/google/iam/credentials/v1/common.proto b/google/iam/credentials/v1/common.proto index fa382a99..09e8ea8b 100644 --- a/google/iam/credentials/v1/common.proto +++ b/google/iam/credentials/v1/common.proto @@ -25,7 +25,6 @@ option java_multiple_files = true; option java_outer_classname = "IAMCredentialsCommonProto"; option java_package = "com.google.cloud.iam.credentials.v1"; - message GenerateAccessTokenRequest { // The resource name of the service account for which the credentials // are requested, in the following format: diff --git a/google/iam/credentials/v1/iamcredentials.proto b/google/iam/credentials/v1/iamcredentials.proto index 91902dfd..3347beeb 100644 --- a/google/iam/credentials/v1/iamcredentials.proto +++ b/google/iam/credentials/v1/iamcredentials.proto @@ -25,7 +25,6 @@ option java_multiple_files = true; option java_outer_classname = "IAMCredentialsProto"; option java_package = "com.google.cloud.iam.credentials.v1"; - // A service account is a special type of Google account that belongs to your // application or a virtual machine (VM), instead of to an individual end user. // Your application assumes the identity of the service account to call Google @@ -37,7 +36,8 @@ option java_package = "com.google.cloud.iam.credentials.v1"; // more. service IAMCredentials { // Generates an OAuth 2.0 access token for a service account. - rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse) { + rpc GenerateAccessToken(GenerateAccessTokenRequest) + returns (GenerateAccessTokenResponse) { option (google.api.http) = { post: "/v1/{name=projects/*/serviceAccounts/*}:generateAccessToken" body: "*" @@ -45,7 +45,8 @@ service IAMCredentials { } // Generates an OpenID Connect ID token for a service account. - rpc GenerateIdToken(GenerateIdTokenRequest) returns (GenerateIdTokenResponse) { + rpc GenerateIdToken(GenerateIdTokenRequest) + returns (GenerateIdTokenResponse) { option (google.api.http) = { post: "/v1/{name=projects/*/serviceAccounts/*}:generateIdToken" body: "*" diff --git a/google/iam/v1/iam_policy.proto b/google/iam/v1/iam_policy.proto index a272fe8d..7cd1b0b9 100644 --- a/google/iam/v1/iam_policy.proto +++ b/google/iam/v1/iam_policy.proto @@ -27,7 +27,6 @@ option java_outer_classname = "IamPolicyProto"; option java_package = "com.google.iam.v1"; option php_namespace = "Google\\Cloud\\Iam\\V1"; - // ## API Overview // // Manages Identity and Access Management (IAM) policies. @@ -57,21 +56,31 @@ service IAMPolicy { // Sets the access control policy on the specified resource. Replaces any // existing policy. rpc SetIamPolicy(SetIamPolicyRequest) returns (Policy) { - option (google.api.http) = { post: "/v1/{resource=**}:setIamPolicy" body: "*" }; + option (google.api.http) = { + post: "/v1/{resource=**}:setIamPolicy" + body: "*" + }; } // Gets the access control policy for a resource. // Returns an empty policy if the resource exists and does not have a policy // set. rpc GetIamPolicy(GetIamPolicyRequest) returns (Policy) { - option (google.api.http) = { post: "/v1/{resource=**}:getIamPolicy" body: "*" }; + option (google.api.http) = { + post: "/v1/{resource=**}:getIamPolicy" + body: "*" + }; } // Returns permissions that a caller has on the specified resource. // If the resource does not exist, this will return an empty set of // permissions, not a NOT_FOUND error. - rpc TestIamPermissions(TestIamPermissionsRequest) returns (TestIamPermissionsResponse) { - option (google.api.http) = { post: "/v1/{resource=**}:testIamPermissions" body: "*" }; + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1/{resource=**}:testIamPermissions" + body: "*" + }; } } diff --git a/google/iam/v1/logging/audit_data.proto b/google/iam/v1/logging/audit_data.proto index d3f803fe..dfe441ba 100644 --- a/google/iam/v1/logging/audit_data.proto +++ b/google/iam/v1/logging/audit_data.proto @@ -25,7 +25,6 @@ option java_multiple_files = true; option java_outer_classname = "AuditDataProto"; option java_package = "com.google.iam.v1.logging"; - // Audit log information specific to Cloud IAM. This message is serialized // as an `Any` type in the `ServiceData` message of an // `AuditLog` message. diff --git a/google/iam/v1/policy.proto b/google/iam/v1/policy.proto index 9c31ccb1..78aa5f33 100644 --- a/google/iam/v1/policy.proto +++ b/google/iam/v1/policy.proto @@ -26,7 +26,6 @@ option java_outer_classname = "PolicyProto"; option java_package = "com.google.iam.v1"; option php_namespace = "Google\\Cloud\\Iam\\V1"; - // Defines an Identity and Access Management (IAM) policy. It is used to // specify access control policies for Cloud Platform resources. // diff --git a/google/longrunning/operations.proto b/google/longrunning/operations.proto index 76fef29c..37c5a7a4 100644 --- a/google/longrunning/operations.proto +++ b/google/longrunning/operations.proto @@ -28,16 +28,15 @@ option java_outer_classname = "OperationsProto"; option java_package = "com.google.longrunning"; option php_namespace = "Google\\LongRunning"; - // Manages long-running operations with an API service. // // When an API method normally takes long time to complete, it can be designed -// to return [Operation][google.longrunning.Operation] to the client, and the client can use this -// interface to receive the real response asynchronously by polling the -// operation resource, or pass the operation resource to another API (such as -// Google Cloud Pub/Sub API) to receive the response. Any API service that -// returns long-running operations should implement the `Operations` interface -// so developers can have a consistent client experience. +// to return [Operation][google.longrunning.Operation] to the client, and the +// client can use this interface to receive the real response asynchronously by +// polling the operation resource, or pass the operation resource to another API +// (such as Google Cloud Pub/Sub API) to receive the response. Any API service +// that returns long-running operations should implement the `Operations` +// interface so developers can have a consistent client experience. service Operations { // Lists operations that match the specified filter in the request. If the // server doesn't support this method, it returns `UNIMPLEMENTED`. @@ -45,14 +44,18 @@ service Operations { // NOTE: the `name` binding below allows API services to override the binding // to use different resource name schemes, such as `users/*/operations`. rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) { - option (google.api.http) = { get: "/v1/{name=operations}" }; + option (google.api.http) = { + get: "/v1/{name=operations}" + }; } // Gets the latest state of a long-running operation. Clients can use this // method to poll the operation result at intervals as recommended by the API // service. rpc GetOperation(GetOperationRequest) returns (Operation) { - option (google.api.http) = { get: "/v1/{name=operations/**}" }; + option (google.api.http) = { + get: "/v1/{name=operations/**}" + }; } // Deletes a long-running operation. This method indicates that the client is @@ -60,7 +63,9 @@ service Operations { // operation. If the server doesn't support this method, it returns // `google.rpc.Code.UNIMPLEMENTED`. rpc DeleteOperation(DeleteOperationRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/{name=operations/**}" }; + option (google.api.http) = { + delete: "/v1/{name=operations/**}" + }; } // Starts asynchronous cancellation on a long-running operation. The server @@ -71,10 +76,14 @@ service Operations { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, // the operation is not deleted; instead, it becomes an operation with - // an [Operation.error][google.longrunning.Operation.error] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, - // corresponding to `Code.CANCELLED`. + // an [Operation.error][google.longrunning.Operation.error] value with a + // [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to + // `Code.CANCELLED`. rpc CancelOperation(CancelOperationRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { post: "/v1/{name=operations/**}:cancel" body: "*" }; + option (google.api.http) = { + post: "/v1/{name=operations/**}:cancel" + body: "*" + }; } } @@ -116,13 +125,15 @@ message Operation { } } -// The request message for [Operations.GetOperation][google.longrunning.Operations.GetOperation]. +// The request message for +// [Operations.GetOperation][google.longrunning.Operations.GetOperation]. message GetOperationRequest { // The name of the operation resource. string name = 1; } -// The request message for [Operations.ListOperations][google.longrunning.Operations.ListOperations]. +// The request message for +// [Operations.ListOperations][google.longrunning.Operations.ListOperations]. message ListOperationsRequest { // The name of the operation collection. string name = 4; @@ -137,7 +148,8 @@ message ListOperationsRequest { string page_token = 3; } -// The response message for [Operations.ListOperations][google.longrunning.Operations.ListOperations]. +// The response message for +// [Operations.ListOperations][google.longrunning.Operations.ListOperations]. message ListOperationsResponse { // A list of operations that matches the specified filter in the request. repeated Operation operations = 1; @@ -146,15 +158,16 @@ message ListOperationsResponse { string next_page_token = 2; } -// The request message for [Operations.CancelOperation][google.longrunning.Operations.CancelOperation]. +// The request message for +// [Operations.CancelOperation][google.longrunning.Operations.CancelOperation]. message CancelOperationRequest { // The name of the operation resource to be cancelled. string name = 1; } -// The request message for [Operations.DeleteOperation][google.longrunning.Operations.DeleteOperation]. +// The request message for +// [Operations.DeleteOperation][google.longrunning.Operations.DeleteOperation]. message DeleteOperationRequest { // The name of the operation resource to be deleted. string name = 1; } - diff --git a/google/privacy/dlp/v2/dlp.proto b/google/privacy/dlp/v2/dlp.proto index cdf9d19f..70457842 100644 --- a/google/privacy/dlp/v2/dlp.proto +++ b/google/privacy/dlp/v2/dlp.proto @@ -35,7 +35,6 @@ option java_outer_classname = "DlpProto"; option java_package = "com.google.privacy.dlp.v2"; option php_namespace = "Google\\Cloud\\Dlp\\V2"; - // The Cloud Data Loss Prevention (DLP) API is a service that allows clients // to detect the presence of Personally Identifiable Information (PII) and other // privacy-sensitive data in user-supplied, unstructured data streams, like text @@ -85,7 +84,8 @@ service DlpService { // When no InfoTypes or CustomInfoTypes are specified in this request, the // system will automatically choose what detectors to run. By default this may // be all types, but may change over time as detectors are updated. - rpc DeidentifyContent(DeidentifyContentRequest) returns (DeidentifyContentResponse) { + rpc DeidentifyContent(DeidentifyContentRequest) + returns (DeidentifyContentResponse) { option (google.api.http) = { post: "/v2/{parent=projects/*}/content:deidentify" body: "*" @@ -96,7 +96,8 @@ service DlpService { // See // https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example // to learn more. - rpc ReidentifyContent(ReidentifyContentRequest) returns (ReidentifyContentResponse) { + rpc ReidentifyContent(ReidentifyContentRequest) + returns (ReidentifyContentResponse) { option (google.api.http) = { post: "/v2/{parent=projects/*}/content:reidentify" body: "*" @@ -115,7 +116,8 @@ service DlpService { // Creates an InspectTemplate for re-using frequently used configuration // for inspecting content, images, and storage. // See https://cloud.google.com/dlp/docs/creating-templates to learn more. - rpc CreateInspectTemplate(CreateInspectTemplateRequest) returns (InspectTemplate) { + rpc CreateInspectTemplate(CreateInspectTemplateRequest) + returns (InspectTemplate) { option (google.api.http) = { post: "/v2/{parent=organizations/*}/inspectTemplates" body: "*" @@ -128,7 +130,8 @@ service DlpService { // Updates the InspectTemplate. // See https://cloud.google.com/dlp/docs/creating-templates to learn more. - rpc UpdateInspectTemplate(UpdateInspectTemplateRequest) returns (InspectTemplate) { + rpc UpdateInspectTemplate(UpdateInspectTemplateRequest) + returns (InspectTemplate) { option (google.api.http) = { patch: "/v2/{name=organizations/*/inspectTemplates/*}" body: "*" @@ -144,31 +147,27 @@ service DlpService { rpc GetInspectTemplate(GetInspectTemplateRequest) returns (InspectTemplate) { option (google.api.http) = { get: "/v2/{name=organizations/*/inspectTemplates/*}" - additional_bindings { - get: "/v2/{name=projects/*/inspectTemplates/*}" - } + additional_bindings { get: "/v2/{name=projects/*/inspectTemplates/*}" } }; } // Lists InspectTemplates. // See https://cloud.google.com/dlp/docs/creating-templates to learn more. - rpc ListInspectTemplates(ListInspectTemplatesRequest) returns (ListInspectTemplatesResponse) { + rpc ListInspectTemplates(ListInspectTemplatesRequest) + returns (ListInspectTemplatesResponse) { option (google.api.http) = { get: "/v2/{parent=organizations/*}/inspectTemplates" - additional_bindings { - get: "/v2/{parent=projects/*}/inspectTemplates" - } + additional_bindings { get: "/v2/{parent=projects/*}/inspectTemplates" } }; } // Deletes an InspectTemplate. // See https://cloud.google.com/dlp/docs/creating-templates to learn more. - rpc DeleteInspectTemplate(DeleteInspectTemplateRequest) returns (google.protobuf.Empty) { + rpc DeleteInspectTemplate(DeleteInspectTemplateRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=organizations/*/inspectTemplates/*}" - additional_bindings { - delete: "/v2/{name=projects/*/inspectTemplates/*}" - } + additional_bindings { delete: "/v2/{name=projects/*/inspectTemplates/*}" } }; } @@ -176,7 +175,8 @@ service DlpService { // for de-identifying content, images, and storage. // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn // more. - rpc CreateDeidentifyTemplate(CreateDeidentifyTemplateRequest) returns (DeidentifyTemplate) { + rpc CreateDeidentifyTemplate(CreateDeidentifyTemplateRequest) + returns (DeidentifyTemplate) { option (google.api.http) = { post: "/v2/{parent=organizations/*}/deidentifyTemplates" body: "*" @@ -190,7 +190,8 @@ service DlpService { // Updates the DeidentifyTemplate. // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn // more. - rpc UpdateDeidentifyTemplate(UpdateDeidentifyTemplateRequest) returns (DeidentifyTemplate) { + rpc UpdateDeidentifyTemplate(UpdateDeidentifyTemplateRequest) + returns (DeidentifyTemplate) { option (google.api.http) = { patch: "/v2/{name=organizations/*/deidentifyTemplates/*}" body: "*" @@ -204,31 +205,30 @@ service DlpService { // Gets a DeidentifyTemplate. // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn // more. - rpc GetDeidentifyTemplate(GetDeidentifyTemplateRequest) returns (DeidentifyTemplate) { + rpc GetDeidentifyTemplate(GetDeidentifyTemplateRequest) + returns (DeidentifyTemplate) { option (google.api.http) = { get: "/v2/{name=organizations/*/deidentifyTemplates/*}" - additional_bindings { - get: "/v2/{name=projects/*/deidentifyTemplates/*}" - } + additional_bindings { get: "/v2/{name=projects/*/deidentifyTemplates/*}" } }; } // Lists DeidentifyTemplates. // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn // more. - rpc ListDeidentifyTemplates(ListDeidentifyTemplatesRequest) returns (ListDeidentifyTemplatesResponse) { + rpc ListDeidentifyTemplates(ListDeidentifyTemplatesRequest) + returns (ListDeidentifyTemplatesResponse) { option (google.api.http) = { get: "/v2/{parent=organizations/*}/deidentifyTemplates" - additional_bindings { - get: "/v2/{parent=projects/*}/deidentifyTemplates" - } + additional_bindings { get: "/v2/{parent=projects/*}/deidentifyTemplates" } }; } // Deletes a DeidentifyTemplate. // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn // more. - rpc DeleteDeidentifyTemplate(DeleteDeidentifyTemplateRequest) returns (google.protobuf.Empty) { + rpc DeleteDeidentifyTemplate(DeleteDeidentifyTemplateRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=organizations/*/deidentifyTemplates/*}" additional_bindings { @@ -266,7 +266,8 @@ service DlpService { // Lists job triggers. // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. - rpc ListJobTriggers(ListJobTriggersRequest) returns (ListJobTriggersResponse) { + rpc ListJobTriggers(ListJobTriggersRequest) + returns (ListJobTriggersResponse) { option (google.api.http) = { get: "/v2/{parent=projects/*}/jobTriggers" }; @@ -274,7 +275,8 @@ service DlpService { // Deletes a job trigger. // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. - rpc DeleteJobTrigger(DeleteJobTriggerRequest) returns (google.protobuf.Empty) { + rpc DeleteJobTrigger(DeleteJobTriggerRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=projects/*/jobTriggers/*}" }; @@ -347,7 +349,8 @@ service DlpService { // Creates a pre-built stored infoType to be used for inspection. // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to // learn more. - rpc CreateStoredInfoType(CreateStoredInfoTypeRequest) returns (StoredInfoType) { + rpc CreateStoredInfoType(CreateStoredInfoTypeRequest) + returns (StoredInfoType) { option (google.api.http) = { post: "/v2/{parent=organizations/*}/storedInfoTypes" body: "*" @@ -362,7 +365,8 @@ service DlpService { // will continue to be used until the new version is ready. // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to // learn more. - rpc UpdateStoredInfoType(UpdateStoredInfoTypeRequest) returns (StoredInfoType) { + rpc UpdateStoredInfoType(UpdateStoredInfoTypeRequest) + returns (StoredInfoType) { option (google.api.http) = { patch: "/v2/{name=organizations/*/storedInfoTypes/*}" body: "*" @@ -379,33 +383,29 @@ service DlpService { rpc GetStoredInfoType(GetStoredInfoTypeRequest) returns (StoredInfoType) { option (google.api.http) = { get: "/v2/{name=organizations/*/storedInfoTypes/*}" - additional_bindings { - get: "/v2/{name=projects/*/storedInfoTypes/*}" - } + additional_bindings { get: "/v2/{name=projects/*/storedInfoTypes/*}" } }; } // Lists stored infoTypes. // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to // learn more. - rpc ListStoredInfoTypes(ListStoredInfoTypesRequest) returns (ListStoredInfoTypesResponse) { + rpc ListStoredInfoTypes(ListStoredInfoTypesRequest) + returns (ListStoredInfoTypesResponse) { option (google.api.http) = { get: "/v2/{parent=organizations/*}/storedInfoTypes" - additional_bindings { - get: "/v2/{parent=projects/*}/storedInfoTypes" - } + additional_bindings { get: "/v2/{parent=projects/*}/storedInfoTypes" } }; } // Deletes a stored infoType. // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to // learn more. - rpc DeleteStoredInfoType(DeleteStoredInfoTypeRequest) returns (google.protobuf.Empty) { + rpc DeleteStoredInfoType(DeleteStoredInfoTypeRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=organizations/*/storedInfoTypes/*}" - additional_bindings { - delete: "/v2/{name=projects/*/storedInfoTypes/*}" - } + additional_bindings { delete: "/v2/{name=projects/*/storedInfoTypes/*}" } }; } } @@ -1363,7 +1363,8 @@ message AnalyzeDataSourceRiskDetails { } // Histogram of value frequencies in the column. - repeated CategoricalStatsHistogramBucket value_frequency_histogram_buckets = 5; + repeated CategoricalStatsHistogramBucket value_frequency_histogram_buckets = + 5; } // Result of the k-anonymity computation. @@ -1441,7 +1442,8 @@ message AnalyzeDataSourceRiskDetails { } // Histogram of l-diversity equivalence class sensitive value frequencies. - repeated LDiversityHistogramBucket sensitive_value_frequency_histogram_buckets = 5; + repeated LDiversityHistogramBucket + sensitive_value_frequency_histogram_buckets = 5; } // Result of the reidentifiability analysis. Note that these results are an @@ -1547,7 +1549,8 @@ message AnalyzeDataSourceRiskDetails { // {min_probability: 0.3, max_probability: 0.4, frequency: 99} // mean that there are no record with an estimated probability in [0.1, 0.2) // nor larger or equal to 0.4. - repeated DeltaPresenceEstimationHistogramBucket delta_presence_estimation_histogram = 1; + repeated DeltaPresenceEstimationHistogramBucket + delta_presence_estimation_histogram = 1; } // Privacy metric to compute. @@ -1722,16 +1725,12 @@ message ReplaceValueConfig { } // Replace each matching finding with the name of the info_type. -message ReplaceWithInfoTypeConfig { - -} +message ReplaceWithInfoTypeConfig {} // Redact a given value. For example, if used with an `InfoTypeTransformation` // transforming PHONE_NUMBER, and input 'My phone number is 206-555-0123', the // output would be 'My phone number is '. -message RedactConfig { - -} +message RedactConfig {} // Characters to skip when doing deidentification of a value. These will be left // alone and skipped. @@ -2403,15 +2402,11 @@ message Action { // service-specific policy, see https://cloud.google.com/terms/service-terms // Only a single instance of this action can be specified. // Compatible with: Inspect - message PublishSummaryToCscc { - - } + message PublishSummaryToCscc {} // Enable email notification to project owners and editors on jobs's // completion/failure. - message JobNotificationEmails { - - } + message JobNotificationEmails {} oneof action { // Save resulting findings in a provided location. diff --git a/google/privacy/dlp/v2/storage.proto b/google/privacy/dlp/v2/storage.proto index 9993c25f..9e03e070 100644 --- a/google/privacy/dlp/v2/storage.proto +++ b/google/privacy/dlp/v2/storage.proto @@ -27,7 +27,6 @@ option java_outer_classname = "DlpStorage"; option java_package = "com.google.privacy.dlp.v2"; option php_namespace = "Google\\Cloud\\Dlp\\V2"; - // Type of information detected by the API. message InfoType { // Name of the information type. Either a name of your choosing when @@ -135,9 +134,7 @@ message CustomInfoType { // output. This should be used in conjunction with a field on the // transformation such as `surrogate_info_type`. This CustomInfoType does // not support the use of `detection_rules`. - message SurrogateType { - - } + message SurrogateType {} // Rule for modifying a CustomInfoType to alter behavior under certain // circumstances, depending on the specific details of the rule. Not supported diff --git a/google/pubsub/v1/pubsub.proto b/google/pubsub/v1/pubsub.proto index 095a37b1..9d79638f 100644 --- a/google/pubsub/v1/pubsub.proto +++ b/google/pubsub/v1/pubsub.proto @@ -32,7 +32,6 @@ option java_package = "com.google.pubsub.v1"; option php_namespace = "Google\\Cloud\\PubSub\\V1"; option ruby_package = "Google::Cloud::PubSub::V1"; - // The service that an application uses to manipulate topics, and to send // messages to a topic. service Publisher { @@ -79,7 +78,8 @@ service Publisher { } // Lists the names of the subscriptions on this topic. - rpc ListTopicSubscriptions(ListTopicSubscriptionsRequest) returns (ListTopicSubscriptionsResponse) { + rpc ListTopicSubscriptions(ListTopicSubscriptionsRequest) + returns (ListTopicSubscriptionsResponse) { option (google.api.http) = { get: "/v1/{topic=projects/*/topics/*}/subscriptions" }; @@ -94,7 +94,8 @@ service Publisher { // BETA: This feature is part of a beta release. This API might be // changed in backward-incompatible ways and is not recommended for production // use. It is not subject to any SLA or deprecation policy. - rpc ListTopicSnapshots(ListTopicSnapshotsRequest) returns (ListTopicSnapshotsResponse) { + rpc ListTopicSnapshots(ListTopicSnapshotsRequest) + returns (ListTopicSnapshotsResponse) { option (google.api.http) = { get: "/v1/{topic=projects/*/topics/*}/snapshots" }; @@ -125,9 +126,10 @@ service Subscriber { // If the name is not provided in the request, the server will assign a random // name for this subscription on the same project as the topic, conforming // to the - // [resource name format](https://cloud.google.com/pubsub/docs/admin#resource_names). - // The generated name is populated in the returned Subscription object. - // Note that for REST API requests, you must specify a name in the request. + // [resource name + // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The + // generated name is populated in the returned Subscription object. Note that + // for REST API requests, you must specify a name in the request. rpc CreateSubscription(Subscription) returns (Subscription) { option (google.api.http) = { put: "/v1/{name=projects/*/subscriptions/*}" @@ -152,7 +154,8 @@ service Subscriber { } // Lists matching subscriptions. - rpc ListSubscriptions(ListSubscriptionsRequest) returns (ListSubscriptionsResponse) { + rpc ListSubscriptions(ListSubscriptionsRequest) + returns (ListSubscriptionsResponse) { option (google.api.http) = { get: "/v1/{project=projects/*}/subscriptions" }; @@ -163,7 +166,8 @@ service Subscriber { // `NOT_FOUND`. After a subscription is deleted, a new one may be created with // the same name, but the new one has no association with the old // subscription or its topic unless the same topic is specified. - rpc DeleteSubscription(DeleteSubscriptionRequest) returns (google.protobuf.Empty) { + rpc DeleteSubscription(DeleteSubscriptionRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{subscription=projects/*/subscriptions/*}" }; @@ -174,7 +178,8 @@ service Subscriber { // subscriber, or to make the message available for redelivery if the // processing was interrupted. Note that this does not modify the // subscription-level `ackDeadlineSeconds` used for subsequent messages. - rpc ModifyAckDeadline(ModifyAckDeadlineRequest) returns (google.protobuf.Empty) { + rpc ModifyAckDeadline(ModifyAckDeadlineRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { post: "/v1/{subscription=projects/*/subscriptions/*}:modifyAckDeadline" body: "*" @@ -212,8 +217,8 @@ service Subscriber { // reassign server-side resources, in which case, the client should // re-establish the stream. Flow control can be achieved by configuring the // underlying RPC channel. - rpc StreamingPull(stream StreamingPullRequest) returns (stream StreamingPullResponse) { - } + rpc StreamingPull(stream StreamingPullRequest) + returns (stream StreamingPullResponse) {} // Modifies the `PushConfig` for a specified subscription. // @@ -221,7 +226,8 @@ service Subscriber { // an empty `PushConfig`) or vice versa, or change the endpoint URL and other // attributes of a push subscription. Messages will accumulate for delivery // continuously through the call regardless of changes to the `PushConfig`. - rpc ModifyPushConfig(ModifyPushConfigRequest) returns (google.protobuf.Empty) { + rpc ModifyPushConfig(ModifyPushConfigRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { post: "/v1/{subscription=projects/*/subscriptions/*}:modifyPushConfig" body: "*" @@ -275,9 +281,10 @@ service Subscriber { // the request, the server will assign a random // name for this snapshot on the same project as the subscription, conforming // to the - // [resource name format](https://cloud.google.com/pubsub/docs/admin#resource_names). - // The generated name is populated in the returned Snapshot object. Note that - // for REST API requests, you must specify a name in the request. + // [resource name + // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The + // generated name is populated in the returned Snapshot object. Note that for + // REST API requests, you must specify a name in the request. rpc CreateSnapshot(CreateSnapshotRequest) returns (Snapshot) { option (google.api.http) = { put: "/v1/{name=projects/*/snapshots/*}" @@ -576,7 +583,8 @@ message Subscription { // messages are not expunged from the subscription's backlog, even if they are // acknowledged, until they fall out of the `message_retention_duration` // window. This must be true if you would like to - // + // // Seek to a timestamp. //

// BETA: This feature is part of a beta release. This API might be @@ -872,9 +880,9 @@ message StreamingPullResponse { } // Request for the `CreateSnapshot` method.

-// BETA: This feature is part of a beta release. This API might be changed in -// backward-incompatible ways and is not recommended for production use. -// It is not subject to any SLA or deprecation policy. +// BETA: This feature is part of a beta release. This API might be +// changed in backward-incompatible ways and is not recommended for production +// use. It is not subject to any SLA or deprecation policy. message CreateSnapshotRequest { // Optional user-provided name for this snapshot. // If the name is not provided in the request, the server will assign a random @@ -1028,6 +1036,4 @@ message SeekRequest { } // Response for the `Seek` method (this response is empty). -message SeekResponse { - -} +message SeekResponse {} diff --git a/google/pubsub/v1beta2/pubsub.proto b/google/pubsub/v1beta2/pubsub.proto index 70dd1556..35413937 100644 --- a/google/pubsub/v1beta2/pubsub.proto +++ b/google/pubsub/v1beta2/pubsub.proto @@ -23,7 +23,6 @@ option java_multiple_files = true; option java_outer_classname = "PubsubProto"; option java_package = "com.google.pubsub.v1beta2"; - // The service that an application uses to manipulate subscriptions and to // consume messages from a subscription via the Pull method. service Subscriber { @@ -39,20 +38,23 @@ service Subscriber { rpc GetSubscription(GetSubscriptionRequest) returns (Subscription); // Lists matching subscriptions. - rpc ListSubscriptions(ListSubscriptionsRequest) returns (ListSubscriptionsResponse); + rpc ListSubscriptions(ListSubscriptionsRequest) + returns (ListSubscriptionsResponse); // Deletes an existing subscription. All pending messages in the subscription // are immediately dropped. Calls to Pull after deletion will return // NOT_FOUND. After a subscription is deleted, a new one may be created with // the same name, but the new one has no association with the old // subscription, or its topic unless the same topic is specified. - rpc DeleteSubscription(DeleteSubscriptionRequest) returns (google.protobuf.Empty); + rpc DeleteSubscription(DeleteSubscriptionRequest) + returns (google.protobuf.Empty); // Modifies the ack deadline for a specific message. This method is useful to // indicate that more time is needed to process a message by the subscriber, // or to make the message available for redelivery if the processing was // interrupted. - rpc ModifyAckDeadline(ModifyAckDeadlineRequest) returns (google.protobuf.Empty); + rpc ModifyAckDeadline(ModifyAckDeadlineRequest) + returns (google.protobuf.Empty); // Acknowledges the messages associated with the ack tokens in the // AcknowledgeRequest. The Pub/Sub system can remove the relevant messages @@ -96,7 +98,8 @@ service Publisher { rpc ListTopics(ListTopicsRequest) returns (ListTopicsResponse); // Lists the name of the subscriptions for this topic. - rpc ListTopicSubscriptions(ListTopicSubscriptionsRequest) returns (ListTopicSubscriptionsResponse); + rpc ListTopicSubscriptions(ListTopicSubscriptionsRequest) + returns (ListTopicSubscriptionsResponse); // Deletes the topic with the given name. Returns NOT_FOUND if the topic does // not exist. After a topic is deleted, a new topic may be created with the diff --git a/google/storagetransfer/v1/transfer.proto b/google/storagetransfer/v1/transfer.proto index c82c51c7..e2a40b92 100644 --- a/google/storagetransfer/v1/transfer.proto +++ b/google/storagetransfer/v1/transfer.proto @@ -28,7 +28,6 @@ option java_outer_classname = "TransferProto"; option java_package = "com.google.storagetransfer.v1.proto"; option php_namespace = "Google\\Cloud\\StorageTransfer\\V1"; - // Transfers data between between Google Cloud Storage buckets or from a data // source external to Google to a Cloud Storage bucket. service StorageTransferService { @@ -40,40 +39,62 @@ service StorageTransferService { // ACLs to grant access to Storage Transfer Service. This service // account is created and owned by Storage Transfer Service and can // only be used by Storage Transfer Service. - rpc GetGoogleServiceAccount(GetGoogleServiceAccountRequest) returns (GoogleServiceAccount) { - option (google.api.http) = { get: "/v1/googleServiceAccounts/{project_id}" }; + rpc GetGoogleServiceAccount(GetGoogleServiceAccountRequest) + returns (GoogleServiceAccount) { + option (google.api.http) = { + get: "/v1/googleServiceAccounts/{project_id}" + }; } // Creates a transfer job that runs periodically. rpc CreateTransferJob(CreateTransferJobRequest) returns (TransferJob) { - option (google.api.http) = { post: "/v1/transferJobs" body: "transfer_job" }; + option (google.api.http) = { + post: "/v1/transferJobs" + body: "transfer_job" + }; } // Updates a transfer job. Updating a job's transfer spec does not affect // transfer operations that are running already. Updating the scheduling // of a job is not allowed. rpc UpdateTransferJob(UpdateTransferJobRequest) returns (TransferJob) { - option (google.api.http) = { patch: "/v1/{job_name=transferJobs/**}" body: "*" }; + option (google.api.http) = { + patch: "/v1/{job_name=transferJobs/**}" + body: "*" + }; } // Gets a transfer job. rpc GetTransferJob(GetTransferJobRequest) returns (TransferJob) { - option (google.api.http) = { get: "/v1/{job_name=transferJobs/**}" }; + option (google.api.http) = { + get: "/v1/{job_name=transferJobs/**}" + }; } // Lists transfer jobs. - rpc ListTransferJobs(ListTransferJobsRequest) returns (ListTransferJobsResponse) { - option (google.api.http) = { get: "/v1/transferJobs" }; + rpc ListTransferJobs(ListTransferJobsRequest) + returns (ListTransferJobsResponse) { + option (google.api.http) = { + get: "/v1/transferJobs" + }; } // Pauses a transfer operation. - rpc PauseTransferOperation(PauseTransferOperationRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { post: "/v1/{name=transferOperations/**}:pause" body: "*" }; + rpc PauseTransferOperation(PauseTransferOperationRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + post: "/v1/{name=transferOperations/**}:pause" + body: "*" + }; } // Resumes a transfer operation that is paused. - rpc ResumeTransferOperation(ResumeTransferOperationRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { post: "/v1/{name=transferOperations/**}:resume" body: "*" }; + rpc ResumeTransferOperation(ResumeTransferOperationRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + post: "/v1/{name=transferOperations/**}:resume" + body: "*" + }; } } @@ -137,9 +158,9 @@ message ListTransferJobsRequest { // "job_names":["jobid1","jobid2",...], // "job_statuses":["status1","status2",...]}. // Since `job_names` and `job_statuses` support multiple values, their values - // must be specified with array notation. `project_id` is required. `job_names` - // and `job_statuses` are optional. The valid values for `job_statuses` are - // case-insensitive: `ENABLED`, `DISABLED`, and `DELETED`. + // must be specified with array notation. `project_id` is required. + // `job_names` and `job_statuses` are optional. The valid values for + // `job_statuses` are case-insensitive: `ENABLED`, `DISABLED`, and `DELETED`. string filter = 1; // The list page size. The max allowed value is 256. diff --git a/google/storagetransfer/v1/transfer_types.proto b/google/storagetransfer/v1/transfer_types.proto index 5b9095ed..1495e42f 100644 --- a/google/storagetransfer/v1/transfer_types.proto +++ b/google/storagetransfer/v1/transfer_types.proto @@ -30,7 +30,6 @@ option java_outer_classname = "TransferTypes"; option java_package = "com.google.storagetransfer.v1.proto"; option php_namespace = "Google\\Cloud\\StorageTransfer\\V1"; - // Google service account message GoogleServiceAccount { // Required. @@ -38,7 +37,8 @@ message GoogleServiceAccount { } // AWS access key (see -// [AWS Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). +// [AWS Security +// Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). message AwsAccessKey { // AWS access key ID. // Required. @@ -66,9 +66,10 @@ message ObjectConditions { // If `includePrefixes` is specified, objects that satisfy the object // conditions must have names that start with one of the `includePrefixes` - // and that do not start with any of the `excludePrefixes`. If `includePrefixes` - // is not specified, all objects except those that have names starting with - // one of the `excludePrefixes` must satisfy the object conditions. + // and that do not start with any of the `excludePrefixes`. If + // `includePrefixes` is not specified, all objects except those that have + // names starting with one of the `excludePrefixes` must satisfy the object + // conditions. // // Requirements: // @@ -111,7 +112,8 @@ message ObjectConditions { // when the content or the metadata of the object is updated. message GcsData { // Google Cloud Storage bucket name (see - // [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)). + // [Bucket Name + // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)). // Required. string bucket_name = 1; } @@ -120,7 +122,8 @@ message GcsData { // In an AwsS3Data, an object's name is the S3 object's key name. message AwsS3Data { // S3 Bucket name (see - // [Creating a bucket](http://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-location-example.html)). + // [Creating a + // bucket](http://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-location-example.html)). // Required. string bucket_name = 1; @@ -145,12 +148,13 @@ message AwsS3Data { // * MD5 - The base64-encoded MD5 hash of the object. // // For an example of a valid TSV file, see -// [Transferring data from URLs](https://cloud.google.com/storage/transfer/create-url-list). +// [Transferring data from +// URLs](https://cloud.google.com/storage/transfer/create-url-list). // // When transferring data based on a URL list, keep the following in mind: // -// * When an object located at `http(s)://hostname:port/` is transferred -// to a data sink, the name of the object at the data sink is +// * When an object located at `http(s)://hostname:port/` is +// transferred to a data sink, the name of the object at the data sink is // `/`. // // * If the specified size of an object does not match the actual size of the @@ -417,8 +421,8 @@ message TransferOperation { // A globally unique ID assigned by the system. string name = 1; - // The ID of the Google Cloud Platform Console project that owns the operation. - // Required. + // The ID of the Google Cloud Platform Console project that owns the + // operation. Required. string project_id = 2; // Transfer specification. diff --git a/google/streetview/publish/v1/resources.proto b/google/streetview/publish/v1/resources.proto index 69a75f5e..1dc61318 100644 --- a/google/streetview/publish/v1/resources.proto +++ b/google/streetview/publish/v1/resources.proto @@ -24,7 +24,6 @@ option go_package = "google.golang.org/genproto/googleapis/streetview/publish/v1 option java_outer_classname = "StreetViewPublishResources"; option java_package = "com.google.geo.ugc.streetview.publish.v1"; - // Upload reference for media files. message UploadRef { // Required. An upload reference should be unique for each user. It follows diff --git a/google/streetview/publish/v1/rpcmessages.proto b/google/streetview/publish/v1/rpcmessages.proto index 1467e9e7..8f0ed8b2 100644 --- a/google/streetview/publish/v1/rpcmessages.proto +++ b/google/streetview/publish/v1/rpcmessages.proto @@ -24,7 +24,6 @@ option go_package = "google.golang.org/genproto/googleapis/streetview/publish/v1 option java_outer_classname = "StreetViewPublishRpcMessages"; option java_package = "com.google.geo.ugc.streetview.publish.v1"; - // Request to create a photo. message CreatePhotoRequest { // Required. Photo to create. diff --git a/google/streetview/publish/v1/streetview_publish.proto b/google/streetview/publish/v1/streetview_publish.proto index e473dda2..5b83c4b5 100644 --- a/google/streetview/publish/v1/streetview_publish.proto +++ b/google/streetview/publish/v1/streetview_publish.proto @@ -27,8 +27,6 @@ option java_package = "com.google.geo.ugc.streetview.publish.v1"; // Definition of the service that backs the Street View Publish API. - - // Publishes and connects user-contributed photos on Street View. service StreetViewPublishService { // Creates an upload session to start uploading photo data. The upload URL of @@ -38,7 +36,10 @@ service StreetViewPublishService { // `StreetViewPublishService:CreatePhoto()` to create the `Photo` object // entry. rpc StartUpload(google.protobuf.Empty) returns (UploadRef) { - option (google.api.http) = { post: "/v1/photo:startUpload" body: "*" }; + option (google.api.http) = { + post: "/v1/photo:startUpload" + body: "*" + }; } // After the client finishes uploading the photo with the returned @@ -50,7 +51,10 @@ service StreetViewPublishService { // * `INVALID_ARGUMENT` if the request is malformed. // * `NOT_FOUND` if the upload reference does not exist. rpc CreatePhoto(CreatePhotoRequest) returns (Photo) { - option (google.api.http) = { post: "/v1/photo" body: "photo" }; + option (google.api.http) = { + post: "/v1/photo" + body: "photo" + }; } // Gets the metadata of the specified `Photo`. @@ -61,7 +65,9 @@ service StreetViewPublishService { // photo. // * `NOT_FOUND` if the requested photo does not exist. rpc GetPhoto(GetPhotoRequest) returns (Photo) { - option (google.api.http) = { get: "/v1/photo/{photo_id}" }; + option (google.api.http) = { + get: "/v1/photo/{photo_id}" + }; } // Gets the metadata of the specified `Photo` batch. @@ -73,12 +79,16 @@ service StreetViewPublishService { // `BatchGetPhotosResponse.results.status`. // See `photo.get` for specific failures that will occur per photo. rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse) { - option (google.api.http) = { get: "/v1/photos:batchGet" }; + option (google.api.http) = { + get: "/v1/photos:batchGet" + }; } // Lists all the photos that belong to the user. rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse) { - option (google.api.http) = { get: "/v1/photos" }; + option (google.api.http) = { + get: "/v1/photos" + }; } // Updates the metadata of a photo, such as pose, place association, etc. @@ -91,7 +101,10 @@ service StreetViewPublishService { // * `INVALID_ARGUMENT` if the request is malformed. // * `NOT_FOUND` if the photo ID does not exist. rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo) { - option (google.api.http) = { put: "/v1/photo/{photo.photo_id.id}" body: "photo" }; + option (google.api.http) = { + put: "/v1/photo/{photo.photo_id.id}" + body: "photo" + }; } // Updates the metadata of photos, such as pose, place association, etc. @@ -103,8 +116,12 @@ service StreetViewPublishService { // failures for single photos in the batch. These failures will be specified // in `BatchUpdatePhotosResponse.results.status`. // See `UpdatePhoto` for specific failures that will occur per photo. - rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse) { - option (google.api.http) = { post: "/v1/photos:batchUpdate" body: "*" }; + rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) + returns (BatchUpdatePhotosResponse) { + option (google.api.http) = { + post: "/v1/photos:batchUpdate" + body: "*" + }; } // Deletes a photo and its metadata. @@ -115,7 +132,9 @@ service StreetViewPublishService { // photo. // * `NOT_FOUND` if the photo ID does not exist. rpc DeletePhoto(DeletePhotoRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { delete: "/v1/photo/{photo_id}" }; + option (google.api.http) = { + delete: "/v1/photo/{photo_id}" + }; } // Deletes a list of photos and their metadata. @@ -126,7 +145,11 @@ service StreetViewPublishService { // failures for single photos in the batch. These failures will be specified // in `BatchDeletePhotosResponse.status`. // See `photo.update` for specific failures that will occur per photo. - rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse) { - option (google.api.http) = { post: "/v1/photos:batchDelete" body: "*" }; + rpc BatchDeletePhotos(BatchDeletePhotosRequest) + returns (BatchDeletePhotosResponse) { + option (google.api.http) = { + post: "/v1/photos:batchDelete" + body: "*" + }; } }