google-apis-datacatalog_v1 0.8.0 → 0.12.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: 80fefecb331cff7a35f108dcb28351599ae1f353f014fd15c7d28b8b438d4024
4
- data.tar.gz: 1c7b6b629fc238aba2a7839e93ce712ed74bd099acbcb6b6493641e352445e9a
3
+ metadata.gz: 1b82c0aa97feacaca0fae27c918a507fcb05130994b0fcb585ed16b6caf52353
4
+ data.tar.gz: f13d32a8c1e07b6880c5bb590d835ed8137b7fcd8bd91746e4d46beb8fc4c61a
5
5
  SHA512:
6
- metadata.gz: 71216f98ca6507d8ce238f173450cb1a3bfb26e60c780fb2770ea16ebe5a64e2d0f38eea496e9aee0699cad31cb037735109491f556c5673a41c879074f91ba4
7
- data.tar.gz: d0e745051d27da74754b0d1891b5c08e4d1ef5d8a7775fccf1e796127e7d087562fc4992940f03cd9613c34755accb17042ab61143b7f08a16dcc577ef2bfd28
6
+ metadata.gz: 1b7bc44dc55e0b71f0b00fd412b692ca0d94eee91614607a62a713add15429abfc698973cf2926ac6cbf45278ba6a728dd9506aadf91db9658a3bad1ea829d27
7
+ data.tar.gz: be3f974fcd0a2dd651cb2eda9333f787c795da5c6b57b665f6e32509d36b77197bda5c9b013746dc286d56edc3431cbfd975f7eeeaa7c244690ebc4537008586
data/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Release history for google-apis-datacatalog_v1
2
2
 
3
+ ### v0.12.0 (2022-01-05)
4
+
5
+ * Regenerated from discovery document revision 20211230
6
+ * Unspecified changes
7
+
8
+ ### v0.11.0 (2021-12-07)
9
+
10
+ * Regenerated from discovery document revision 20211201
11
+
12
+ ### v0.10.0 (2021-11-12)
13
+
14
+ * Regenerated from discovery document revision 20211110
15
+
16
+ ### v0.9.0 (2021-10-20)
17
+
18
+ * Regenerated from discovery document revision 20211014
19
+
3
20
  ### v0.8.0 (2021-09-30)
4
21
 
5
22
  * Regenerated from discovery document revision 20210920
data/OVERVIEW.md CHANGED
@@ -51,7 +51,7 @@ require "google/apis/datacatalog_v1"
51
51
  client = Google::Apis::DatacatalogV1::DataCatalogService.new
52
52
 
53
53
  # Authenticate calls
54
- client.authentication = # ... use the googleauth gem to create credentials
54
+ client.authorization = # ... use the googleauth gem to create credentials
55
55
  ```
56
56
 
57
57
  See the class reference docs for information on the methods you can call from a client.
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
60
60
 
61
61
  More detailed descriptions of the Google simple REST clients are available in two documents.
62
62
 
63
- * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
- * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
63
+ * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
+ * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
65
65
 
66
66
  (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datacatalog service in particular.)
67
67
 
@@ -22,7 +22,7 @@ module Google
22
22
  module Apis
23
23
  module DatacatalogV1
24
24
 
25
- # Associates `members` with a `role`.
25
+ # Associates `members`, or principals, with a `role`.
26
26
  class Binding
27
27
  include Google::Apis::Core::Hashable
28
28
 
@@ -45,7 +45,7 @@ module Google
45
45
  # @return [Google::Apis::DatacatalogV1::Expr]
46
46
  attr_accessor :condition
47
47
 
48
- # Specifies the identities requesting access for a Cloud Platform resource. `
48
+ # Specifies the principals requesting access for a Cloud Platform resource. `
49
49
  # members` can have the following values: * `allUsers`: A special identifier
50
50
  # that represents anyone who is on the internet; with or without a Google
51
51
  # account. * `allAuthenticatedUsers`: A special identifier that represents
@@ -75,8 +75,8 @@ module Google
75
75
  # @return [Array<String>]
76
76
  attr_accessor :members
77
77
 
78
- # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
79
- # , or `roles/owner`.
78
+ # Role that is assigned to the list of `members`, or principals. For example, `
79
+ # roles/viewer`, `roles/editor`, or `roles/owner`.
80
80
  # Corresponds to the JSON property `role`
81
81
  # @return [String]
82
82
  attr_accessor :role
@@ -187,13 +187,16 @@ module Google
187
187
  class GetPolicyOptions
188
188
  include Google::Apis::Core::Hashable
189
189
 
190
- # Optional. The policy format version to be returned. Valid values are 0, 1, and
191
- # 3. Requests specifying an invalid value will be rejected. Requests for
192
- # policies with any conditional bindings must specify version 3. Policies
193
- # without any conditional bindings may specify any valid value or leave the
194
- # field unset. To learn which resources support conditions in their IAM policies,
195
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
196
- # resource-policies).
190
+ # Optional. The maximum policy version that will be used to format the policy.
191
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
192
+ # rejected. Requests for policies with any conditional role bindings must
193
+ # specify version 3. Policies with no conditional role bindings may specify any
194
+ # valid value or leave the field unset. The policy in the response might use the
195
+ # policy version that you specified, or it might use a lower policy version. For
196
+ # example, if you specify version 3, but the policy has no conditional role
197
+ # bindings, the response uses version 1. To learn which resources support
198
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
199
+ # google.com/iam/help/conditions/resource-policies).
197
200
  # Corresponds to the JSON property `requestedPolicyVersion`
198
201
  # @return [Fixnum]
199
202
  attr_accessor :requested_policy_version
@@ -255,6 +258,11 @@ module Google
255
258
  # @return [String]
256
259
  attr_accessor :dataset
257
260
 
261
+ # Output only. BigQuery resource name of the latest shard.
262
+ # Corresponds to the JSON property `latestShardResource`
263
+ # @return [String]
264
+ attr_accessor :latest_shard_resource
265
+
258
266
  # Output only. Total number of shards.
259
267
  # Corresponds to the JSON property `shardCount`
260
268
  # @return [Fixnum]
@@ -274,6 +282,7 @@ module Google
274
282
  # Update properties of this object
275
283
  def update!(**args)
276
284
  @dataset = args[:dataset] if args.key?(:dataset)
285
+ @latest_shard_resource = args[:latest_shard_resource] if args.key?(:latest_shard_resource)
277
286
  @shard_count = args[:shard_count] if args.key?(:shard_count)
278
287
  @table_prefix = args[:table_prefix] if args.key?(:table_prefix)
279
288
  end
@@ -329,6 +338,31 @@ module Google
329
338
  end
330
339
  end
331
340
 
341
+ # Business Context of the entry.
342
+ class GoogleCloudDatacatalogV1BusinessContext
343
+ include Google::Apis::Core::Hashable
344
+
345
+ # Contact people for the entry.
346
+ # Corresponds to the JSON property `contacts`
347
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts]
348
+ attr_accessor :contacts
349
+
350
+ # Entry overview fields for rich text descriptions of entries.
351
+ # Corresponds to the JSON property `entryOverview`
352
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview]
353
+ attr_accessor :entry_overview
354
+
355
+ def initialize(**args)
356
+ update!(**args)
357
+ end
358
+
359
+ # Update properties of this object
360
+ def update!(**args)
361
+ @contacts = args[:contacts] if args.key?(:contacts)
362
+ @entry_overview = args[:entry_overview] if args.key?(:entry_overview)
363
+ end
364
+ end
365
+
332
366
  # Specification for the BigQuery connection to a Cloud SQL instance.
333
367
  class GoogleCloudDatacatalogV1CloudSqlBigQueryConnectionSpec
334
368
  include Google::Apis::Core::Hashable
@@ -408,6 +442,50 @@ module Google
408
442
  end
409
443
  end
410
444
 
445
+ # Contact people for the entry.
446
+ class GoogleCloudDatacatalogV1Contacts
447
+ include Google::Apis::Core::Hashable
448
+
449
+ # The list of contact people for the entry.
450
+ # Corresponds to the JSON property `people`
451
+ # @return [Array<Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ContactsPerson>]
452
+ attr_accessor :people
453
+
454
+ def initialize(**args)
455
+ update!(**args)
456
+ end
457
+
458
+ # Update properties of this object
459
+ def update!(**args)
460
+ @people = args[:people] if args.key?(:people)
461
+ end
462
+ end
463
+
464
+ # A contact person for the entry.
465
+ class GoogleCloudDatacatalogV1ContactsPerson
466
+ include Google::Apis::Core::Hashable
467
+
468
+ # Designation of the person, for example, Data Steward.
469
+ # Corresponds to the JSON property `designation`
470
+ # @return [String]
471
+ attr_accessor :designation
472
+
473
+ # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
474
+ # Corresponds to the JSON property `email`
475
+ # @return [String]
476
+ attr_accessor :email
477
+
478
+ def initialize(**args)
479
+ update!(**args)
480
+ end
481
+
482
+ # Update properties of this object
483
+ def update!(**args)
484
+ @designation = args[:designation] if args.key?(:designation)
485
+ @email = args[:email] if args.key?(:email)
486
+ end
487
+ end
488
+
411
489
  # Cross-regional source used to import an existing taxonomy into a different
412
490
  # region.
413
491
  class GoogleCloudDatacatalogV1CrossRegionalSource
@@ -517,6 +595,11 @@ module Google
517
595
  # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BigQueryTableSpec]
518
596
  attr_accessor :bigquery_table_spec
519
597
 
598
+ # Business Context of the entry.
599
+ # Corresponds to the JSON property `businessContext`
600
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BusinessContext]
601
+ attr_accessor :business_context
602
+
520
603
  # Physical location of an entry.
521
604
  # Corresponds to the JSON property `dataSource`
522
605
  # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1DataSource]
@@ -602,6 +685,11 @@ module Google
602
685
  # @return [String]
603
686
  attr_accessor :name
604
687
 
688
+ # Entry metadata relevant only to the user and private to them.
689
+ # Corresponds to the JSON property `personalDetails`
690
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails]
691
+ attr_accessor :personal_details
692
+
605
693
  # Specification that applies to a routine. Valid only for entries with the `
606
694
  # ROUTINE` type.
607
695
  # Corresponds to the JSON property `routineSpec`
@@ -661,6 +749,7 @@ module Google
661
749
  def update!(**args)
662
750
  @bigquery_date_sharded_spec = args[:bigquery_date_sharded_spec] if args.key?(:bigquery_date_sharded_spec)
663
751
  @bigquery_table_spec = args[:bigquery_table_spec] if args.key?(:bigquery_table_spec)
752
+ @business_context = args[:business_context] if args.key?(:business_context)
664
753
  @data_source = args[:data_source] if args.key?(:data_source)
665
754
  @data_source_connection_spec = args[:data_source_connection_spec] if args.key?(:data_source_connection_spec)
666
755
  @database_table_spec = args[:database_table_spec] if args.key?(:database_table_spec)
@@ -672,6 +761,7 @@ module Google
672
761
  @labels = args[:labels] if args.key?(:labels)
673
762
  @linked_resource = args[:linked_resource] if args.key?(:linked_resource)
674
763
  @name = args[:name] if args.key?(:name)
764
+ @personal_details = args[:personal_details] if args.key?(:personal_details)
675
765
  @routine_spec = args[:routine_spec] if args.key?(:routine_spec)
676
766
  @schema = args[:schema] if args.key?(:schema)
677
767
  @source_system_timestamps = args[:source_system_timestamps] if args.key?(:source_system_timestamps)
@@ -724,6 +814,28 @@ module Google
724
814
  end
725
815
  end
726
816
 
817
+ # Entry overview fields for rich text descriptions of entries.
818
+ class GoogleCloudDatacatalogV1EntryOverview
819
+ include Google::Apis::Core::Hashable
820
+
821
+ # Entry overview with support for rich text. The overview must only contain
822
+ # Unicode characters, and should be formatted using HTML. The maximum length is
823
+ # 10 MiB as this value holds HTML descriptions including encoded images. The
824
+ # maximum length of the text without images is 100 KiB.
825
+ # Corresponds to the JSON property `overview`
826
+ # @return [String]
827
+ attr_accessor :overview
828
+
829
+ def initialize(**args)
830
+ update!(**args)
831
+ end
832
+
833
+ # Update properties of this object
834
+ def update!(**args)
835
+ @overview = args[:overview] if args.key?(:overview)
836
+ end
837
+ end
838
+
727
839
  # Response message for ExportTaxonomies.
728
840
  class GoogleCloudDatacatalogV1ExportTaxonomiesResponse
729
841
  include Google::Apis::Core::Hashable
@@ -1080,6 +1192,70 @@ module Google
1080
1192
  end
1081
1193
  end
1082
1194
 
1195
+ # Request message for ModifyEntryContacts.
1196
+ class GoogleCloudDatacatalogV1ModifyEntryContactsRequest
1197
+ include Google::Apis::Core::Hashable
1198
+
1199
+ # Contact people for the entry.
1200
+ # Corresponds to the JSON property `contacts`
1201
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts]
1202
+ attr_accessor :contacts
1203
+
1204
+ def initialize(**args)
1205
+ update!(**args)
1206
+ end
1207
+
1208
+ # Update properties of this object
1209
+ def update!(**args)
1210
+ @contacts = args[:contacts] if args.key?(:contacts)
1211
+ end
1212
+ end
1213
+
1214
+ # Request message for ModifyEntryOverview.
1215
+ class GoogleCloudDatacatalogV1ModifyEntryOverviewRequest
1216
+ include Google::Apis::Core::Hashable
1217
+
1218
+ # Entry overview fields for rich text descriptions of entries.
1219
+ # Corresponds to the JSON property `entryOverview`
1220
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview]
1221
+ attr_accessor :entry_overview
1222
+
1223
+ def initialize(**args)
1224
+ update!(**args)
1225
+ end
1226
+
1227
+ # Update properties of this object
1228
+ def update!(**args)
1229
+ @entry_overview = args[:entry_overview] if args.key?(:entry_overview)
1230
+ end
1231
+ end
1232
+
1233
+ # Entry metadata relevant only to the user and private to them.
1234
+ class GoogleCloudDatacatalogV1PersonalDetails
1235
+ include Google::Apis::Core::Hashable
1236
+
1237
+ # Set if the entry is starred; unset otherwise.
1238
+ # Corresponds to the JSON property `starTime`
1239
+ # @return [String]
1240
+ attr_accessor :star_time
1241
+
1242
+ # True if the entry is starred by the user; false otherwise.
1243
+ # Corresponds to the JSON property `starred`
1244
+ # @return [Boolean]
1245
+ attr_accessor :starred
1246
+ alias_method :starred?, :starred
1247
+
1248
+ def initialize(**args)
1249
+ update!(**args)
1250
+ end
1251
+
1252
+ # Update properties of this object
1253
+ def update!(**args)
1254
+ @star_time = args[:star_time] if args.key?(:star_time)
1255
+ @starred = args[:starred] if args.key?(:starred)
1256
+ end
1257
+ end
1258
+
1083
1259
  # Denotes one policy tag in a taxonomy, for example, SSN. Policy tags can be
1084
1260
  # defined in a hierarchy. For example: ``` + Geolocation + LatLong + City +
1085
1261
  # ZipCode ``` Where the "Geolocation" policy tag contains three children.
@@ -1305,8 +1481,8 @@ module Google
1305
1481
 
1306
1482
  # Specifies the order of results. Currently supported case-sensitive values are:
1307
1483
  # * `relevance` that can only be descending * `last_modified_timestamp [asc|desc]
1308
- # ` with descending (`desc`) as default If this parameter is omitted, it
1309
- # defaults to the descending `relevance`.
1484
+ # ` with descending (`desc`) as default * `default` that can only be descending
1485
+ # If this parameter is omitted, it defaults to the descending `relevance`.
1310
1486
  # Corresponds to the JSON property `orderBy`
1311
1487
  # @return [String]
1312
1488
  attr_accessor :order_by
@@ -1327,10 +1503,11 @@ module Google
1327
1503
  attr_accessor :page_token
1328
1504
 
1329
1505
  # Optional. The query string with a minimum of 3 characters and specific syntax.
1330
- # For more information, see [Data Catalog search syntax](/data-catalog/docs/how-
1331
- # to/search-reference). An empty query string returns all data assets (in the
1332
- # specified scope) that you have access to. A query string can be a simple `xyz`
1333
- # or qualified by predicates: * `name:x` * `column:y` * `description:z`
1506
+ # For more information, see [Data Catalog search syntax](https://cloud.google.
1507
+ # com/data-catalog/docs/how-to/search-reference). An empty query string returns
1508
+ # all data assets (in the specified scope) that you have access to. A query
1509
+ # string can be a simple `xyz` or qualified by predicates: * `name:x` * `column:
1510
+ # y` * `description:z`
1334
1511
  # Corresponds to the JSON property `query`
1335
1512
  # @return [String]
1336
1513
  attr_accessor :query
@@ -1383,7 +1560,7 @@ module Google
1383
1560
  # Optional. If `true`, include public tag templates in the search results. By
1384
1561
  # default, they are included only if you have explicit permissions on them to
1385
1562
  # view them. For example, if you are the owner. Other scope fields, for example,
1386
- # ``include_org_ids``, still restrict the returned public tag templates and at
1563
+ # `include_org_ids`, still restrict the returned public tag templates and at
1387
1564
  # least one of them is required.
1388
1565
  # Corresponds to the JSON property `includePublicTagTemplates`
1389
1566
  # @return [Boolean]
@@ -1401,6 +1578,13 @@ module Google
1401
1578
  # @return [Array<String>]
1402
1579
  attr_accessor :restricted_locations
1403
1580
 
1581
+ # Optional. If `true`, search only among starred entries. By default, all
1582
+ # results are returned, starred or not.
1583
+ # Corresponds to the JSON property `starredOnly`
1584
+ # @return [Boolean]
1585
+ attr_accessor :starred_only
1586
+ alias_method :starred_only?, :starred_only
1587
+
1404
1588
  def initialize(**args)
1405
1589
  update!(**args)
1406
1590
  end
@@ -1412,6 +1596,7 @@ module Google
1412
1596
  @include_project_ids = args[:include_project_ids] if args.key?(:include_project_ids)
1413
1597
  @include_public_tag_templates = args[:include_public_tag_templates] if args.key?(:include_public_tag_templates)
1414
1598
  @restricted_locations = args[:restricted_locations] if args.key?(:restricted_locations)
1599
+ @starred_only = args[:starred_only] if args.key?(:starred_only)
1415
1600
  end
1416
1601
  end
1417
1602
 
@@ -1455,6 +1640,17 @@ module Google
1455
1640
  class GoogleCloudDatacatalogV1SearchCatalogResult
1456
1641
  include Google::Apis::Core::Hashable
1457
1642
 
1643
+ # Entry description that can consist of several sentences or paragraphs that
1644
+ # describe entry contents.
1645
+ # Corresponds to the JSON property `description`
1646
+ # @return [String]
1647
+ attr_accessor :description
1648
+
1649
+ # The display name of the result.
1650
+ # Corresponds to the JSON property `displayName`
1651
+ # @return [String]
1652
+ attr_accessor :display_name
1653
+
1458
1654
  # Fully qualified name (FQN) of the resource. FQNs take two forms: * For non-
1459
1655
  # regionalized resources: ``SYSTEM`:`PROJECT`.`
1460
1656
  # PATH_TO_RESOURCE_SEPARATED_WITH_DOTS`` * For regionalized resources: ``SYSTEM`:
@@ -1515,6 +1711,8 @@ module Google
1515
1711
 
1516
1712
  # Update properties of this object
1517
1713
  def update!(**args)
1714
+ @description = args[:description] if args.key?(:description)
1715
+ @display_name = args[:display_name] if args.key?(:display_name)
1518
1716
  @fully_qualified_name = args[:fully_qualified_name] if args.key?(:fully_qualified_name)
1519
1717
  @integrated_system = args[:integrated_system] if args.key?(:integrated_system)
1520
1718
  @linked_resource = args[:linked_resource] if args.key?(:linked_resource)
@@ -1606,6 +1804,32 @@ module Google
1606
1804
  end
1607
1805
  end
1608
1806
 
1807
+ # Request message for StarEntry.
1808
+ class GoogleCloudDatacatalogV1StarEntryRequest
1809
+ include Google::Apis::Core::Hashable
1810
+
1811
+ def initialize(**args)
1812
+ update!(**args)
1813
+ end
1814
+
1815
+ # Update properties of this object
1816
+ def update!(**args)
1817
+ end
1818
+ end
1819
+
1820
+ # Response message for StarEntry. Empty for now
1821
+ class GoogleCloudDatacatalogV1StarEntryResponse
1822
+ include Google::Apis::Core::Hashable
1823
+
1824
+ def initialize(**args)
1825
+ update!(**args)
1826
+ end
1827
+
1828
+ # Update properties of this object
1829
+ def update!(**args)
1830
+ end
1831
+ end
1832
+
1609
1833
  # Timestamps associated with this resource in a particular system.
1610
1834
  class GoogleCloudDatacatalogV1SystemTimestamps
1611
1835
  include Google::Apis::Core::Hashable
@@ -1996,6 +2220,32 @@ module Google
1996
2220
  end
1997
2221
  end
1998
2222
 
2223
+ # Request message for UnstarEntry.
2224
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
2225
+ include Google::Apis::Core::Hashable
2226
+
2227
+ def initialize(**args)
2228
+ update!(**args)
2229
+ end
2230
+
2231
+ # Update properties of this object
2232
+ def update!(**args)
2233
+ end
2234
+ end
2235
+
2236
+ # Response message for UnstarEntry. Empty for now
2237
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
2238
+ include Google::Apis::Core::Hashable
2239
+
2240
+ def initialize(**args)
2241
+ update!(**args)
2242
+ end
2243
+
2244
+ # Update properties of this object
2245
+ def update!(**args)
2246
+ end
2247
+ end
2248
+
1999
2249
  # The set of all usage signals that Data Catalog stores. Note: Usually, these
2000
2250
  # signals are updated daily. In rare cases, an update may fail but will be
2001
2251
  # performed again on the next day.
@@ -2087,37 +2337,42 @@ module Google
2087
2337
 
2088
2338
  # An Identity and Access Management (IAM) policy, which specifies access
2089
2339
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
2090
- # A `binding` binds one or more `members` to a single `role`. Members can be
2091
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
2092
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
2093
- # role or a user-created custom role. For some types of Google Cloud resources,
2094
- # a `binding` can also specify a `condition`, which is a logical expression that
2095
- # allows access to a resource only if the expression evaluates to `true`. A
2096
- # condition can add constraints based on attributes of the request, the resource,
2097
- # or both. To learn which resources support conditions in their IAM policies,
2098
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
2099
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
2100
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
2101
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
2102
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
2103
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
2104
- # title": "expirable access", "description": "Does not grant access after Sep
2105
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
2106
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
2107
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
2108
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
2109
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
2110
- # roles/resourcemanager.organizationViewer condition: title: expirable access
2111
- # description: Does not grant access after Sep 2020 expression: request.time <
2112
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
2113
- # description of IAM and its features, see the [IAM documentation](https://cloud.
2114
- # google.com/iam/docs/).
2340
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
2341
+ # Principals can be user accounts, service accounts, Google groups, and domains (
2342
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
2343
+ # an IAM predefined role or a user-created custom role. For some types of Google
2344
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
2345
+ # logical expression that allows access to a resource only if the expression
2346
+ # evaluates to `true`. A condition can add constraints based on attributes of
2347
+ # the request, the resource, or both. To learn which resources support
2348
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2349
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
2350
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
2351
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
2352
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
2353
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
2354
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
2355
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
2356
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
2357
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
2358
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
2359
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
2360
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
2361
+ # access description: Does not grant access after Sep 2020 expression: request.
2362
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
2363
+ # a description of IAM and its features, see the [IAM documentation](https://
2364
+ # cloud.google.com/iam/docs/).
2115
2365
  class Policy
2116
2366
  include Google::Apis::Core::Hashable
2117
2367
 
2118
- # Associates a list of `members` to a `role`. Optionally, may specify a `
2119
- # condition` that determines how and when the `bindings` are applied. Each of
2120
- # the `bindings` must contain at least one member.
2368
+ # Associates a list of `members`, or principals, with a `role`. Optionally, may
2369
+ # specify a `condition` that determines how and when the `bindings` are applied.
2370
+ # Each of the `bindings` must contain at least one principal. The `bindings` in
2371
+ # a `Policy` can refer to up to 1,500 principals; up to 250 of these principals
2372
+ # can be Google groups. Each occurrence of a principal counts towards these
2373
+ # limits. For example, if the `bindings` grant 50 different roles to `user:alice@
2374
+ # example.com`, and not to any other principal, then you can add another 1,450
2375
+ # principals to the `bindings` in the `Policy`.
2121
2376
  # Corresponds to the JSON property `bindings`
2122
2377
  # @return [Array<Google::Apis::DatacatalogV1::Binding>]
2123
2378
  attr_accessor :bindings
@@ -2175,31 +2430,31 @@ module Google
2175
2430
 
2176
2431
  # An Identity and Access Management (IAM) policy, which specifies access
2177
2432
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
2178
- # A `binding` binds one or more `members` to a single `role`. Members can be
2179
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
2180
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
2181
- # role or a user-created custom role. For some types of Google Cloud resources,
2182
- # a `binding` can also specify a `condition`, which is a logical expression that
2183
- # allows access to a resource only if the expression evaluates to `true`. A
2184
- # condition can add constraints based on attributes of the request, the resource,
2185
- # or both. To learn which resources support conditions in their IAM policies,
2186
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
2187
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
2188
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
2189
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
2190
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
2191
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
2192
- # title": "expirable access", "description": "Does not grant access after Sep
2193
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
2194
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
2195
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
2196
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
2197
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
2198
- # roles/resourcemanager.organizationViewer condition: title: expirable access
2199
- # description: Does not grant access after Sep 2020 expression: request.time <
2200
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
2201
- # description of IAM and its features, see the [IAM documentation](https://cloud.
2202
- # google.com/iam/docs/).
2433
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
2434
+ # Principals can be user accounts, service accounts, Google groups, and domains (
2435
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
2436
+ # an IAM predefined role or a user-created custom role. For some types of Google
2437
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
2438
+ # logical expression that allows access to a resource only if the expression
2439
+ # evaluates to `true`. A condition can add constraints based on attributes of
2440
+ # the request, the resource, or both. To learn which resources support
2441
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2442
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
2443
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
2444
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
2445
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
2446
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
2447
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
2448
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
2449
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
2450
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
2451
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
2452
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
2453
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
2454
+ # access description: Does not grant access after Sep 2020 expression: request.
2455
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
2456
+ # a description of IAM and its features, see the [IAM documentation](https://
2457
+ # cloud.google.com/iam/docs/).
2203
2458
  # Corresponds to the JSON property `policy`
2204
2459
  # @return [Google::Apis::DatacatalogV1::Policy]
2205
2460
  attr_accessor :policy
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module DatacatalogV1
18
18
  # Version of the google-apis-datacatalog_v1 gem
19
- GEM_VERSION = "0.8.0"
19
+ GEM_VERSION = "0.12.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210920"
25
+ REVISION = "20211230"
26
26
  end
27
27
  end
28
28
  end
@@ -76,6 +76,12 @@ module Google
76
76
  include Google::Apis::Core::JsonObjectSupport
77
77
  end
78
78
 
79
+ class GoogleCloudDatacatalogV1BusinessContext
80
+ class Representation < Google::Apis::Core::JsonRepresentation; end
81
+
82
+ include Google::Apis::Core::JsonObjectSupport
83
+ end
84
+
79
85
  class GoogleCloudDatacatalogV1CloudSqlBigQueryConnectionSpec
80
86
  class Representation < Google::Apis::Core::JsonRepresentation; end
81
87
 
@@ -88,6 +94,18 @@ module Google
88
94
  include Google::Apis::Core::JsonObjectSupport
89
95
  end
90
96
 
97
+ class GoogleCloudDatacatalogV1Contacts
98
+ class Representation < Google::Apis::Core::JsonRepresentation; end
99
+
100
+ include Google::Apis::Core::JsonObjectSupport
101
+ end
102
+
103
+ class GoogleCloudDatacatalogV1ContactsPerson
104
+ class Representation < Google::Apis::Core::JsonRepresentation; end
105
+
106
+ include Google::Apis::Core::JsonObjectSupport
107
+ end
108
+
91
109
  class GoogleCloudDatacatalogV1CrossRegionalSource
92
110
  class Representation < Google::Apis::Core::JsonRepresentation; end
93
111
 
@@ -124,6 +142,12 @@ module Google
124
142
  include Google::Apis::Core::JsonObjectSupport
125
143
  end
126
144
 
145
+ class GoogleCloudDatacatalogV1EntryOverview
146
+ class Representation < Google::Apis::Core::JsonRepresentation; end
147
+
148
+ include Google::Apis::Core::JsonObjectSupport
149
+ end
150
+
127
151
  class GoogleCloudDatacatalogV1ExportTaxonomiesResponse
128
152
  class Representation < Google::Apis::Core::JsonRepresentation; end
129
153
 
@@ -208,6 +232,24 @@ module Google
208
232
  include Google::Apis::Core::JsonObjectSupport
209
233
  end
210
234
 
235
+ class GoogleCloudDatacatalogV1ModifyEntryContactsRequest
236
+ class Representation < Google::Apis::Core::JsonRepresentation; end
237
+
238
+ include Google::Apis::Core::JsonObjectSupport
239
+ end
240
+
241
+ class GoogleCloudDatacatalogV1ModifyEntryOverviewRequest
242
+ class Representation < Google::Apis::Core::JsonRepresentation; end
243
+
244
+ include Google::Apis::Core::JsonObjectSupport
245
+ end
246
+
247
+ class GoogleCloudDatacatalogV1PersonalDetails
248
+ class Representation < Google::Apis::Core::JsonRepresentation; end
249
+
250
+ include Google::Apis::Core::JsonObjectSupport
251
+ end
252
+
211
253
  class GoogleCloudDatacatalogV1PolicyTag
212
254
  class Representation < Google::Apis::Core::JsonRepresentation; end
213
255
 
@@ -286,6 +328,18 @@ module Google
286
328
  include Google::Apis::Core::JsonObjectSupport
287
329
  end
288
330
 
331
+ class GoogleCloudDatacatalogV1StarEntryRequest
332
+ class Representation < Google::Apis::Core::JsonRepresentation; end
333
+
334
+ include Google::Apis::Core::JsonObjectSupport
335
+ end
336
+
337
+ class GoogleCloudDatacatalogV1StarEntryResponse
338
+ class Representation < Google::Apis::Core::JsonRepresentation; end
339
+
340
+ include Google::Apis::Core::JsonObjectSupport
341
+ end
342
+
289
343
  class GoogleCloudDatacatalogV1SystemTimestamps
290
344
  class Representation < Google::Apis::Core::JsonRepresentation; end
291
345
 
@@ -334,6 +388,18 @@ module Google
334
388
  include Google::Apis::Core::JsonObjectSupport
335
389
  end
336
390
 
391
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
392
+ class Representation < Google::Apis::Core::JsonRepresentation; end
393
+
394
+ include Google::Apis::Core::JsonObjectSupport
395
+ end
396
+
397
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
398
+ class Representation < Google::Apis::Core::JsonRepresentation; end
399
+
400
+ include Google::Apis::Core::JsonObjectSupport
401
+ end
402
+
337
403
  class GoogleCloudDatacatalogV1UsageSignal
338
404
  class Representation < Google::Apis::Core::JsonRepresentation; end
339
405
 
@@ -431,6 +497,7 @@ module Google
431
497
  # @private
432
498
  class Representation < Google::Apis::Core::JsonRepresentation
433
499
  property :dataset, as: 'dataset'
500
+ property :latest_shard_resource, as: 'latestShardResource'
434
501
  property :shard_count, :numeric_string => true, as: 'shardCount'
435
502
  property :table_prefix, as: 'tablePrefix'
436
503
  end
@@ -454,6 +521,16 @@ module Google
454
521
  end
455
522
  end
456
523
 
524
+ class GoogleCloudDatacatalogV1BusinessContext
525
+ # @private
526
+ class Representation < Google::Apis::Core::JsonRepresentation
527
+ property :contacts, as: 'contacts', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts::Representation
528
+
529
+ property :entry_overview, as: 'entryOverview', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview::Representation
530
+
531
+ end
532
+ end
533
+
457
534
  class GoogleCloudDatacatalogV1CloudSqlBigQueryConnectionSpec
458
535
  # @private
459
536
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -475,6 +552,22 @@ module Google
475
552
  end
476
553
  end
477
554
 
555
+ class GoogleCloudDatacatalogV1Contacts
556
+ # @private
557
+ class Representation < Google::Apis::Core::JsonRepresentation
558
+ collection :people, as: 'people', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ContactsPerson, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ContactsPerson::Representation
559
+
560
+ end
561
+ end
562
+
563
+ class GoogleCloudDatacatalogV1ContactsPerson
564
+ # @private
565
+ class Representation < Google::Apis::Core::JsonRepresentation
566
+ property :designation, as: 'designation'
567
+ property :email, as: 'email'
568
+ end
569
+ end
570
+
478
571
  class GoogleCloudDatacatalogV1CrossRegionalSource
479
572
  # @private
480
573
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -512,6 +605,8 @@ module Google
512
605
 
513
606
  property :bigquery_table_spec, as: 'bigqueryTableSpec', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BigQueryTableSpec, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BigQueryTableSpec::Representation
514
607
 
608
+ property :business_context, as: 'businessContext', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BusinessContext, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1BusinessContext::Representation
609
+
515
610
  property :data_source, as: 'dataSource', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1DataSource, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1DataSource::Representation
516
611
 
517
612
  property :data_source_connection_spec, as: 'dataSourceConnectionSpec', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1DataSourceConnectionSpec, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1DataSourceConnectionSpec::Representation
@@ -527,6 +622,8 @@ module Google
527
622
  hash :labels, as: 'labels'
528
623
  property :linked_resource, as: 'linkedResource'
529
624
  property :name, as: 'name'
625
+ property :personal_details, as: 'personalDetails', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails::Representation
626
+
530
627
  property :routine_spec, as: 'routineSpec', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RoutineSpec, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RoutineSpec::Representation
531
628
 
532
629
  property :schema, as: 'schema', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Schema, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Schema::Representation
@@ -552,6 +649,13 @@ module Google
552
649
  end
553
650
  end
554
651
 
652
+ class GoogleCloudDatacatalogV1EntryOverview
653
+ # @private
654
+ class Representation < Google::Apis::Core::JsonRepresentation
655
+ property :overview, as: 'overview'
656
+ end
657
+ end
658
+
555
659
  class GoogleCloudDatacatalogV1ExportTaxonomiesResponse
556
660
  # @private
557
661
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -674,6 +778,30 @@ module Google
674
778
  end
675
779
  end
676
780
 
781
+ class GoogleCloudDatacatalogV1ModifyEntryContactsRequest
782
+ # @private
783
+ class Representation < Google::Apis::Core::JsonRepresentation
784
+ property :contacts, as: 'contacts', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts::Representation
785
+
786
+ end
787
+ end
788
+
789
+ class GoogleCloudDatacatalogV1ModifyEntryOverviewRequest
790
+ # @private
791
+ class Representation < Google::Apis::Core::JsonRepresentation
792
+ property :entry_overview, as: 'entryOverview', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview::Representation
793
+
794
+ end
795
+ end
796
+
797
+ class GoogleCloudDatacatalogV1PersonalDetails
798
+ # @private
799
+ class Representation < Google::Apis::Core::JsonRepresentation
800
+ property :star_time, as: 'starTime'
801
+ property :starred, as: 'starred'
802
+ end
803
+ end
804
+
677
805
  class GoogleCloudDatacatalogV1PolicyTag
678
806
  # @private
679
807
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -758,6 +886,7 @@ module Google
758
886
  collection :include_project_ids, as: 'includeProjectIds'
759
887
  property :include_public_tag_templates, as: 'includePublicTagTemplates'
760
888
  collection :restricted_locations, as: 'restrictedLocations'
889
+ property :starred_only, as: 'starredOnly'
761
890
  end
762
891
  end
763
892
 
@@ -774,6 +903,8 @@ module Google
774
903
  class GoogleCloudDatacatalogV1SearchCatalogResult
775
904
  # @private
776
905
  class Representation < Google::Apis::Core::JsonRepresentation
906
+ property :description, as: 'description'
907
+ property :display_name, as: 'displayName'
777
908
  property :fully_qualified_name, as: 'fullyQualifiedName'
778
909
  property :integrated_system, as: 'integratedSystem'
779
910
  property :linked_resource, as: 'linkedResource'
@@ -807,6 +938,18 @@ module Google
807
938
  end
808
939
  end
809
940
 
941
+ class GoogleCloudDatacatalogV1StarEntryRequest
942
+ # @private
943
+ class Representation < Google::Apis::Core::JsonRepresentation
944
+ end
945
+ end
946
+
947
+ class GoogleCloudDatacatalogV1StarEntryResponse
948
+ # @private
949
+ class Representation < Google::Apis::Core::JsonRepresentation
950
+ end
951
+ end
952
+
810
953
  class GoogleCloudDatacatalogV1SystemTimestamps
811
954
  # @private
812
955
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -894,6 +1037,18 @@ module Google
894
1037
  end
895
1038
  end
896
1039
 
1040
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
1041
+ # @private
1042
+ class Representation < Google::Apis::Core::JsonRepresentation
1043
+ end
1044
+ end
1045
+
1046
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
1047
+ # @private
1048
+ class Representation < Google::Apis::Core::JsonRepresentation
1049
+ end
1050
+ end
1051
+
897
1052
  class GoogleCloudDatacatalogV1UsageSignal
898
1053
  # @private
899
1054
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -666,6 +666,76 @@ module Google
666
666
  execute_or_queue_command(command, &block)
667
667
  end
668
668
 
669
+ # Modifies contacts, part of the business context of an Entry. To call this
670
+ # method, you must have the `datacatalog.entries.updateContacts` IAM permission
671
+ # on the corresponding project.
672
+ # @param [String] name
673
+ # Required. The full resource name of the entry.
674
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ModifyEntryContactsRequest] google_cloud_datacatalog_v1_modify_entry_contacts_request_object
675
+ # @param [String] fields
676
+ # Selector specifying which fields to include in a partial response.
677
+ # @param [String] quota_user
678
+ # Available to use for quota purposes for server-side applications. Can be any
679
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
680
+ # @param [Google::Apis::RequestOptions] options
681
+ # Request-specific options
682
+ #
683
+ # @yield [result, err] Result & error if block supplied
684
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts] parsed result object
685
+ # @yieldparam err [StandardError] error object if request failed
686
+ #
687
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts]
688
+ #
689
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
690
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
691
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
692
+ def modify_project_location_entry_group_entry_entry_contacts(name, google_cloud_datacatalog_v1_modify_entry_contacts_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
693
+ command = make_simple_command(:post, 'v1/{+name}:modifyEntryContacts', options)
694
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ModifyEntryContactsRequest::Representation
695
+ command.request_object = google_cloud_datacatalog_v1_modify_entry_contacts_request_object
696
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts::Representation
697
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Contacts
698
+ command.params['name'] = name unless name.nil?
699
+ command.query['fields'] = fields unless fields.nil?
700
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
701
+ execute_or_queue_command(command, &block)
702
+ end
703
+
704
+ # Modifies entry overview, part of the business context of an Entry. To call
705
+ # this method, you must have the `datacatalog.entries.updateOverview` IAM
706
+ # permission on the corresponding project.
707
+ # @param [String] name
708
+ # Required. The full resource name of the entry.
709
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ModifyEntryOverviewRequest] google_cloud_datacatalog_v1_modify_entry_overview_request_object
710
+ # @param [String] fields
711
+ # Selector specifying which fields to include in a partial response.
712
+ # @param [String] quota_user
713
+ # Available to use for quota purposes for server-side applications. Can be any
714
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
715
+ # @param [Google::Apis::RequestOptions] options
716
+ # Request-specific options
717
+ #
718
+ # @yield [result, err] Result & error if block supplied
719
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview] parsed result object
720
+ # @yieldparam err [StandardError] error object if request failed
721
+ #
722
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview]
723
+ #
724
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
725
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
726
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
727
+ def modify_project_location_entry_group_entry_entry_overview(name, google_cloud_datacatalog_v1_modify_entry_overview_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
728
+ command = make_simple_command(:post, 'v1/{+name}:modifyEntryOverview', options)
729
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ModifyEntryOverviewRequest::Representation
730
+ command.request_object = google_cloud_datacatalog_v1_modify_entry_overview_request_object
731
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview::Representation
732
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1EntryOverview
733
+ command.params['name'] = name unless name.nil?
734
+ command.query['fields'] = fields unless fields.nil?
735
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
736
+ execute_or_queue_command(command, &block)
737
+ end
738
+
669
739
  # Updates an existing entry. You must enable the Data Catalog API in the project
670
740
  # identified by the `entry.name` parameter. For more information, see [Data
671
741
  # Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/
@@ -715,6 +785,40 @@ module Google
715
785
  execute_or_queue_command(command, &block)
716
786
  end
717
787
 
788
+ # Marks an Entry as starred by the current user. Starring information is private
789
+ # to each user.
790
+ # @param [String] name
791
+ # Required. The name of the entry to mark as starred.
792
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryRequest] google_cloud_datacatalog_v1_star_entry_request_object
793
+ # @param [String] fields
794
+ # Selector specifying which fields to include in a partial response.
795
+ # @param [String] quota_user
796
+ # Available to use for quota purposes for server-side applications. Can be any
797
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
798
+ # @param [Google::Apis::RequestOptions] options
799
+ # Request-specific options
800
+ #
801
+ # @yield [result, err] Result & error if block supplied
802
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse] parsed result object
803
+ # @yieldparam err [StandardError] error object if request failed
804
+ #
805
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse]
806
+ #
807
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
808
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
809
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
810
+ def star_project_location_entry_group_entry(name, google_cloud_datacatalog_v1_star_entry_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
811
+ command = make_simple_command(:post, 'v1/{+name}:star', options)
812
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryRequest::Representation
813
+ command.request_object = google_cloud_datacatalog_v1_star_entry_request_object
814
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse::Representation
815
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse
816
+ command.params['name'] = name unless name.nil?
817
+ command.query['fields'] = fields unless fields.nil?
818
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
819
+ execute_or_queue_command(command, &block)
820
+ end
821
+
718
822
  # Gets your permissions on a resource. Returns an empty set of permissions if
719
823
  # the resource doesn't exist. Supported resources are: - Tag templates - Entry
720
824
  # groups Note: This method gets policies only within Data Catalog and can't be
@@ -754,14 +858,48 @@ module Google
754
858
  execute_or_queue_command(command, &block)
755
859
  end
756
860
 
757
- # Creates a tag and assigns it to: * An Entry if the method name is ``projects.
758
- # locations.entryGroups.entries.tags.create``. * Or EntryGroupif the method name
759
- # is ``projects.locations.entryGroups.tags.create``. Note: The project
760
- # identified by the `parent` parameter for the [tag] (https://cloud.google.com/
761
- # data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.
762
- # tags/create#path-parameters) and the [tag template] (https://cloud.google.com/
763
- # data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#
764
- # path-parameters) used to create the tag must be in the same organization.
861
+ # Marks an Entry as NOT starred by the current user. Starring information is
862
+ # private to each user.
863
+ # @param [String] name
864
+ # Required. The name of the entry to mark as **not** starred.
865
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryRequest] google_cloud_datacatalog_v1_unstar_entry_request_object
866
+ # @param [String] fields
867
+ # Selector specifying which fields to include in a partial response.
868
+ # @param [String] quota_user
869
+ # Available to use for quota purposes for server-side applications. Can be any
870
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
871
+ # @param [Google::Apis::RequestOptions] options
872
+ # Request-specific options
873
+ #
874
+ # @yield [result, err] Result & error if block supplied
875
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse] parsed result object
876
+ # @yieldparam err [StandardError] error object if request failed
877
+ #
878
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse]
879
+ #
880
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
881
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
882
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
883
+ def unstar_project_location_entry_group_entry(name, google_cloud_datacatalog_v1_unstar_entry_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
884
+ command = make_simple_command(:post, 'v1/{+name}:unstar', options)
885
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryRequest::Representation
886
+ command.request_object = google_cloud_datacatalog_v1_unstar_entry_request_object
887
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse::Representation
888
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse
889
+ command.params['name'] = name unless name.nil?
890
+ command.query['fields'] = fields unless fields.nil?
891
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
892
+ execute_or_queue_command(command, &block)
893
+ end
894
+
895
+ # Creates a tag and assigns it to: * An Entry if the method name is `projects.
896
+ # locations.entryGroups.entries.tags.create`. * Or EntryGroupif the method name
897
+ # is `projects.locations.entryGroups.tags.create`. Note: The project identified
898
+ # by the `parent` parameter for the [tag] (https://cloud.google.com/data-catalog/
899
+ # docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-
900
+ # parameters) and the [tag template] (https://cloud.google.com/data-catalog/docs/
901
+ # reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) used
902
+ # to create the tag must be in the same organization.
765
903
  # @param [String] parent
766
904
  # Required. The name of the resource to attach this tag to. Tags can be attached
767
905
  # to entries or entry groups. An entry can have up to 1000 attached tags. Note:
@@ -827,7 +965,7 @@ module Google
827
965
  execute_or_queue_command(command, &block)
828
966
  end
829
967
 
830
- # Lists tags assigned to an Entry.
968
+ # Lists tags assigned to an Entry. The columns in the response are lowercased.
831
969
  # @param [String] parent
832
970
  # Required. The name of the Data Catalog resource to list the tags of. The
833
971
  # resource can be an Entry or an EntryGroup (without `/entries/`entries`` at the
@@ -907,14 +1045,14 @@ module Google
907
1045
  execute_or_queue_command(command, &block)
908
1046
  end
909
1047
 
910
- # Creates a tag and assigns it to: * An Entry if the method name is ``projects.
911
- # locations.entryGroups.entries.tags.create``. * Or EntryGroupif the method name
912
- # is ``projects.locations.entryGroups.tags.create``. Note: The project
913
- # identified by the `parent` parameter for the [tag] (https://cloud.google.com/
914
- # data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.
915
- # tags/create#path-parameters) and the [tag template] (https://cloud.google.com/
916
- # data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#
917
- # path-parameters) used to create the tag must be in the same organization.
1048
+ # Creates a tag and assigns it to: * An Entry if the method name is `projects.
1049
+ # locations.entryGroups.entries.tags.create`. * Or EntryGroupif the method name
1050
+ # is `projects.locations.entryGroups.tags.create`. Note: The project identified
1051
+ # by the `parent` parameter for the [tag] (https://cloud.google.com/data-catalog/
1052
+ # docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-
1053
+ # parameters) and the [tag template] (https://cloud.google.com/data-catalog/docs/
1054
+ # reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) used
1055
+ # to create the tag must be in the same organization.
918
1056
  # @param [String] parent
919
1057
  # Required. The name of the resource to attach this tag to. Tags can be attached
920
1058
  # to entries or entry groups. An entry can have up to 1000 attached tags. Note:
@@ -980,7 +1118,7 @@ module Google
980
1118
  execute_or_queue_command(command, &block)
981
1119
  end
982
1120
 
983
- # Lists tags assigned to an Entry.
1121
+ # Lists tags assigned to an Entry. The columns in the response are lowercased.
984
1122
  # @param [String] parent
985
1123
  # Required. The name of the Data Catalog resource to list the tags of. The
986
1124
  # resource can be an Entry or an EntryGroup (without `/entries/`entries`` at the
@@ -1225,9 +1363,12 @@ module Google
1225
1363
  # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1TagTemplate] google_cloud_datacatalog_v1_tag_template_object
1226
1364
  # @param [String] update_mask
1227
1365
  # Names of fields whose values to overwrite on a tag template. Currently, only `
1228
- # display_name` can be overwritten. If this parameter is absent or empty, all
1229
- # modifiable fields are overwritten. If such fields are non-required and omitted
1230
- # in the request body, their values are emptied.
1366
+ # display_name` and `is_publicly_readable` can be overwritten. If this parameter
1367
+ # is absent or empty, all modifiable fields are overwritten. If such fields are
1368
+ # non-required and omitted in the request body, their values are emptied. Note:
1369
+ # Updating the `is_publicly_readable` field may require up to 12 hours to take
1370
+ # effect in search results. Additionally, it also requires the `tagTemplates.
1371
+ # getIamPolicy` and `tagTemplates.setIamPolicy` permissions.
1231
1372
  # @param [String] fields
1232
1373
  # Selector specifying which fields to include in a partial response.
1233
1374
  # @param [String] quota_user
@@ -1472,7 +1613,7 @@ module Google
1472
1613
  # Catalog resource project] (https://cloud.google.com/data-catalog/docs/concepts/
1473
1614
  # resource-project).
1474
1615
  # @param [String] name
1475
- # Required. The name of the tag template.
1616
+ # Required. The name of the tag template field.
1476
1617
  # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RenameTagTemplateFieldRequest] google_cloud_datacatalog_v1_rename_tag_template_field_request_object
1477
1618
  # @param [String] fields
1478
1619
  # Selector specifying which fields to include in a partial response.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-datacatalog_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.8.0
4
+ version: 0.12.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: 2021-10-04 00:00:00.000000000 Z
11
+ date: 2022-01-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
57
57
  - Apache-2.0
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
- changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-datacatalog_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.8.0
62
- source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-datacatalog_v1
60
+ changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1/CHANGELOG.md
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.12.0
62
+ source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
65
65
  require_paths:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.2.17
78
+ rubygems_version: 3.3.4
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Google Cloud Data Catalog API V1