google-cloud-bigquery-data_exchange-v1beta1 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cb6ca512429a91e96ba8f02e79abaaa1f9d8a8dce411b7506b85e235fdaf955f
4
- data.tar.gz: f727a1d1a3a4f3b499d8f4d4172851ef4c75c21e390863ede8b2731394d4da0c
3
+ metadata.gz: 3874fbc3659f24b45cf545e8fcd244c912fe231a7d3f8389269ccb0bba17953c
4
+ data.tar.gz: 2941ed366a98bc11da0792a00fb4580e12f4b710aee573281647370d3d025c49
5
5
  SHA512:
6
- metadata.gz: bc17acc0fc11afa749339b916da275737ee2ced1be627f064061053ed6103d5cf5e49df04bd6243f59a57ae6e846553501a5344ac9c41158c0417ce78d144cce
7
- data.tar.gz: c6a3a2dc1802abe5669398d8e4c82e35567507999b652a8169973d4401090bbdc5531cc7ce8d0f9daf2cf71f69ee0d5673f5cb0938d115ed4cb3e305ddd6cf43
6
+ metadata.gz: 48a322c1d747430dd3df857e2931968938eec037248e80b5e0c5c95d3b8d61125a909aa6c16d1cffb37079555512266cac7cc4e3dbd54fc8e8aaae485f3a7c69
7
+ data.tar.gz: 8e74bef2d0f1588b8a5ea29513944dc27ad608c8376b777b7d229314c04acb176a7a8f8d0215c6fbbda9db49be6545d464124b603c979ba9f9797142620185d4
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/bigquery/dataexchange/v1beta1/dataexchange_pb"
21
+ require "google/cloud/location"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -28,11 +29,12 @@ module Google
28
29
  ##
29
30
  # Client for the AnalyticsHubService service.
30
31
  #
31
- # The AnalyticsHubService API facilitates data sharing within and across
32
- # organizations. It allows data providers to publish Listings --- a
33
- # discoverable and searchable SKU representing a dataset. Data consumers can
34
- # subscribe to Listings. Upon subscription, AnalyticsHub provisions a "Linked
35
- # Datasets" surfacing the data in the consumer's project.
32
+ # The `AnalyticsHubService` API facilitates data sharing within and across
33
+ # organizations. It allows data providers to publish listings that reference
34
+ # shared datasets. With Analytics Hub, users can discover and search for
35
+ # listings that they have access to. Subscribers can view and subscribe to
36
+ # listings. When you subscribe to a listing, Analytics Hub creates a linked
37
+ # dataset in your project.
36
38
  #
37
39
  class Client
38
40
  include Paths
@@ -143,6 +145,12 @@ module Google
143
145
  @quota_project_id = @config.quota_project
144
146
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
145
147
 
148
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
149
+ config.credentials = credentials
150
+ config.quota_project = @quota_project_id
151
+ config.endpoint = @config.endpoint
152
+ end
153
+
146
154
  @analytics_hub_service_stub = ::Gapic::ServiceStub.new(
147
155
  ::Google::Cloud::Bigquery::DataExchange::V1beta1::AnalyticsHubService::Stub,
148
156
  credentials: credentials,
@@ -152,10 +160,17 @@ module Google
152
160
  )
153
161
  end
154
162
 
163
+ ##
164
+ # Get the associated client for mix-in of the Locations.
165
+ #
166
+ # @return [Google::Cloud::Location::Locations::Client]
167
+ #
168
+ attr_reader :location_client
169
+
155
170
  # Service calls
156
171
 
157
172
  ##
158
- # Lists DataExchanges in a given project and location.
173
+ # Lists all data exchanges in a given project and location.
159
174
  #
160
175
  # @overload list_data_exchanges(request, options = nil)
161
176
  # Pass arguments to `list_data_exchanges` via a request object, either of type
@@ -173,7 +188,7 @@ module Google
173
188
  # the default parameter values, pass an empty Hash as a request object (see above).
174
189
  #
175
190
  # @param parent [::String]
176
- # Required. The parent resource path of the DataExchanges.
191
+ # Required. The parent resource path of the data exchanges.
177
192
  # e.g. `projects/myproject/locations/US`.
178
193
  # @param page_size [::Integer]
179
194
  # The maximum number of results to return in a single response page. Leverage
@@ -254,7 +269,8 @@ module Google
254
269
  end
255
270
 
256
271
  ##
257
- # Lists DataExchanges from projects in a given organization and location.
272
+ # Lists all data exchanges from projects in a given organization and
273
+ # location.
258
274
  #
259
275
  # @overload list_org_data_exchanges(request, options = nil)
260
276
  # Pass arguments to `list_org_data_exchanges` via a request object, either of type
@@ -353,7 +369,7 @@ module Google
353
369
  end
354
370
 
355
371
  ##
356
- # Gets details of a single DataExchange.
372
+ # Gets the details of a data exchange.
357
373
  #
358
374
  # @overload get_data_exchange(request, options = nil)
359
375
  # Pass arguments to `get_data_exchange` via a request object, either of type
@@ -371,7 +387,7 @@ module Google
371
387
  # the default parameter values, pass an empty Hash as a request object (see above).
372
388
  #
373
389
  # @param name [::String]
374
- # Required. The resource name of the DataExchange.
390
+ # Required. The resource name of the data exchange.
375
391
  # e.g. `projects/myproject/locations/US/dataExchanges/123`.
376
392
  #
377
393
  # @yield [response, operation] Access the result along with the RPC operation
@@ -439,7 +455,7 @@ module Google
439
455
  end
440
456
 
441
457
  ##
442
- # Creates a new DataExchange in a given project and location.
458
+ # Creates a new data exchange.
443
459
  #
444
460
  # @overload create_data_exchange(request, options = nil)
445
461
  # Pass arguments to `create_data_exchange` via a request object, either of type
@@ -457,16 +473,16 @@ module Google
457
473
  # the default parameter values, pass an empty Hash as a request object (see above).
458
474
  #
459
475
  # @param parent [::String]
460
- # Required. The parent resource path of the DataExchange.
476
+ # Required. The parent resource path of the data exchange.
461
477
  # e.g. `projects/myproject/locations/US`.
462
478
  # @param data_exchange_id [::String]
463
- # Required. The ID of the DataExchange to create.
479
+ # Required. The ID of the data exchange.
464
480
  # Must contain only Unicode letters, numbers (0-9), underscores (_).
465
481
  # Should not use characters that require URL-escaping, or characters
466
482
  # outside of ASCII, spaces.
467
483
  # Max length: 100 bytes.
468
484
  # @param data_exchange [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange, ::Hash]
469
- # Required. The DataExchange to create.
485
+ # Required. The data exchange to create.
470
486
  #
471
487
  # @yield [response, operation] Access the result along with the RPC operation
472
488
  # @yieldparam response [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange]
@@ -533,7 +549,7 @@ module Google
533
549
  end
534
550
 
535
551
  ##
536
- # Updates the parameters of a single DataExchange.
552
+ # Updates an existing data exchange.
537
553
  #
538
554
  # @overload update_data_exchange(request, options = nil)
539
555
  # Pass arguments to `update_data_exchange` via a request object, either of type
@@ -551,12 +567,11 @@ module Google
551
567
  # the default parameter values, pass an empty Hash as a request object (see above).
552
568
  #
553
569
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
554
- # Required. Field mask is used to specify the fields to be overwritten in the
555
- # DataExchange resource by the update.
556
- # The fields specified in the update_mask are relative to the resource, not
557
- # the full request.
570
+ # Required. Field mask specifies the fields to update in the data exchange
571
+ # resource. The fields specified in the
572
+ # `updateMask` are relative to the resource and are not a full request.
558
573
  # @param data_exchange [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange, ::Hash]
559
- # Required. The DataExchange to update.
574
+ # Required. The data exchange to update.
560
575
  #
561
576
  # @yield [response, operation] Access the result along with the RPC operation
562
577
  # @yieldparam response [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange]
@@ -623,7 +638,7 @@ module Google
623
638
  end
624
639
 
625
640
  ##
626
- # Deletes a single DataExchange.
641
+ # Deletes an existing data exchange.
627
642
  #
628
643
  # @overload delete_data_exchange(request, options = nil)
629
644
  # Pass arguments to `delete_data_exchange` via a request object, either of type
@@ -641,8 +656,8 @@ module Google
641
656
  # the default parameter values, pass an empty Hash as a request object (see above).
642
657
  #
643
658
  # @param name [::String]
644
- # Required. Resource name of the DataExchange to delete.
645
- # e.g. `projects/myproject/locations/US/dataExchanges/123`.
659
+ # Required. The full name of the data exchange resource that you want to delete.
660
+ # For example, `projects/myproject/locations/US/dataExchanges/123`.
646
661
  #
647
662
  # @yield [response, operation] Access the result along with the RPC operation
648
663
  # @yieldparam response [::Google::Protobuf::Empty]
@@ -709,7 +724,7 @@ module Google
709
724
  end
710
725
 
711
726
  ##
712
- # Lists Listings in a given project and location.
727
+ # Lists all listings in a given project and location.
713
728
  #
714
729
  # @overload list_listings(request, options = nil)
715
730
  # Pass arguments to `list_listings` via a request object, either of type
@@ -808,7 +823,7 @@ module Google
808
823
  end
809
824
 
810
825
  ##
811
- # Gets details of a single Listing.
826
+ # Gets the details of a listing.
812
827
  #
813
828
  # @overload get_listing(request, options = nil)
814
829
  # Pass arguments to `get_listing` via a request object, either of type
@@ -894,7 +909,7 @@ module Google
894
909
  end
895
910
 
896
911
  ##
897
- # Creates a new Listing in a given project and location.
912
+ # Creates a new listing.
898
913
  #
899
914
  # @overload create_listing(request, options = nil)
900
915
  # Pass arguments to `create_listing` via a request object, either of type
@@ -915,7 +930,7 @@ module Google
915
930
  # Required. The parent resource path of the listing.
916
931
  # e.g. `projects/myproject/locations/US/dataExchanges/123`.
917
932
  # @param listing_id [::String]
918
- # Required. The ID of the Listing to create.
933
+ # Required. The ID of the listing to create.
919
934
  # Must contain only Unicode letters, numbers (0-9), underscores (_).
920
935
  # Should not use characters that require URL-escaping, or characters
921
936
  # outside of ASCII, spaces.
@@ -988,7 +1003,7 @@ module Google
988
1003
  end
989
1004
 
990
1005
  ##
991
- # Updates the parameters of a single Listing.
1006
+ # Updates an existing listing.
992
1007
  #
993
1008
  # @overload update_listing(request, options = nil)
994
1009
  # Pass arguments to `update_listing` via a request object, either of type
@@ -1006,10 +1021,9 @@ module Google
1006
1021
  # the default parameter values, pass an empty Hash as a request object (see above).
1007
1022
  #
1008
1023
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1009
- # Required. Field mask is used to specify the fields to be overwritten in the
1010
- # Listing resource by the update.
1011
- # The fields specified in the update_mask are relative to the resource, not
1012
- # the full request.
1024
+ # Required. Field mask specifies the fields to update in the listing resource. The
1025
+ # fields specified in the `updateMask` are relative to the resource and are
1026
+ # not a full request.
1013
1027
  # @param listing [::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing, ::Hash]
1014
1028
  # Required. The listing to update.
1015
1029
  #
@@ -1078,8 +1092,7 @@ module Google
1078
1092
  end
1079
1093
 
1080
1094
  ##
1081
- # Deletes a single Listing, as long as there are no subscriptions
1082
- # associated with the source of this Listing.
1095
+ # Deletes a listing.
1083
1096
  #
1084
1097
  # @overload delete_listing(request, options = nil)
1085
1098
  # Pass arguments to `delete_listing` via a request object, either of type
@@ -1165,10 +1178,11 @@ module Google
1165
1178
  end
1166
1179
 
1167
1180
  ##
1168
- # Subscribes to a single Listing.
1181
+ # Subscribes to a listing.
1169
1182
  #
1170
- # Data Exchange currently supports one type of Listing: a BigQuery dataset.
1171
- # Upon subscription to a Listing for a BigQuery dataset, Data Exchange
1183
+ # Currently, with Analytics Hub, you can create listings that
1184
+ # reference only BigQuery datasets.
1185
+ # Upon subscription to a listing for a BigQuery dataset, Analytics Hub
1172
1186
  # creates a linked dataset in the subscriber's project.
1173
1187
  #
1174
1188
  # @overload subscribe_listing(request, options = nil)
@@ -1181,16 +1195,16 @@ module Google
1181
1195
  # @param options [::Gapic::CallOptions, ::Hash]
1182
1196
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1183
1197
  #
1184
- # @overload subscribe_listing(name: nil, destination_dataset: nil)
1198
+ # @overload subscribe_listing(destination_dataset: nil, name: nil)
1185
1199
  # Pass arguments to `subscribe_listing` via keyword arguments. Note that at
1186
1200
  # least one keyword argument is required. To specify no parameters, or to keep all
1187
1201
  # the default parameter values, pass an empty Hash as a request object (see above).
1188
1202
  #
1189
- # @param name [::String]
1190
- # Required. Resource name of the listing to subscribe to.
1191
- # e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
1192
1203
  # @param destination_dataset [::Google::Cloud::Bigquery::DataExchange::V1beta1::DestinationDataset, ::Hash]
1193
1204
  # BigQuery destination dataset to create for the subscriber.
1205
+ # @param name [::String]
1206
+ # Required. Resource name of the listing that you want to subscribe to.
1207
+ # e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
1194
1208
  #
1195
1209
  # @yield [response, operation] Access the result along with the RPC operation
1196
1210
  # @yieldparam response [::Google::Cloud::Bigquery::DataExchange::V1beta1::SubscribeListingResponse]
@@ -1257,7 +1271,7 @@ module Google
1257
1271
  end
1258
1272
 
1259
1273
  ##
1260
- # Gets the IAM policy for a dataExchange or a listing.
1274
+ # Gets the IAM policy.
1261
1275
  #
1262
1276
  # @overload get_iam_policy(request, options = nil)
1263
1277
  # Pass arguments to `get_iam_policy` via a request object, either of type
@@ -1346,7 +1360,7 @@ module Google
1346
1360
  end
1347
1361
 
1348
1362
  ##
1349
- # Sets the IAM policy for a dataExchange or a listing.
1363
+ # Sets the IAM policy.
1350
1364
  #
1351
1365
  # @overload set_iam_policy(request, options = nil)
1352
1366
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -1443,8 +1457,7 @@ module Google
1443
1457
  end
1444
1458
 
1445
1459
  ##
1446
- # Returns the permissions that a caller has on a specified dataExchange or
1447
- # listing.
1460
+ # Returns the permissions that a caller has.
1448
1461
  #
1449
1462
  # @overload test_iam_permissions(request, options = nil)
1450
1463
  # Pass arguments to `test_iam_permissions` via a request object, either of type
@@ -32,11 +32,12 @@ module Google
32
32
  module DataExchange
33
33
  module V1beta1
34
34
  ##
35
- # The AnalyticsHubService API facilitates data sharing within and across
36
- # organizations. It allows data providers to publish Listings --- a
37
- # discoverable and searchable SKU representing a dataset. Data consumers can
38
- # subscribe to Listings. Upon subscription, AnalyticsHub provisions a "Linked
39
- # Datasets" surfacing the data in the consumer's project.
35
+ # The `AnalyticsHubService` API facilitates data sharing within and across
36
+ # organizations. It allows data providers to publish listings that reference
37
+ # shared datasets. With Analytics Hub, users can discover and search for
38
+ # listings that they have access to. Subscribers can view and subscribe to
39
+ # listings. When you subscribe to a listing, Analytics Hub creates a linked
40
+ # dataset in your project.
40
41
  #
41
42
  # To load this service and instantiate a client:
42
43
  #
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module DataExchange
24
24
  module V1beta1
25
- VERSION = "0.2.0"
25
+ VERSION = "0.3.0"
26
26
  end
27
27
  end
28
28
  end
@@ -7,7 +7,6 @@ require 'google/api/annotations_pb'
7
7
  require 'google/api/client_pb'
8
8
  require 'google/api/field_behavior_pb'
9
9
  require 'google/api/resource_pb'
10
- require 'google/cloud/bigquery/dataexchange/common/common_pb'
11
10
  require 'google/iam/v1/iam_policy_pb'
12
11
  require 'google/iam/v1/policy_pb'
13
12
  require 'google/protobuf/empty_pb'
@@ -53,7 +52,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
53
52
  optional :state, :enum, 7, "google.cloud.bigquery.dataexchange.v1beta1.Listing.State"
54
53
  optional :icon, :bytes, 8
55
54
  optional :data_provider, :message, 9, "google.cloud.bigquery.dataexchange.v1beta1.DataProvider"
56
- repeated :categories, :enum, 10, "google.cloud.bigquery.dataexchange.common.Category"
55
+ repeated :categories, :enum, 10, "google.cloud.bigquery.dataexchange.v1beta1.Listing.Category"
57
56
  optional :publisher, :message, 11, "google.cloud.bigquery.dataexchange.v1beta1.Publisher"
58
57
  optional :request_access, :string, 12
59
58
  oneof :source do
@@ -67,6 +66,28 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
67
66
  value :STATE_UNSPECIFIED, 0
68
67
  value :ACTIVE, 1
69
68
  end
69
+ add_enum "google.cloud.bigquery.dataexchange.v1beta1.Listing.Category" do
70
+ value :CATEGORY_UNSPECIFIED, 0
71
+ value :CATEGORY_OTHERS, 1
72
+ value :CATEGORY_ADVERTISING_AND_MARKETING, 2
73
+ value :CATEGORY_COMMERCE, 3
74
+ value :CATEGORY_CLIMATE_AND_ENVIRONMENT, 4
75
+ value :CATEGORY_DEMOGRAPHICS, 5
76
+ value :CATEGORY_ECONOMICS, 6
77
+ value :CATEGORY_EDUCATION, 7
78
+ value :CATEGORY_ENERGY, 8
79
+ value :CATEGORY_FINANCIAL, 9
80
+ value :CATEGORY_GAMING, 10
81
+ value :CATEGORY_GEOSPATIAL, 11
82
+ value :CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE, 12
83
+ value :CATEGORY_MEDIA, 13
84
+ value :CATEGORY_PUBLIC_SECTOR, 14
85
+ value :CATEGORY_RETAIL, 15
86
+ value :CATEGORY_SPORTS, 16
87
+ value :CATEGORY_SCIENCE_AND_RESEARCH, 17
88
+ value :CATEGORY_TRANSPORTATION_AND_LOGISTICS, 18
89
+ value :CATEGORY_TRAVEL_AND_TOURISM, 19
90
+ end
70
91
  add_message "google.cloud.bigquery.dataexchange.v1beta1.ListDataExchangesRequest" do
71
92
  optional :parent, :string, 1
72
93
  optional :page_size, :int32, 2
@@ -148,6 +169,7 @@ module Google
148
169
  Listing = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.Listing").msgclass
149
170
  Listing::BigQueryDatasetSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.Listing.BigQueryDatasetSource").msgclass
150
171
  Listing::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.Listing.State").enummodule
172
+ Listing::Category = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.Listing.Category").enummodule
151
173
  ListDataExchangesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.ListDataExchangesRequest").msgclass
152
174
  ListDataExchangesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.ListDataExchangesResponse").msgclass
153
175
  ListOrgDataExchangesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.v1beta1.ListOrgDataExchangesRequest").msgclass
@@ -25,11 +25,12 @@ module Google
25
25
  module DataExchange
26
26
  module V1beta1
27
27
  module AnalyticsHubService
28
- # The AnalyticsHubService API facilitates data sharing within and across
29
- # organizations. It allows data providers to publish Listings --- a
30
- # discoverable and searchable SKU representing a dataset. Data consumers can
31
- # subscribe to Listings. Upon subscription, AnalyticsHub provisions a "Linked
32
- # Datasets" surfacing the data in the consumer's project.
28
+ # The `AnalyticsHubService` API facilitates data sharing within and across
29
+ # organizations. It allows data providers to publish listings that reference
30
+ # shared datasets. With Analytics Hub, users can discover and search for
31
+ # listings that they have access to. Subscribers can view and subscribe to
32
+ # listings. When you subscribe to a listing, Analytics Hub creates a linked
33
+ # dataset in your project.
33
34
  class Service
34
35
 
35
36
  include ::GRPC::GenericService
@@ -38,41 +39,41 @@ module Google
38
39
  self.unmarshal_class_method = :decode
39
40
  self.service_name = 'google.cloud.bigquery.dataexchange.v1beta1.AnalyticsHubService'
40
41
 
41
- # Lists DataExchanges in a given project and location.
42
+ # Lists all data exchanges in a given project and location.
42
43
  rpc :ListDataExchanges, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListDataExchangesRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListDataExchangesResponse
43
- # Lists DataExchanges from projects in a given organization and location.
44
+ # Lists all data exchanges from projects in a given organization and
45
+ # location.
44
46
  rpc :ListOrgDataExchanges, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListOrgDataExchangesRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListOrgDataExchangesResponse
45
- # Gets details of a single DataExchange.
47
+ # Gets the details of a data exchange.
46
48
  rpc :GetDataExchange, ::Google::Cloud::Bigquery::DataExchange::V1beta1::GetDataExchangeRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange
47
- # Creates a new DataExchange in a given project and location.
49
+ # Creates a new data exchange.
48
50
  rpc :CreateDataExchange, ::Google::Cloud::Bigquery::DataExchange::V1beta1::CreateDataExchangeRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange
49
- # Updates the parameters of a single DataExchange.
51
+ # Updates an existing data exchange.
50
52
  rpc :UpdateDataExchange, ::Google::Cloud::Bigquery::DataExchange::V1beta1::UpdateDataExchangeRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange
51
- # Deletes a single DataExchange.
53
+ # Deletes an existing data exchange.
52
54
  rpc :DeleteDataExchange, ::Google::Cloud::Bigquery::DataExchange::V1beta1::DeleteDataExchangeRequest, ::Google::Protobuf::Empty
53
- # Lists Listings in a given project and location.
55
+ # Lists all listings in a given project and location.
54
56
  rpc :ListListings, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListListingsRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::ListListingsResponse
55
- # Gets details of a single Listing.
57
+ # Gets the details of a listing.
56
58
  rpc :GetListing, ::Google::Cloud::Bigquery::DataExchange::V1beta1::GetListingRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing
57
- # Creates a new Listing in a given project and location.
59
+ # Creates a new listing.
58
60
  rpc :CreateListing, ::Google::Cloud::Bigquery::DataExchange::V1beta1::CreateListingRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing
59
- # Updates the parameters of a single Listing.
61
+ # Updates an existing listing.
60
62
  rpc :UpdateListing, ::Google::Cloud::Bigquery::DataExchange::V1beta1::UpdateListingRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing
61
- # Deletes a single Listing, as long as there are no subscriptions
62
- # associated with the source of this Listing.
63
+ # Deletes a listing.
63
64
  rpc :DeleteListing, ::Google::Cloud::Bigquery::DataExchange::V1beta1::DeleteListingRequest, ::Google::Protobuf::Empty
64
- # Subscribes to a single Listing.
65
+ # Subscribes to a listing.
65
66
  #
66
- # Data Exchange currently supports one type of Listing: a BigQuery dataset.
67
- # Upon subscription to a Listing for a BigQuery dataset, Data Exchange
67
+ # Currently, with Analytics Hub, you can create listings that
68
+ # reference only BigQuery datasets.
69
+ # Upon subscription to a listing for a BigQuery dataset, Analytics Hub
68
70
  # creates a linked dataset in the subscriber's project.
69
71
  rpc :SubscribeListing, ::Google::Cloud::Bigquery::DataExchange::V1beta1::SubscribeListingRequest, ::Google::Cloud::Bigquery::DataExchange::V1beta1::SubscribeListingResponse
70
- # Gets the IAM policy for a dataExchange or a listing.
72
+ # Gets the IAM policy.
71
73
  rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
72
- # Sets the IAM policy for a dataExchange or a listing.
74
+ # Sets the IAM policy.
73
75
  rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
74
- # Returns the permissions that a caller has on a specified dataExchange or
75
- # listing.
76
+ # Returns the permissions that a caller has.
76
77
  rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
77
78
  end
78
79
 
@@ -22,9 +22,9 @@ module Google
22
22
  module Bigquery
23
23
  module DataExchange
24
24
  module V1beta1
25
- # A data exchange is a container that enables data sharing.
26
- # It contains a set of listings of the data sources along with descriptive
27
- # information of the data exchange.
25
+ # A data exchange is a container that lets you share data. Along with the
26
+ # descriptive information about the data exchange, it contains listings that
27
+ # reference shared datasets.
28
28
  # @!attribute [r] name
29
29
  # @return [::String]
30
30
  # Output only. The resource name of the data exchange.
@@ -33,21 +33,19 @@ module Google
33
33
  # @return [::String]
34
34
  # Required. Human-readable display name of the data exchange. The display name must
35
35
  # contain only Unicode letters, numbers (0-9), underscores (_), dashes (-),
36
- # spaces ( ), and can't start or end with spaces.
36
+ # spaces ( ), ampersands (&) and must not start or end with spaces.
37
37
  # Default value is an empty string.
38
38
  # Max length: 63 bytes.
39
39
  # @!attribute [rw] description
40
40
  # @return [::String]
41
- # Optional. Short description of the data exchange that can consist of sentences
42
- # or paragraphs. The description must not contain Unicode non-characters as
43
- # well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage
44
- # returns (CR), and page breaks (FF).
41
+ # Optional. Description of the data exchange. The description must not contain Unicode
42
+ # non-characters as well as C0 and C1 control codes except tabs (HT),
43
+ # new lines (LF), carriage returns (CR), and page breaks (FF).
45
44
  # Default value is an empty string.
46
45
  # Max length: 2000 bytes.
47
46
  # @!attribute [rw] primary_contact
48
47
  # @return [::String]
49
- # Optional. Email, URL or other reference of the primary point of contact of the data
50
- # exchange
48
+ # Optional. Email or URL of the primary point of contact of the data exchange.
51
49
  # Max Length: 1000 bytes.
52
50
  # @!attribute [rw] documentation
53
51
  # @return [::String]
@@ -60,40 +58,40 @@ module Google
60
58
  # Optional. Base64 encoded image representing the data exchange. Max Size: 3.0MiB
61
59
  # Expected image dimensions are 512x512 pixels, however the API only
62
60
  # performs validation on size of the encoded data.
63
- # Note: For byte fields, the contents of the field are base64-encoded (which
61
+ # Note: For byte fields, the content of the fields are base64-encoded (which
64
62
  # increases the size of the data by 33-36%) when using JSON on the wire.
65
63
  class DataExchange
66
64
  include ::Google::Protobuf::MessageExts
67
65
  extend ::Google::Protobuf::MessageExts::ClassMethods
68
66
  end
69
67
 
70
- # Contains details of the Data Provider.
68
+ # Contains details of the data provider.
71
69
  # @!attribute [rw] name
72
70
  # @return [::String]
73
- # Optional. Name of the Data Provider.
71
+ # Optional. Name of the data provider.
74
72
  # @!attribute [rw] primary_contact
75
73
  # @return [::String]
76
- # Optional. Email or URL of the Data Provider.
74
+ # Optional. Email or URL of the data provider.
77
75
  # Max Length: 1000 bytes.
78
76
  class DataProvider
79
77
  include ::Google::Protobuf::MessageExts
80
78
  extend ::Google::Protobuf::MessageExts::ClassMethods
81
79
  end
82
80
 
83
- # Contains details of the Publisher.
81
+ # Contains details of the listing publisher.
84
82
  # @!attribute [rw] name
85
83
  # @return [::String]
86
- # Optional. Name of the listing Publisher.
84
+ # Optional. Name of the listing publisher.
87
85
  # @!attribute [rw] primary_contact
88
86
  # @return [::String]
89
- # Optional. Email or URL of the listing Publisher.
87
+ # Optional. Email or URL of the listing publisher.
90
88
  # Max Length: 1000 bytes.
91
89
  class Publisher
92
90
  include ::Google::Protobuf::MessageExts
93
91
  extend ::Google::Protobuf::MessageExts::ClassMethods
94
92
  end
95
93
 
96
- # Defines the Destination BigQuery Dataset Reference.
94
+ # Contains the reference that identifies a destination bigquery dataset.
97
95
  # @!attribute [rw] dataset_id
98
96
  # @return [::String]
99
97
  # Required. A unique ID for this dataset, without the project name. The ID
@@ -107,7 +105,7 @@ module Google
107
105
  extend ::Google::Protobuf::MessageExts::ClassMethods
108
106
  end
109
107
 
110
- # Defines the Destination BigQuery Dataset.
108
+ # Defines the destination bigquery dataset.
111
109
  # @!attribute [rw] dataset_reference
112
110
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::DestinationDatasetReference]
113
111
  # Required. A reference that identifies the destination dataset.
@@ -147,6 +145,9 @@ module Google
147
145
  # subscribe to. It contains a reference to the data source along with
148
146
  # descriptive information that will help subscribers find and subscribe the
149
147
  # data.
148
+ # @!attribute [rw] bigquery_dataset
149
+ # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing::BigQueryDatasetSource]
150
+ # Required. Shared dataset i.e. BigQuery dataset source.
150
151
  # @!attribute [r] name
151
152
  # @return [::String]
152
153
  # Output only. The resource name of the listing.
@@ -155,15 +156,14 @@ module Google
155
156
  # @return [::String]
156
157
  # Required. Human-readable display name of the listing. The display name must contain
157
158
  # only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces
158
- # ( ), and can't start or end with spaces.
159
+ # ( ), ampersands (&) and can't start or end with spaces.
159
160
  # Default value is an empty string.
160
161
  # Max length: 63 bytes.
161
162
  # @!attribute [rw] description
162
163
  # @return [::String]
163
- # Optional. Short description of the listing that can consist of sentences or
164
- # paragraphs. The description must not contain Unicode non-characters as
165
- # well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage
166
- # returns (CR), and page breaks (FF).
164
+ # Optional. Short description of the listing. The description must not contain
165
+ # Unicode non-characters and C0 and C1 control codes except tabs (HT),
166
+ # new lines (LF), carriage returns (CR), and page breaks (FF).
167
167
  # Default value is an empty string.
168
168
  # Max length: 2000 bytes.
169
169
  # @!attribute [rw] primary_contact
@@ -173,12 +173,9 @@ module Google
173
173
  # @!attribute [rw] documentation
174
174
  # @return [::String]
175
175
  # Optional. Documentation describing the listing.
176
- # @!attribute [rw] bigquery_dataset
177
- # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing::BigQueryDatasetSource]
178
- # Required. Shared dataset i.e. BigQuery dataset source.
179
176
  # @!attribute [r] state
180
177
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing::State]
181
- # Output only. Current state of the Listing.
178
+ # Output only. Current state of the listing.
182
179
  # @!attribute [rw] icon
183
180
  # @return [::String]
184
181
  # Optional. Base64 encoded image representing the listing. Max Size: 3.0MiB
@@ -188,13 +185,13 @@ module Google
188
185
  # increases the size of the data by 33-36%) when using JSON on the wire.
189
186
  # @!attribute [rw] data_provider
190
187
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataProvider]
191
- # Optional. The details of the Data Provider who owns the source data.
188
+ # Optional. Details of the data provider who owns the source data.
192
189
  # @!attribute [rw] categories
193
- # @return [::Array<::Google::Cloud::Bigquery::DataExchange::Common::Category>]
194
- # Optional. Categories of the Listing. Up to two categories are allowed.
190
+ # @return [::Array<::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing::Category>]
191
+ # Optional. Categories of the listing. Up to two categories are allowed.
195
192
  # @!attribute [rw] publisher
196
193
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::Publisher]
197
- # Optional. The details of the Publisher who owns the listing and has rights to share
194
+ # Optional. Details of the publisher who owns the listing and who can share
198
195
  # the source data.
199
196
  # @!attribute [rw] request_access
200
197
  # @return [::String]
@@ -205,12 +202,13 @@ module Google
205
202
  include ::Google::Protobuf::MessageExts
206
203
  extend ::Google::Protobuf::MessageExts::ClassMethods
207
204
 
208
- # A reference to a Shared dataset. It's an existing BigQuery dataset with a
209
- # collection of objects, such as tables and views, that you want to share
205
+ # A reference to a shared dataset. It is an existing BigQuery dataset with a
206
+ # collection of objects such as tables and views that you want to share
210
207
  # with subscribers.
211
- # Upon subscription to a Listing, Data Exchange creates a Linked dataset in
208
+ # When subscriber's subscribe to a listing, Analytics Hub creates a linked
209
+ # dataset in
212
210
  # the subscriber's project. A Linked dataset is an opaque, read-only BigQuery
213
- # dataset that serves as a "symbolic link" to a shared dataset.
211
+ # dataset that serves as a _symbolic link_ to a shared dataset.
214
212
  # @!attribute [rw] dataset
215
213
  # @return [::String]
216
214
  # Resource name of the dataset source for this listing.
@@ -220,21 +218,64 @@ module Google
220
218
  extend ::Google::Protobuf::MessageExts::ClassMethods
221
219
  end
222
220
 
223
- # State of the Listing
221
+ # State of the listing.
224
222
  module State
225
223
  # Default value. This value is unused.
226
224
  STATE_UNSPECIFIED = 0
227
225
 
228
226
  # Subscribable state. Users with dataexchange.listings.subscribe permission
229
- # can subscribe to this Listing.
227
+ # can subscribe to this listing.
230
228
  ACTIVE = 1
231
229
  end
230
+
231
+ # Listing categories.
232
+ module Category
233
+ CATEGORY_UNSPECIFIED = 0
234
+
235
+ CATEGORY_OTHERS = 1
236
+
237
+ CATEGORY_ADVERTISING_AND_MARKETING = 2
238
+
239
+ CATEGORY_COMMERCE = 3
240
+
241
+ CATEGORY_CLIMATE_AND_ENVIRONMENT = 4
242
+
243
+ CATEGORY_DEMOGRAPHICS = 5
244
+
245
+ CATEGORY_ECONOMICS = 6
246
+
247
+ CATEGORY_EDUCATION = 7
248
+
249
+ CATEGORY_ENERGY = 8
250
+
251
+ CATEGORY_FINANCIAL = 9
252
+
253
+ CATEGORY_GAMING = 10
254
+
255
+ CATEGORY_GEOSPATIAL = 11
256
+
257
+ CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE = 12
258
+
259
+ CATEGORY_MEDIA = 13
260
+
261
+ CATEGORY_PUBLIC_SECTOR = 14
262
+
263
+ CATEGORY_RETAIL = 15
264
+
265
+ CATEGORY_SPORTS = 16
266
+
267
+ CATEGORY_SCIENCE_AND_RESEARCH = 17
268
+
269
+ CATEGORY_TRANSPORTATION_AND_LOGISTICS = 18
270
+
271
+ CATEGORY_TRAVEL_AND_TOURISM = 19
272
+ end
232
273
  end
233
274
 
234
- # Message for requesting list of DataExchanges.
275
+ # Message for requesting the list of data exchanges.
235
276
  # @!attribute [rw] parent
236
277
  # @return [::String]
237
- # Required. The parent resource path of the DataExchanges.
278
+ # Required. The parent resource path of the data exchanges.
238
279
  # e.g. `projects/myproject/locations/US`.
239
280
  # @!attribute [rw] page_size
240
281
  # @return [::Integer]
@@ -249,10 +290,10 @@ module Google
249
290
  extend ::Google::Protobuf::MessageExts::ClassMethods
250
291
  end
251
292
 
252
- # Message for response to listing DataExchanges.
293
+ # Message for response to the list of data exchanges.
253
294
  # @!attribute [rw] data_exchanges
254
295
  # @return [::Array<::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange>]
255
- # The list of DataExchange.
296
+ # The list of data exchanges.
256
297
  # @!attribute [rw] next_page_token
257
298
  # @return [::String]
258
299
  # A token to request the next page of results.
@@ -261,8 +302,8 @@ module Google
261
302
  extend ::Google::Protobuf::MessageExts::ClassMethods
262
303
  end
263
304
 
264
- # Message for requesting list of DataExchanges from projects in an organization
265
- # and location.
305
+ # Message for requesting the list of data exchanges from projects in an
306
+ # organization and location.
266
307
  # @!attribute [rw] organization
267
308
  # @return [::String]
268
309
  # Required. The organization resource path of the projects containing DataExchanges.
@@ -280,11 +321,11 @@ module Google
280
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
281
322
  end
282
323
 
283
- # Message for response to listing DataExchanges in an organization and
324
+ # Message for response to listing data exchanges in an organization and
284
325
  # location.
285
326
  # @!attribute [rw] data_exchanges
286
327
  # @return [::Array<::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange>]
287
- # The list of DataExchange.
328
+ # The list of data exchanges.
288
329
  # @!attribute [rw] next_page_token
289
330
  # @return [::String]
290
331
  # A token to request the next page of results.
@@ -293,62 +334,61 @@ module Google
293
334
  extend ::Google::Protobuf::MessageExts::ClassMethods
294
335
  end
295
336
 
296
- # Message for getting a DataExchange.
337
+ # Message for getting a data exchange.
297
338
  # @!attribute [rw] name
298
339
  # @return [::String]
299
- # Required. The resource name of the DataExchange.
340
+ # Required. The resource name of the data exchange.
300
341
  # e.g. `projects/myproject/locations/US/dataExchanges/123`.
301
342
  class GetDataExchangeRequest
302
343
  include ::Google::Protobuf::MessageExts
303
344
  extend ::Google::Protobuf::MessageExts::ClassMethods
304
345
  end
305
346
 
306
- # Message for creating a DataExchange.
347
+ # Message for creating a data exchange.
307
348
  # @!attribute [rw] parent
308
349
  # @return [::String]
309
- # Required. The parent resource path of the DataExchange.
350
+ # Required. The parent resource path of the data exchange.
310
351
  # e.g. `projects/myproject/locations/US`.
311
352
  # @!attribute [rw] data_exchange_id
312
353
  # @return [::String]
313
- # Required. The ID of the DataExchange to create.
354
+ # Required. The ID of the data exchange.
314
355
  # Must contain only Unicode letters, numbers (0-9), underscores (_).
315
356
  # Should not use characters that require URL-escaping, or characters
316
357
  # outside of ASCII, spaces.
317
358
  # Max length: 100 bytes.
318
359
  # @!attribute [rw] data_exchange
319
360
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange]
320
- # Required. The DataExchange to create.
361
+ # Required. The data exchange to create.
321
362
  class CreateDataExchangeRequest
322
363
  include ::Google::Protobuf::MessageExts
323
364
  extend ::Google::Protobuf::MessageExts::ClassMethods
324
365
  end
325
366
 
326
- # Message for updating a DataExchange.
367
+ # Message for updating a data exchange.
327
368
  # @!attribute [rw] update_mask
328
369
  # @return [::Google::Protobuf::FieldMask]
329
- # Required. Field mask is used to specify the fields to be overwritten in the
330
- # DataExchange resource by the update.
331
- # The fields specified in the update_mask are relative to the resource, not
332
- # the full request.
370
+ # Required. Field mask specifies the fields to update in the data exchange
371
+ # resource. The fields specified in the
372
+ # `updateMask` are relative to the resource and are not a full request.
333
373
  # @!attribute [rw] data_exchange
334
374
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::DataExchange]
335
- # Required. The DataExchange to update.
375
+ # Required. The data exchange to update.
336
376
  class UpdateDataExchangeRequest
337
377
  include ::Google::Protobuf::MessageExts
338
378
  extend ::Google::Protobuf::MessageExts::ClassMethods
339
379
  end
340
380
 
341
- # Message for deleting a DataExchange.
381
+ # Message for deleting a data exchange.
342
382
  # @!attribute [rw] name
343
383
  # @return [::String]
344
- # Required. Resource name of the DataExchange to delete.
345
- # e.g. `projects/myproject/locations/US/dataExchanges/123`.
384
+ # Required. The full name of the data exchange resource that you want to delete.
385
+ # For example, `projects/myproject/locations/US/dataExchanges/123`.
346
386
  class DeleteDataExchangeRequest
347
387
  include ::Google::Protobuf::MessageExts
348
388
  extend ::Google::Protobuf::MessageExts::ClassMethods
349
389
  end
350
390
 
351
- # Message for requesting list of Listings.
391
+ # Message for requesting the list of listings.
352
392
  # @!attribute [rw] parent
353
393
  # @return [::String]
354
394
  # Required. The parent resource path of the listing.
@@ -366,7 +406,7 @@ module Google
366
406
  extend ::Google::Protobuf::MessageExts::ClassMethods
367
407
  end
368
408
 
369
- # Message for response to listing Listings.
409
+ # Message for response to the list of Listings.
370
410
  # @!attribute [rw] listings
371
411
  # @return [::Array<::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing>]
372
412
  # The list of Listing.
@@ -378,7 +418,7 @@ module Google
378
418
  extend ::Google::Protobuf::MessageExts::ClassMethods
379
419
  end
380
420
 
381
- # Message for getting a Listing.
421
+ # Message for getting a listing.
382
422
  # @!attribute [rw] name
383
423
  # @return [::String]
384
424
  # Required. The resource name of the listing.
@@ -388,14 +428,14 @@ module Google
388
428
  extend ::Google::Protobuf::MessageExts::ClassMethods
389
429
  end
390
430
 
391
- # Message for creating a Listing.
431
+ # Message for creating a listing.
392
432
  # @!attribute [rw] parent
393
433
  # @return [::String]
394
434
  # Required. The parent resource path of the listing.
395
435
  # e.g. `projects/myproject/locations/US/dataExchanges/123`.
396
436
  # @!attribute [rw] listing_id
397
437
  # @return [::String]
398
- # Required. The ID of the Listing to create.
438
+ # Required. The ID of the listing to create.
399
439
  # Must contain only Unicode letters, numbers (0-9), underscores (_).
400
440
  # Should not use characters that require URL-escaping, or characters
401
441
  # outside of ASCII, spaces.
@@ -411,10 +451,9 @@ module Google
411
451
  # Message for updating a Listing.
412
452
  # @!attribute [rw] update_mask
413
453
  # @return [::Google::Protobuf::FieldMask]
414
- # Required. Field mask is used to specify the fields to be overwritten in the
415
- # Listing resource by the update.
416
- # The fields specified in the update_mask are relative to the resource, not
417
- # the full request.
454
+ # Required. Field mask specifies the fields to update in the listing resource. The
455
+ # fields specified in the `updateMask` are relative to the resource and are
456
+ # not a full request.
418
457
  # @!attribute [rw] listing
419
458
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::Listing]
420
459
  # Required. The listing to update.
@@ -423,7 +462,7 @@ module Google
423
462
  extend ::Google::Protobuf::MessageExts::ClassMethods
424
463
  end
425
464
 
426
- # Message for deleting a Listing.
465
+ # Message for deleting a listing.
427
466
  # @!attribute [rw] name
428
467
  # @return [::String]
429
468
  # Required. Resource name of the listing to delete.
@@ -433,21 +472,20 @@ module Google
433
472
  extend ::Google::Protobuf::MessageExts::ClassMethods
434
473
  end
435
474
 
436
- # Message for subscribing a Listing.
437
- # @!attribute [rw] name
438
- # @return [::String]
439
- # Required. Resource name of the listing to subscribe to.
440
- # e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
475
+ # Message for subscribing to a listing.
441
476
  # @!attribute [rw] destination_dataset
442
477
  # @return [::Google::Cloud::Bigquery::DataExchange::V1beta1::DestinationDataset]
443
478
  # BigQuery destination dataset to create for the subscriber.
479
+ # @!attribute [rw] name
480
+ # @return [::String]
481
+ # Required. Resource name of the listing that you want to subscribe to.
482
+ # e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
444
483
  class SubscribeListingRequest
445
484
  include ::Google::Protobuf::MessageExts
446
485
  extend ::Google::Protobuf::MessageExts::ClassMethods
447
486
  end
448
487
 
449
- # Message for response to subscribing a Listing.
450
- # Empty for now.
488
+ # Message for response when you subscribe to a listing.
451
489
  class SubscribeListingResponse
452
490
  include ::Google::Protobuf::MessageExts
453
491
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -0,0 +1,141 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Protobuf
22
+ # `Any` contains an arbitrary serialized protocol buffer message along with a
23
+ # URL that describes the type of the serialized message.
24
+ #
25
+ # Protobuf library provides support to pack/unpack Any values in the form
26
+ # of utility functions or additional generated methods of the Any type.
27
+ #
28
+ # Example 1: Pack and unpack a message in C++.
29
+ #
30
+ # Foo foo = ...;
31
+ # Any any;
32
+ # any.PackFrom(foo);
33
+ # ...
34
+ # if (any.UnpackTo(&foo)) {
35
+ # ...
36
+ # }
37
+ #
38
+ # Example 2: Pack and unpack a message in Java.
39
+ #
40
+ # Foo foo = ...;
41
+ # Any any = Any.pack(foo);
42
+ # ...
43
+ # if (any.is(Foo.class)) {
44
+ # foo = any.unpack(Foo.class);
45
+ # }
46
+ #
47
+ # Example 3: Pack and unpack a message in Python.
48
+ #
49
+ # foo = Foo(...)
50
+ # any = Any()
51
+ # any.Pack(foo)
52
+ # ...
53
+ # if any.Is(Foo.DESCRIPTOR):
54
+ # any.Unpack(foo)
55
+ # ...
56
+ #
57
+ # Example 4: Pack and unpack a message in Go
58
+ #
59
+ # foo := &pb.Foo{...}
60
+ # any, err := anypb.New(foo)
61
+ # if err != nil {
62
+ # ...
63
+ # }
64
+ # ...
65
+ # foo := &pb.Foo{}
66
+ # if err := any.UnmarshalTo(foo); err != nil {
67
+ # ...
68
+ # }
69
+ #
70
+ # The pack methods provided by protobuf library will by default use
71
+ # 'type.googleapis.com/full.type.name' as the type URL and the unpack
72
+ # methods only use the fully qualified type name after the last '/'
73
+ # in the type URL, for example "foo.bar.com/x/y.z" will yield type
74
+ # name "y.z".
75
+ #
76
+ #
77
+ # JSON
78
+ #
79
+ # The JSON representation of an `Any` value uses the regular
80
+ # representation of the deserialized, embedded message, with an
81
+ # additional field `@type` which contains the type URL. Example:
82
+ #
83
+ # package google.profile;
84
+ # message Person {
85
+ # string first_name = 1;
86
+ # string last_name = 2;
87
+ # }
88
+ #
89
+ # {
90
+ # "@type": "type.googleapis.com/google.profile.Person",
91
+ # "firstName": <string>,
92
+ # "lastName": <string>
93
+ # }
94
+ #
95
+ # If the embedded message type is well-known and has a custom JSON
96
+ # representation, that representation will be embedded adding a field
97
+ # `value` which holds the custom JSON in addition to the `@type`
98
+ # field. Example (for message [google.protobuf.Duration][]):
99
+ #
100
+ # {
101
+ # "@type": "type.googleapis.com/google.protobuf.Duration",
102
+ # "value": "1.212s"
103
+ # }
104
+ # @!attribute [rw] type_url
105
+ # @return [::String]
106
+ # A URL/resource name that uniquely identifies the type of the serialized
107
+ # protocol buffer message. This string must contain at least
108
+ # one "/" character. The last segment of the URL's path must represent
109
+ # the fully qualified name of the type (as in
110
+ # `path/google.protobuf.Duration`). The name should be in a canonical form
111
+ # (e.g., leading "." is not accepted).
112
+ #
113
+ # In practice, teams usually precompile into the binary all types that they
114
+ # expect it to use in the context of Any. However, for URLs which use the
115
+ # scheme `http`, `https`, or no scheme, one can optionally set up a type
116
+ # server that maps type URLs to message definitions as follows:
117
+ #
118
+ # * If no scheme is provided, `https` is assumed.
119
+ # * An HTTP GET on the URL must yield a [google.protobuf.Type][]
120
+ # value in binary format, or produce an error.
121
+ # * Applications are allowed to cache lookup results based on the
122
+ # URL, or have them precompiled into a binary to avoid any
123
+ # lookup. Therefore, binary compatibility needs to be preserved
124
+ # on changes to types. (Use versioned type names to manage
125
+ # breaking changes.)
126
+ #
127
+ # Note: this functionality is not currently available in the official
128
+ # protobuf release, and it is not used for type URLs beginning with
129
+ # type.googleapis.com.
130
+ #
131
+ # Schemes other than `http`, `https` (or the empty scheme) might be
132
+ # used with implementation specific semantics.
133
+ # @!attribute [rw] value
134
+ # @return [::String]
135
+ # Must be a valid serialized protocol buffer of the above specified type.
136
+ class Any
137
+ include ::Google::Protobuf::MessageExts
138
+ extend ::Google::Protobuf::MessageExts::ClassMethods
139
+ end
140
+ end
141
+ end
@@ -26,8 +26,6 @@ module Google
26
26
  # service Foo {
27
27
  # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
28
28
  # }
29
- #
30
- # The JSON representation for `Empty` is empty JSON object `{}`.
31
29
  class Empty
32
30
  include ::Google::Protobuf::MessageExts
33
31
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-data_exchange-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-07-01 00:00:00.000000000 Z
11
+ date: 2022-09-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -44,6 +44,26 @@ dependencies:
44
44
  - - "~>"
45
45
  - !ruby/object:Gem::Version
46
46
  version: '1.0'
47
+ - !ruby/object:Gem::Dependency
48
+ name: google-cloud-location
49
+ requirement: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - ">="
52
+ - !ruby/object:Gem::Version
53
+ version: '0.0'
54
+ - - "<"
55
+ - !ruby/object:Gem::Version
56
+ version: 2.a
57
+ type: :runtime
58
+ prerelease: false
59
+ version_requirements: !ruby/object:Gem::Requirement
60
+ requirements:
61
+ - - ">="
62
+ - !ruby/object:Gem::Version
63
+ version: '0.0'
64
+ - - "<"
65
+ - !ruby/object:Gem::Version
66
+ version: 2.a
47
67
  - !ruby/object:Gem::Dependency
48
68
  name: grpc-google-iam-v1
49
69
  requirement: !ruby/object:Gem::Requirement
@@ -193,17 +213,16 @@ files:
193
213
  - lib/google/cloud/bigquery/data_exchange/v1beta1/analytics_hub_service/credentials.rb
194
214
  - lib/google/cloud/bigquery/data_exchange/v1beta1/analytics_hub_service/paths.rb
195
215
  - lib/google/cloud/bigquery/data_exchange/v1beta1/version.rb
196
- - lib/google/cloud/bigquery/dataexchange/common/common_pb.rb
197
216
  - lib/google/cloud/bigquery/dataexchange/v1beta1/dataexchange_pb.rb
198
217
  - lib/google/cloud/bigquery/dataexchange/v1beta1/dataexchange_services_pb.rb
199
218
  - proto_docs/README.md
200
219
  - proto_docs/google/api/field_behavior.rb
201
220
  - proto_docs/google/api/resource.rb
202
- - proto_docs/google/cloud/bigquery/dataexchange/common/common.rb
203
221
  - proto_docs/google/cloud/bigquery/dataexchange/v1beta1/dataexchange.rb
204
222
  - proto_docs/google/iam/v1/iam_policy.rb
205
223
  - proto_docs/google/iam/v1/options.rb
206
224
  - proto_docs/google/iam/v1/policy.rb
225
+ - proto_docs/google/protobuf/any.rb
207
226
  - proto_docs/google/protobuf/empty.rb
208
227
  - proto_docs/google/protobuf/field_mask.rb
209
228
  - proto_docs/google/protobuf/wrappers.rb
@@ -1,43 +0,0 @@
1
- # Generated by the protocol buffer compiler. DO NOT EDIT!
2
- # source: google/cloud/bigquery/dataexchange/common/common.proto
3
-
4
- require 'google/protobuf'
5
-
6
- Google::Protobuf::DescriptorPool.generated_pool.build do
7
- add_file("google/cloud/bigquery/dataexchange/common/common.proto", :syntax => :proto3) do
8
- add_enum "google.cloud.bigquery.dataexchange.common.Category" do
9
- value :CATEGORY_UNSPECIFIED, 0
10
- value :CATEGORY_OTHERS, 1
11
- value :CATEGORY_ADVERTISING_AND_MARKETING, 2
12
- value :CATEGORY_COMMERCE, 3
13
- value :CATEGORY_CLIMATE_AND_ENVIRONMENT, 4
14
- value :CATEGORY_DEMOGRAPHICS, 5
15
- value :CATEGORY_ECONOMICS, 6
16
- value :CATEGORY_EDUCATION, 7
17
- value :CATEGORY_ENERGY, 8
18
- value :CATEGORY_FINANCIAL, 9
19
- value :CATEGORY_GAMING, 10
20
- value :CATEGORY_GEOSPATIAL, 11
21
- value :CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE, 12
22
- value :CATEGORY_MEDIA, 13
23
- value :CATEGORY_PUBLIC_SECTOR, 14
24
- value :CATEGORY_RETAIL, 15
25
- value :CATEGORY_SPORTS, 16
26
- value :CATEGORY_SCIENCE_AND_RESEARCH, 17
27
- value :CATEGORY_TRANSPORTATION_AND_LOGISTICS, 18
28
- value :CATEGORY_TRAVEL_AND_TOURISM, 19
29
- end
30
- end
31
- end
32
-
33
- module Google
34
- module Cloud
35
- module Bigquery
36
- module DataExchange
37
- module Common
38
- Category = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.dataexchange.common.Category").enummodule
39
- end
40
- end
41
- end
42
- end
43
- end
@@ -1,71 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2022 Google LLC
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # https://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
-
20
- module Google
21
- module Cloud
22
- module Bigquery
23
- module DataExchange
24
- module Common
25
- # Listing categories.
26
- module Category
27
- CATEGORY_UNSPECIFIED = 0
28
-
29
- CATEGORY_OTHERS = 1
30
-
31
- CATEGORY_ADVERTISING_AND_MARKETING = 2
32
-
33
- CATEGORY_COMMERCE = 3
34
-
35
- CATEGORY_CLIMATE_AND_ENVIRONMENT = 4
36
-
37
- CATEGORY_DEMOGRAPHICS = 5
38
-
39
- CATEGORY_ECONOMICS = 6
40
-
41
- CATEGORY_EDUCATION = 7
42
-
43
- CATEGORY_ENERGY = 8
44
-
45
- CATEGORY_FINANCIAL = 9
46
-
47
- CATEGORY_GAMING = 10
48
-
49
- CATEGORY_GEOSPATIAL = 11
50
-
51
- CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE = 12
52
-
53
- CATEGORY_MEDIA = 13
54
-
55
- CATEGORY_PUBLIC_SECTOR = 14
56
-
57
- CATEGORY_RETAIL = 15
58
-
59
- CATEGORY_SPORTS = 16
60
-
61
- CATEGORY_SCIENCE_AND_RESEARCH = 17
62
-
63
- CATEGORY_TRANSPORTATION_AND_LOGISTICS = 18
64
-
65
- CATEGORY_TRAVEL_AND_TOURISM = 19
66
- end
67
- end
68
- end
69
- end
70
- end
71
- end