diff --git a/google/cloud/bigquery/datatransfer/v1/datatransfer.proto b/google/cloud/bigquery/datatransfer/v1/datatransfer.proto index 313790f3..54825611 100644 --- a/google/cloud/bigquery/datatransfer/v1/datatransfer.proto +++ b/google/cloud/bigquery/datatransfer/v1/datatransfer.proto @@ -31,6 +31,7 @@ option java_outer_classname = "DataTransferProto"; option java_package = "com.google.cloud.bigquery.datatransfer.v1"; option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1"; + // The Google BigQuery Data Transfer Service API enables BigQuery users to // configure the transfer of their data from other Google Products into BigQuery. // This service contains methods that are end user exposed. It backs up the @@ -41,44 +42,56 @@ service DataTransferService { rpc GetDataSource(GetDataSourceRequest) returns (DataSource) { option (google.api.http) = { get: "/v1/{name=projects/*/locations/*/dataSources/*}" + additional_bindings { + get: "/v1/{name=projects/*/dataSources/*}" + } }; } // Lists supported data sources and returns their settings, // which can be used for UI rendering. - rpc ListDataSources(ListDataSourcesRequest) - returns (ListDataSourcesResponse) { + rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse) { option (google.api.http) = { get: "/v1/{parent=projects/*/locations/*}/dataSources" + additional_bindings { + get: "/v1/{parent=projects/*}/dataSources" + } }; } // Creates a new data transfer configuration. - rpc CreateTransferConfig(CreateTransferConfigRequest) - returns (TransferConfig) { + rpc CreateTransferConfig(CreateTransferConfigRequest) returns (TransferConfig) { option (google.api.http) = { post: "/v1/{parent=projects/*/locations/*}/transferConfigs" body: "transfer_config" + additional_bindings { + post: "/v1/{parent=projects/*}/transferConfigs" + body: "transfer_config" + } }; } // Updates a data transfer configuration. // All fields must be set, even if they are not updated. - rpc UpdateTransferConfig(UpdateTransferConfigRequest) - returns (TransferConfig) { + rpc UpdateTransferConfig(UpdateTransferConfigRequest) returns (TransferConfig) { option (google.api.http) = { - patch: - "/v1/{transfer_config.name=projects/*/locations/*/transferConfigs/*}" + patch: "/v1/{transfer_config.name=projects/*/locations/*/transferConfigs/*}" body: "transfer_config" + additional_bindings { + patch: "/v1/{transfer_config.name=projects/*/transferConfigs/*}" + body: "transfer_config" + } }; } // Deletes a data transfer configuration, // including any associated transfer runs and logs. - rpc DeleteTransferConfig(DeleteTransferConfigRequest) - returns (google.protobuf.Empty) { + rpc DeleteTransferConfig(DeleteTransferConfigRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=projects/*/locations/*/transferConfigs/*}" + additional_bindings { + delete: "/v1/{name=projects/*/transferConfigs/*}" + } }; } @@ -86,14 +99,19 @@ service DataTransferService { rpc GetTransferConfig(GetTransferConfigRequest) returns (TransferConfig) { option (google.api.http) = { get: "/v1/{name=projects/*/locations/*/transferConfigs/*}" + additional_bindings { + get: "/v1/{name=projects/*/transferConfigs/*}" + } }; } // Returns information about all data transfers in the project. - rpc ListTransferConfigs(ListTransferConfigsRequest) - returns (ListTransferConfigsResponse) { + rpc ListTransferConfigs(ListTransferConfigsRequest) returns (ListTransferConfigsResponse) { option (google.api.http) = { get: "/v1/{parent=projects/*/locations/*}/transferConfigs" + additional_bindings { + get: "/v1/{parent=projects/*}/transferConfigs" + } }; } @@ -101,11 +119,14 @@ service DataTransferService { // For each date - or whatever granularity the data source supports - in the // range, one transfer run is created. // Note that runs are created per UTC time in the time range. - rpc ScheduleTransferRuns(ScheduleTransferRunsRequest) - returns (ScheduleTransferRunsResponse) { + rpc ScheduleTransferRuns(ScheduleTransferRunsRequest) returns (ScheduleTransferRunsResponse) { option (google.api.http) = { post: "/v1/{parent=projects/*/locations/*/transferConfigs/*}:scheduleRuns" body: "*" + additional_bindings { + post: "/v1/{parent=projects/*/transferConfigs/*}:scheduleRuns" + body: "*" + } }; } @@ -113,31 +134,39 @@ service DataTransferService { rpc GetTransferRun(GetTransferRunRequest) returns (TransferRun) { option (google.api.http) = { get: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}" + additional_bindings { + get: "/v1/{name=projects/*/transferConfigs/*/runs/*}" + } }; } // Deletes the specified transfer run. - rpc DeleteTransferRun(DeleteTransferRunRequest) - returns (google.protobuf.Empty) { + rpc DeleteTransferRun(DeleteTransferRunRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}" + additional_bindings { + delete: "/v1/{name=projects/*/transferConfigs/*/runs/*}" + } }; } // Returns information about running and completed jobs. - rpc ListTransferRuns(ListTransferRunsRequest) - returns (ListTransferRunsResponse) { + rpc ListTransferRuns(ListTransferRunsRequest) returns (ListTransferRunsResponse) { option (google.api.http) = { get: "/v1/{parent=projects/*/locations/*/transferConfigs/*}/runs" + additional_bindings { + get: "/v1/{parent=projects/*/transferConfigs/*}/runs" + } }; } // Returns user facing log messages for the data transfer run. - rpc ListTransferLogs(ListTransferLogsRequest) - returns (ListTransferLogsResponse) { + rpc ListTransferLogs(ListTransferLogsRequest) returns (ListTransferLogsResponse) { option (google.api.http) = { - get: "/v1/{parent=projects/*/locations/*/transferConfigs/*/runs/*}/" - "transferLogs" + get: "/v1/{parent=projects/*/locations/*/transferConfigs/*/runs/*}/transferLogs" + additional_bindings { + get: "/v1/{parent=projects/*/transferConfigs/*/runs/*}/transferLogs" + } }; } @@ -147,11 +176,14 @@ service DataTransferService { // them on behalf of the end user. This API just checks whether we have OAuth // token for the particular user, which is a pre-requisite before user can // create a transfer config. - rpc CheckValidCreds(CheckValidCredsRequest) - returns (CheckValidCredsResponse) { + rpc CheckValidCreds(CheckValidCredsRequest) returns (CheckValidCredsResponse) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/dataSources/*}:checkValidCreds" body: "*" + additional_bindings { + post: "/v1/{name=projects/*/dataSources/*}:checkValidCreds" + body: "*" + } }; } } @@ -269,7 +301,7 @@ message DataSource { CUSTOM_SLIDING_WINDOW = 2; } - // Data source resource name. + // Output only. Data source resource name. string name = 1; // Data source id. @@ -291,9 +323,7 @@ message DataSource { // e.g., https://www.googleapis.com/auth/bigquery repeated string scopes = 6; - // Transfer type. Currently supports only batch transfers, - // which are transfers that use the BigQuery batch APIs (load or - // query) to ingest the data. + // Deprecated. This field has no effect. TransferType transfer_type = 7; // Indicates whether the data source supports multiple transfers diff --git a/google/cloud/bigquery/datatransfer/v1/transfer.proto b/google/cloud/bigquery/datatransfer/v1/transfer.proto index 7c4d3d63..0cadeed5 100644 --- a/google/cloud/bigquery/datatransfer/v1/transfer.proto +++ b/google/cloud/bigquery/datatransfer/v1/transfer.proto @@ -29,13 +29,13 @@ option java_package = "com.google.cloud.bigquery.datatransfer.v1"; option objc_class_prefix = "GCBDT"; option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1"; + // Represents a data transfer configuration. A transfer configuration // contains all metadata needed to perform a data transfer. For example, // `destination_dataset_id` specifies where data should be stored. // When a new transfer configuration is created, the specified // `destination_dataset_id` is created when needed and shared with the // appropriate data source service account. -// Next id: 20 message TransferConfig { // The resource name of the transfer config. // Transfer config names have the form @@ -104,7 +104,6 @@ message TransferConfig { } // Represents a data transfer run. -// Next id: 27 message TransferRun { // The resource name of the transfer run. // Transfer run names have the form @@ -187,7 +186,7 @@ message TransferMessage { string message_text = 3; } -// Represents data transfer type. +// DEPRECATED. Represents data transfer type. enum TransferType { // Invalid or Unknown transfer type placeholder. TRANSFER_TYPE_UNSPECIFIED = 0; diff --git a/google/cloud/location/location.yaml b/google/cloud/location/location.yaml index 56d80a0f..901d8764 100644 --- a/google/cloud/location/location.yaml +++ b/google/cloud/location/location.yaml @@ -1,7 +1,7 @@ type: google.api.Service config_version: 1 name: cloudlocations.googleapis.com -title: Google Cloud Location API +title: Cloud Location API apis: - name: google.cloud.location.Locations @@ -11,4 +11,5 @@ documentation: # Google Cloud Locations API This package contains the definition of an abstract interface that manages - locations within API services. + locations within API services. See + cs/symbol:google.cloud.location.Locations for details. diff --git a/google/cloud/location/locations.proto b/google/cloud/location/locations.proto index b8f9706a..c5f101ed 100644 --- a/google/cloud/location/locations.proto +++ b/google/cloud/location/locations.proto @@ -1,4 +1,4 @@ -// Copyright 2017 Google Inc. +// Copyright 2018 Google Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -32,12 +32,16 @@ option java_package = "com.google.cloud.location"; service Locations { // Lists information about the supported locations for this service. rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse) { - option (google.api.http) = { get: "/v1/{name=projects/*}/locations" }; + option (google.api.http) = { + get: "/v1/{name=projects/*}/locations" + }; } - // Get information about a location. + // Gets information about a location. rpc GetLocation(GetLocationRequest) returns (Location) { - option (google.api.http) = { get: "/v1/{name=projects/*/locations/*}" }; + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*}" + }; } } @@ -80,6 +84,10 @@ message Location { // The canonical id for this location. For example: `"us-east1"`. string location_id = 4; + // The friendly name for this location, typically a nearby city name. + // For example, "Tokyo". + string display_name = 5; + // Cross-service attributes for the location. For example // // {"cloud.googleapis.com/region": "us-east1"}