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

Sign up to get free protection for your applications and to get access to all the features.
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