AIP-235

Batch methods: Delete

Some APIs need to allow users to delete a set of resources in a single transaction. A batch delete method provides this functionality.

Guidance

APIs may support Batch Delete using the following two patterns:

Returning the response synchronously

rpc BatchDeleteBooks(BatchDeleteBooksRequest) returns (google.protobuf.Empty) {
  option (google.api.http) = {
    post: "/v1/{parent=publishers/*}/books:batchDelete"
    body: "*"
  };
}

Returning an Operation which resolves to the response asynchronously

rpc BatchDeleteBooks(BatchDeleteBooksRequest) returns (google.longrunning.Operation) {