Synchronize new proto/yaml changes.
PiperOrigin-RevId: 236171707
This commit is contained in:
Google APIs
Copybara-Service
parent
4d13d7a80e
commit
eae7fe03e6
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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: "*"
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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):
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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: "*"
|
||||
|
|
|
|||
|
|
@ -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: "*"
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
//
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
}
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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 {
|
|||
// <b>BETA:</b> 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
|
||||
// <a href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
|
||||
// <a
|
||||
// href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
|
||||
// Seek to a timestamp</a>.
|
||||
// <br><br>
|
||||
// <b>BETA:</b> This feature is part of a beta release. This API might be
|
||||
|
|
@ -872,9 +880,9 @@ message StreamingPullResponse {
|
|||
}
|
||||
|
||||
// Request for the `CreateSnapshot` method.<br><br>
|
||||
// <b>BETA:</b> 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.
|
||||
// <b>BETA:</b> 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 {}
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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/<URL-path>` 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/<URL-path>` is
|
||||
// transferred to a data sink, the name of the object at the data sink is
|
||||
// `<hostname>/<URL-path>`.
|
||||
//
|
||||
// * 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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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: "*"
|
||||
};
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in New Issue