google-api-client 0.34.0 → 0.34.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (55) hide show
  1. checksums.yaml +4 -4
  2. data/.kokoro/continuous/linux.cfg +2 -2
  3. data/.kokoro/continuous/post.cfg +30 -0
  4. data/.kokoro/presubmit/linux.cfg +1 -1
  5. data/.kokoro/release.cfg +94 -0
  6. data/.repo-metadata.json +5 -0
  7. data/.rubocop.yml +5 -0
  8. data/CHANGELOG.md +18 -0
  9. data/Gemfile +1 -0
  10. data/Rakefile +71 -2
  11. data/generated/google/apis/bigquery_v2.rb +1 -1
  12. data/generated/google/apis/bigquery_v2/classes.rb +33 -0
  13. data/generated/google/apis/bigquery_v2/representations.rb +18 -0
  14. data/generated/google/apis/cloudshell_v1.rb +1 -1
  15. data/generated/google/apis/cloudshell_v1/classes.rb +2 -1
  16. data/generated/google/apis/cloudshell_v1alpha1.rb +1 -1
  17. data/generated/google/apis/cloudshell_v1alpha1/classes.rb +2 -1
  18. data/generated/google/apis/dlp_v2.rb +1 -1
  19. data/generated/google/apis/dlp_v2/classes.rb +25 -0
  20. data/generated/google/apis/dlp_v2/representations.rb +14 -0
  21. data/generated/google/apis/dlp_v2/service.rb +55 -43
  22. data/generated/google/apis/docs_v1.rb +1 -1
  23. data/generated/google/apis/docs_v1/classes.rb +8 -4
  24. data/generated/google/apis/genomics_v2alpha1.rb +1 -1
  25. data/generated/google/apis/recommender_v1beta1.rb +1 -1
  26. data/generated/google/apis/redis_v1.rb +1 -1
  27. data/generated/google/apis/redis_v1/classes.rb +11 -11
  28. data/generated/google/apis/redis_v1/service.rb +5 -5
  29. data/generated/google/apis/redis_v1beta1.rb +1 -1
  30. data/generated/google/apis/redis_v1beta1/classes.rb +11 -11
  31. data/generated/google/apis/redis_v1beta1/service.rb +5 -5
  32. data/generated/google/apis/securitycenter_v1.rb +1 -1
  33. data/generated/google/apis/securitycenter_v1/classes.rb +22 -18
  34. data/generated/google/apis/securitycenter_v1/service.rb +14 -12
  35. data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
  36. data/generated/google/apis/securitycenter_v1beta1/classes.rb +8 -7
  37. data/generated/google/apis/securitycenter_v1beta1/service.rb +14 -12
  38. data/generated/google/apis/sheets_v4.rb +1 -1
  39. data/generated/google/apis/sheets_v4/classes.rb +768 -18
  40. data/generated/google/apis/sheets_v4/representations.rb +101 -0
  41. data/generated/google/apis/vision_v1.rb +1 -1
  42. data/generated/google/apis/vision_v1/classes.rb +66 -0
  43. data/generated/google/apis/vision_v1/representations.rb +32 -0
  44. data/generated/google/apis/vision_v1p1beta1.rb +1 -1
  45. data/generated/google/apis/vision_v1p1beta1/classes.rb +66 -0
  46. data/generated/google/apis/vision_v1p1beta1/representations.rb +32 -0
  47. data/generated/google/apis/vision_v1p2beta1.rb +1 -1
  48. data/generated/google/apis/vision_v1p2beta1/classes.rb +66 -0
  49. data/generated/google/apis/vision_v1p2beta1/representations.rb +32 -0
  50. data/lib/google/apis/core/upload.rb +4 -0
  51. data/lib/google/apis/version.rb +1 -1
  52. data/rakelib/devsite/devsite_builder.rb +126 -0
  53. data/rakelib/devsite/link_checker.rb +64 -0
  54. data/rakelib/devsite/repo_metadata.rb +56 -0
  55. metadata +9 -3
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/docs/
26
26
  module DocsV1
27
27
  VERSION = 'V1'
28
- REVISION = '20191017'
28
+ REVISION = '20191029'
29
29
 
30
30
  # View and manage your Google Docs documents
31
31
  AUTH_DOCUMENTS = 'https://www.googleapis.com/auth/documents'
@@ -365,7 +365,8 @@ module Google
365
365
  end
366
366
 
367
367
  # Creates a Footer. The new footer will be
368
- # applied to the DocumentStyle.
368
+ # applied to SectionStyle or the
369
+ # DocumentStyle.
369
370
  # If a footer of the specified type already exists then a 400 bad request error
370
371
  # will be returned.
371
372
  class CreateFooterRequest
@@ -406,7 +407,8 @@ module Google
406
407
  end
407
408
 
408
409
  # Creates a Header. The new header will be
409
- # applied to the DocumentStyle.
410
+ # applied to SectionStyle or the
411
+ # DocumentStyle.
410
412
  # If a header of the specified type already exists then a 400 bad request error
411
413
  # will be returned.
412
414
  class CreateHeaderRequest
@@ -3840,7 +3842,8 @@ module Google
3840
3842
  include Google::Apis::Core::Hashable
3841
3843
 
3842
3844
  # Creates a Footer. The new footer will be
3843
- # applied to the DocumentStyle.
3845
+ # applied to SectionStyle or the
3846
+ # DocumentStyle.
3844
3847
  # If a footer of the specified type already exists then a 400 bad request error
3845
3848
  # will be returned.
3846
3849
  # Corresponds to the JSON property `createFooter`
@@ -3848,7 +3851,8 @@ module Google
3848
3851
  attr_accessor :create_footer
3849
3852
 
3850
3853
  # Creates a Header. The new header will be
3851
- # applied to the DocumentStyle.
3854
+ # applied to SectionStyle or the
3855
+ # DocumentStyle.
3852
3856
  # If a header of the specified type already exists then a 400 bad request error
3853
3857
  # will be returned.
3854
3858
  # Corresponds to the JSON property `createHeader`
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/genomics
26
26
  module GenomicsV2alpha1
27
27
  VERSION = 'V2alpha1'
28
- REVISION = '20190822'
28
+ REVISION = '20191102'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/recommender/docs/
26
26
  module RecommenderV1beta1
27
27
  VERSION = 'V1beta1'
28
- REVISION = '20190922'
28
+ REVISION = '20191102'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/memorystore/docs/redis/
26
26
  module RedisV1
27
27
  VERSION = 'V1'
28
- REVISION = '20190620'
28
+ REVISION = '20191104'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -258,7 +258,7 @@ module Google
258
258
 
259
259
  # Optional. Only applicable to STANDARD_HA tier which protects the instance
260
260
  # against zonal failures by provisioning it across two zones. If provided, it
261
- # must be a different zone from the one provided in [location_id].
261
+ # must be a different zone from the one provided in location_id.
262
262
  # Corresponds to the JSON property `alternativeLocationId`
263
263
  # @return [String]
264
264
  attr_accessor :alternative_location_id
@@ -277,9 +277,9 @@ module Google
277
277
  attr_accessor :create_time
278
278
 
279
279
  # Output only. The current zone where the Redis endpoint is placed. For Basic
280
- # Tier instances, this will always be the same as the [location_id]
280
+ # Tier instances, this will always be the same as the location_id
281
281
  # provided by the user at creation time. For Standard Tier instances,
282
- # this can be either [location_id] or [alternative_location_id] and can
282
+ # this can be either location_id or alternative_location_id and can
283
283
  # change after a failover event.
284
284
  # Corresponds to the JSON property `currentLocationId`
285
285
  # @return [String]
@@ -304,8 +304,8 @@ module Google
304
304
  # Optional. The zone where the instance will be provisioned. If not provided,
305
305
  # the service will choose a zone for the instance. For STANDARD_HA tier,
306
306
  # instances will be created across two zones for protection against zonal
307
- # failures. If [alternative_location_id] is also provided, it must be
308
- # different from [location_id].
307
+ # failures. If alternative_location_id is also provided, it must be
308
+ # different from location_id.
309
309
  # Corresponds to the JSON property `locationId`
310
310
  # @return [String]
311
311
  attr_accessor :location_id
@@ -321,8 +321,8 @@ module Google
321
321
  # Note: Redis instances are managed and addressed at regional level so
322
322
  # location_id here refers to a GCP region; however, users may choose which
323
323
  # specific zone (or collection of zones for cross-zone instances) an instance
324
- # should be provisioned in. Refer to [location_id] and
325
- # [alternative_location_id] fields for more details.
324
+ # should be provisioned in. Refer to location_id and
325
+ # alternative_location_id fields for more details.
326
326
  # Corresponds to the JSON property `name`
327
327
  # @return [String]
328
328
  attr_accessor :name
@@ -425,10 +425,10 @@ module Google
425
425
  # If the `location_id` in the parent field of the request is "-", all regions
426
426
  # available to the project are queried, and the results aggregated.
427
427
  # If in such an aggregated query a location is unavailable, a dummy Redis
428
- # entry is included in the response with the "name" field set to a value of
429
- # the form projects/`project_id`/locations/`location_id`/instances/- and the
430
- # "status" field set to ERROR and "status_message" field set to "location not
431
- # available for ListInstances".
428
+ # entry is included in the response with the `name` field set to a value of
429
+ # the form `projects/`project_id`/locations/`location_id`/instances/`- and
430
+ # the `status` field set to ERROR and `status_message` field set to "location
431
+ # not available for ListInstances".
432
432
  # Corresponds to the JSON property `instances`
433
433
  # @return [Array<Google::Apis::RedisV1::Instance>]
434
434
  attr_accessor :instances
@@ -362,11 +362,11 @@ module Google
362
362
  # If not specified, a default value of 1000 will be used by the service.
363
363
  # Regardless of the page_size value, the response may include a partial list
364
364
  # and a caller should only rely on response's
365
- # next_page_token
365
+ # `next_page_token`
366
366
  # to determine if there are more instances left to be queried.
367
367
  # @param [String] page_token
368
- # The next_page_token value returned from a previous List request,
369
- # if any.
368
+ # The `next_page_token` value returned from a previous
369
+ # ListInstances request, if any.
370
370
  # @param [String] fields
371
371
  # Selector specifying which fields to include in a partial response.
372
372
  # @param [String] quota_user
@@ -407,8 +407,8 @@ module Google
407
407
  # Note: Redis instances are managed and addressed at regional level so
408
408
  # location_id here refers to a GCP region; however, users may choose which
409
409
  # specific zone (or collection of zones for cross-zone instances) an instance
410
- # should be provisioned in. Refer to [location_id] and
411
- # [alternative_location_id] fields for more details.
410
+ # should be provisioned in. Refer to location_id and
411
+ # alternative_location_id fields for more details.
412
412
  # @param [Google::Apis::RedisV1::Instance] instance_object
413
413
  # @param [String] update_mask
414
414
  # Required. Mask of fields to update. At least one path must be supplied in
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/memorystore/docs/redis/
26
26
  module RedisV1beta1
27
27
  VERSION = 'V1beta1'
28
- REVISION = '20190620'
28
+ REVISION = '20191104'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -261,7 +261,7 @@ module Google
261
261
 
262
262
  # Optional. Only applicable to STANDARD_HA tier which protects the instance
263
263
  # against zonal failures by provisioning it across two zones. If provided, it
264
- # must be a different zone from the one provided in [location_id].
264
+ # must be a different zone from the one provided in location_id.
265
265
  # Corresponds to the JSON property `alternativeLocationId`
266
266
  # @return [String]
267
267
  attr_accessor :alternative_location_id
@@ -280,9 +280,9 @@ module Google
280
280
  attr_accessor :create_time
281
281
 
282
282
  # Output only. The current zone where the Redis endpoint is placed. For Basic
283
- # Tier instances, this will always be the same as the [location_id]
283
+ # Tier instances, this will always be the same as the location_id
284
284
  # provided by the user at creation time. For Standard Tier instances,
285
- # this can be either [location_id] or [alternative_location_id] and can
285
+ # this can be either location_id or alternative_location_id and can
286
286
  # change after a failover event.
287
287
  # Corresponds to the JSON property `currentLocationId`
288
288
  # @return [String]
@@ -307,8 +307,8 @@ module Google
307
307
  # Optional. The zone where the instance will be provisioned. If not provided,
308
308
  # the service will choose a zone for the instance. For STANDARD_HA tier,
309
309
  # instances will be created across two zones for protection against zonal
310
- # failures. If [alternative_location_id] is also provided, it must be
311
- # different from [location_id].
310
+ # failures. If alternative_location_id is also provided, it must be
311
+ # different from location_id.
312
312
  # Corresponds to the JSON property `locationId`
313
313
  # @return [String]
314
314
  attr_accessor :location_id
@@ -324,8 +324,8 @@ module Google
324
324
  # Note: Redis instances are managed and addressed at regional level so
325
325
  # location_id here refers to a GCP region; however, users may choose which
326
326
  # specific zone (or collection of zones for cross-zone instances) an instance
327
- # should be provisioned in. Refer to [location_id] and
328
- # [alternative_location_id] fields for more details.
327
+ # should be provisioned in. Refer to location_id and
328
+ # alternative_location_id fields for more details.
329
329
  # Corresponds to the JSON property `name`
330
330
  # @return [String]
331
331
  attr_accessor :name
@@ -428,10 +428,10 @@ module Google
428
428
  # If the `location_id` in the parent field of the request is "-", all regions
429
429
  # available to the project are queried, and the results aggregated.
430
430
  # If in such an aggregated query a location is unavailable, a dummy Redis
431
- # entry is included in the response with the "name" field set to a value of
432
- # the form projects/`project_id`/locations/`location_id`/instances/- and the
433
- # "status" field set to ERROR and "status_message" field set to "location not
434
- # available for ListInstances".
431
+ # entry is included in the response with the `name` field set to a value of
432
+ # the form `projects/`project_id`/locations/`location_id`/instances/`- and
433
+ # the `status` field set to ERROR and `status_message` field set to "location
434
+ # not available for ListInstances".
435
435
  # Corresponds to the JSON property `instances`
436
436
  # @return [Array<Google::Apis::RedisV1beta1::Instance>]
437
437
  attr_accessor :instances
@@ -362,11 +362,11 @@ module Google
362
362
  # If not specified, a default value of 1000 will be used by the service.
363
363
  # Regardless of the page_size value, the response may include a partial list
364
364
  # and a caller should only rely on response's
365
- # next_page_token
365
+ # `next_page_token`
366
366
  # to determine if there are more instances left to be queried.
367
367
  # @param [String] page_token
368
- # The next_page_token value returned from a previous List request,
369
- # if any.
368
+ # The `next_page_token` value returned from a previous
369
+ # ListInstances request, if any.
370
370
  # @param [String] fields
371
371
  # Selector specifying which fields to include in a partial response.
372
372
  # @param [String] quota_user
@@ -407,8 +407,8 @@ module Google
407
407
  # Note: Redis instances are managed and addressed at regional level so
408
408
  # location_id here refers to a GCP region; however, users may choose which
409
409
  # specific zone (or collection of zones for cross-zone instances) an instance
410
- # should be provisioned in. Refer to [location_id] and
411
- # [alternative_location_id] fields for more details.
410
+ # should be provisioned in. Refer to location_id and
411
+ # alternative_location_id fields for more details.
412
412
  # @param [Google::Apis::RedisV1beta1::Instance] instance_object
413
413
  # @param [String] update_mask
414
414
  # Required. Mask of fields to update. At least one path must be supplied in
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
27
27
  module SecuritycenterV1
28
28
  VERSION = 'V1'
29
- REVISION = '20191004'
29
+ REVISION = '20191101'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -45,7 +45,7 @@ module Google
45
45
  # The relative resource name of this asset. See:
46
46
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
47
47
  # Example:
48
- # "organizations/123/assets/456".
48
+ # "organizations/`organization_id`/assets/`asset_id`".
49
49
  # Corresponds to the JSON property `name`
50
50
  # @return [String]
51
51
  attr_accessor :name
@@ -348,10 +348,11 @@ module Google
348
348
  end
349
349
 
350
350
  # Cloud Security Command Center (Cloud SCC) finding.
351
- # A finding is a record of assessment data (security, risk, health or privacy)
352
- # ingested into Cloud SCC for presentation, notification, analysis,
353
- # policy testing, and enforcement. For example, an XSS vulnerability in an
354
- # App Engine application is a finding.
351
+ # A finding is a record of assessment data like security, risk, health, or
352
+ # privacy, that is ingested into Cloud SCC for presentation, notification,
353
+ # analysis, policy testing, and enforcement. For example, a
354
+ # cross-site scripting (XSS) vulnerability in an App Engine application is a
355
+ # finding.
355
356
  class Finding
356
357
  include Google::Apis::Core::Hashable
357
358
 
@@ -384,7 +385,7 @@ module Google
384
385
  # The relative resource name of this finding. See:
385
386
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
386
387
  # Example:
387
- # "organizations/123/sources/456/findings/789"
388
+ # "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`"
388
389
  # Corresponds to the JSON property `name`
389
390
  # @return [String]
390
391
  attr_accessor :name
@@ -393,7 +394,7 @@ module Google
393
394
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
394
395
  # This field is immutable after creation time.
395
396
  # For example:
396
- # "organizations/123/sources/456"
397
+ # "organizations/`organization_id`/sources/`source_id`"
397
398
  # Corresponds to the JSON property `parent`
398
399
  # @return [String]
399
400
  attr_accessor :parent
@@ -1019,10 +1020,11 @@ module Google
1019
1020
  include Google::Apis::Core::Hashable
1020
1021
 
1021
1022
  # Cloud Security Command Center (Cloud SCC) finding.
1022
- # A finding is a record of assessment data (security, risk, health or privacy)
1023
- # ingested into Cloud SCC for presentation, notification, analysis,
1024
- # policy testing, and enforcement. For example, an XSS vulnerability in an
1025
- # App Engine application is a finding.
1023
+ # A finding is a record of assessment data like security, risk, health, or
1024
+ # privacy, that is ingested into Cloud SCC for presentation, notification,
1025
+ # analysis, policy testing, and enforcement. For example, a
1026
+ # cross-site scripting (XSS) vulnerability in an App Engine application is a
1027
+ # finding.
1026
1028
  # Corresponds to the JSON property `finding`
1027
1029
  # @return [Google::Apis::SecuritycenterV1::Finding]
1028
1030
  attr_accessor :finding
@@ -1180,7 +1182,7 @@ module Google
1180
1182
  # The relative resource name of the settings. See:
1181
1183
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
1182
1184
  # Example:
1183
- # "organizations/123/organizationSettings".
1185
+ # "organizations/`organization_id`/organizationSettings".
1184
1186
  # Corresponds to the JSON property `name`
1185
1187
  # @return [String]
1186
1188
  attr_accessor :name
@@ -1390,8 +1392,9 @@ module Google
1390
1392
  # The relative resource name of the SecurityMarks. See:
1391
1393
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
1392
1394
  # Examples:
1393
- # "organizations/123/assets/456/securityMarks"
1394
- # "organizations/123/sources/456/findings/789/securityMarks".
1395
+ # "organizations/`organization_id`/assets/`asset_id`/securityMarks"
1396
+ # "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`/
1397
+ # securityMarks".
1395
1398
  # Corresponds to the JSON property `name`
1396
1399
  # @return [String]
1397
1400
  attr_accessor :name
@@ -1512,17 +1515,18 @@ module Google
1512
1515
 
1513
1516
  # Cloud Security Command Center's (Cloud SCC) finding source. A finding source
1514
1517
  # is an entity or a mechanism that can produce a finding. A source is like a
1515
- # container of findings that come from the same scanner, logger, monitor, etc.
1518
+ # container of findings that come from the same scanner, logger, monitor, and
1519
+ # other tools.
1516
1520
  class Source
1517
1521
  include Google::Apis::Core::Hashable
1518
1522
 
1519
1523
  # The description of the source (max of 1024 characters).
1520
1524
  # Example:
1521
- # "Cloud Security Scanner is a web security scanner for common
1525
+ # "Web Security Scanner is a web security scanner for common
1522
1526
  # vulnerabilities in App Engine applications. It can automatically
1523
1527
  # scan and detect four common vulnerabilities, including cross-site-scripting
1524
1528
  # (XSS), Flash injection, mixed content (HTTP in HTTPS), and
1525
- # outdated/insecure libraries."
1529
+ # outdated or insecure libraries."
1526
1530
  # Corresponds to the JSON property `description`
1527
1531
  # @return [String]
1528
1532
  attr_accessor :description
@@ -1539,7 +1543,7 @@ module Google
1539
1543
  # The relative resource name of this source. See:
1540
1544
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
1541
1545
  # Example:
1542
- # "organizations/123/sources/456"
1546
+ # "organizations/`organization_id`/sources/`source_id`"
1543
1547
  # Corresponds to the JSON property `name`
1544
1548
  # @return [String]
1545
1549
  attr_accessor :name
@@ -85,7 +85,7 @@ module Google
85
85
  # The relative resource name of the settings. See:
86
86
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
87
87
  # Example:
88
- # "organizations/123/organizationSettings".
88
+ # "organizations/`organization_id`/organizationSettings".
89
89
  # @param [Google::Apis::SecuritycenterV1::OrganizationSettings] organization_settings_object
90
90
  # @param [String] update_mask
91
91
  # The FieldMask to use when updating the settings resource.
@@ -333,8 +333,9 @@ module Google
333
333
  # The relative resource name of the SecurityMarks. See:
334
334
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
335
335
  # Examples:
336
- # "organizations/123/assets/456/securityMarks"
337
- # "organizations/123/sources/456/findings/789/securityMarks".
336
+ # "organizations/`organization_id`/assets/`asset_id`/securityMarks"
337
+ # "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`/
338
+ # securityMarks".
338
339
  # @param [Google::Apis::SecuritycenterV1::SecurityMarks] security_marks_object
339
340
  # @param [String] start_time
340
341
  # The time at which the updated SecurityMarks take effect.
@@ -671,7 +672,7 @@ module Google
671
672
  # The relative resource name of this source. See:
672
673
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
673
674
  # Example:
674
- # "organizations/123/sources/456"
675
+ # "organizations/`organization_id`/sources/`source_id`"
675
676
  # @param [Google::Apis::SecuritycenterV1::Source] source_object
676
677
  # @param [String] update_mask
677
678
  # The FieldMask to use when updating the source resource.
@@ -817,12 +818,12 @@ module Google
817
818
  # Filters an organization or source's findings and groups them by their
818
819
  # specified properties.
819
820
  # To group across all sources provide a `-` as the source id.
820
- # Example: /v1/organizations/123/sources/-/findings
821
+ # Example: /v1/organizations/`organization_id`/sources/-/findings
821
822
  # @param [String] parent
822
823
  # Required. Name of the source to groupBy. Its format is
823
824
  # "organizations/[organization_id]/sources/[source_id]". To groupBy across
824
825
  # all sources provide a source_id of `-`. For example:
825
- # organizations/123/sources/-
826
+ # organizations/`organization_id`/sources/-
826
827
  # @param [Google::Apis::SecuritycenterV1::GroupFindingsRequest] group_findings_request_object
827
828
  # @param [String] fields
828
829
  # Selector specifying which fields to include in a partial response.
@@ -855,12 +856,12 @@ module Google
855
856
 
856
857
  # Lists an organization or source's findings.
857
858
  # To list across all sources provide a `-` as the source id.
858
- # Example: /v1/organizations/123/sources/-/findings
859
+ # Example: /v1/organizations/`organization_id`/sources/-/findings
859
860
  # @param [String] parent
860
861
  # Required. Name of the source the findings belong to. Its format is
861
862
  # "organizations/[organization_id]/sources/[source_id]". To list across all
862
863
  # sources provide a source_id of `-`. For example:
863
- # organizations/123/sources/-
864
+ # organizations/`organization_id`/sources/-
864
865
  # @param [String] compare_duration
865
866
  # When compare_duration is set, the ListFindingsResult's "state_change"
866
867
  # attribute is updated to indicate whether the finding had its state changed,
@@ -989,7 +990,7 @@ module Google
989
990
  # The relative resource name of this finding. See:
990
991
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
991
992
  # Example:
992
- # "organizations/123/sources/456/findings/789"
993
+ # "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`"
993
994
  # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
994
995
  # @param [String] update_mask
995
996
  # The FieldMask to use when updating the finding resource. This field should
@@ -1033,7 +1034,7 @@ module Google
1033
1034
  # Required. The relative resource name of the finding. See:
1034
1035
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
1035
1036
  # Example:
1036
- # "organizations/123/sources/456/finding/789".
1037
+ # "organizations/`organization_id`/sources/`source_id`/finding/`finding_id`".
1037
1038
  # @param [Google::Apis::SecuritycenterV1::SetFindingStateRequest] set_finding_state_request_object
1038
1039
  # @param [String] fields
1039
1040
  # Selector specifying which fields to include in a partial response.
@@ -1069,8 +1070,9 @@ module Google
1069
1070
  # The relative resource name of the SecurityMarks. See:
1070
1071
  # https://cloud.google.com/apis/design/resource_names#relative_resource_name
1071
1072
  # Examples:
1072
- # "organizations/123/assets/456/securityMarks"
1073
- # "organizations/123/sources/456/findings/789/securityMarks".
1073
+ # "organizations/`organization_id`/assets/`asset_id`/securityMarks"
1074
+ # "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`/
1075
+ # securityMarks".
1074
1076
  # @param [Google::Apis::SecuritycenterV1::SecurityMarks] security_marks_object
1075
1077
  # @param [String] start_time
1076
1078
  # The time at which the updated SecurityMarks take effect.