google-api-client 0.30.4 → 0.30.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (117) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +44 -0
  3. data/generated/google/apis/androidpublisher_v3.rb +1 -1
  4. data/generated/google/apis/androidpublisher_v3/classes.rb +50 -0
  5. data/generated/google/apis/androidpublisher_v3/representations.rb +18 -0
  6. data/generated/google/apis/bigquery_v2.rb +1 -1
  7. data/generated/google/apis/bigquery_v2/service.rb +1 -1
  8. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  9. data/generated/google/apis/bigtableadmin_v2/classes.rb +22 -85
  10. data/generated/google/apis/bigtableadmin_v2/service.rb +6 -105
  11. data/generated/google/apis/binaryauthorization_v1beta1.rb +1 -1
  12. data/generated/google/apis/binaryauthorization_v1beta1/service.rb +14 -2
  13. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  14. data/generated/google/apis/cloudbuild_v1/classes.rb +5 -2
  15. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  16. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +28 -0
  17. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +15 -0
  18. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  19. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +28 -0
  20. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +15 -0
  21. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  22. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +28 -0
  23. data/generated/google/apis/cloudresourcemanager_v2/representations.rb +15 -0
  24. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  25. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +28 -0
  26. data/generated/google/apis/cloudresourcemanager_v2beta1/representations.rb +15 -0
  27. data/generated/google/apis/content_v2.rb +1 -1
  28. data/generated/google/apis/content_v2/classes.rb +41 -2
  29. data/generated/google/apis/content_v2/representations.rb +18 -0
  30. data/generated/google/apis/content_v2/service.rb +4 -5
  31. data/generated/google/apis/content_v2_1.rb +1 -1
  32. data/generated/google/apis/content_v2_1/classes.rb +41 -2
  33. data/generated/google/apis/content_v2_1/representations.rb +18 -0
  34. data/generated/google/apis/content_v2_1/service.rb +12 -7
  35. data/generated/google/apis/dataflow_v1b3.rb +1 -1
  36. data/generated/google/apis/dataflow_v1b3/classes.rb +23 -0
  37. data/generated/google/apis/dataflow_v1b3/representations.rb +3 -0
  38. data/generated/google/apis/dfareporting_v3_1.rb +1 -1
  39. data/generated/google/apis/dfareporting_v3_2.rb +1 -1
  40. data/generated/google/apis/dfareporting_v3_3.rb +1 -1
  41. data/generated/google/apis/dfareporting_v3_3/classes.rb +20 -9
  42. data/generated/google/apis/dfareporting_v3_3/representations.rb +1 -0
  43. data/generated/google/apis/dialogflow_v2.rb +1 -1
  44. data/generated/google/apis/dialogflow_v2/classes.rb +402 -0
  45. data/generated/google/apis/dialogflow_v2/representations.rb +173 -0
  46. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  47. data/generated/google/apis/dialogflow_v2beta1/classes.rb +402 -0
  48. data/generated/google/apis/dialogflow_v2beta1/representations.rb +173 -0
  49. data/generated/google/apis/dlp_v2.rb +1 -1
  50. data/generated/google/apis/dlp_v2/classes.rb +44 -0
  51. data/generated/google/apis/dlp_v2/representations.rb +15 -0
  52. data/generated/google/apis/dlp_v2/service.rb +43 -0
  53. data/generated/google/apis/docs_v1.rb +1 -1
  54. data/generated/google/apis/docs_v1/classes.rb +17 -16
  55. data/generated/google/apis/file_v1.rb +1 -1
  56. data/generated/google/apis/file_v1/classes.rb +11 -10
  57. data/generated/google/apis/file_v1/representations.rb +1 -0
  58. data/generated/google/apis/file_v1/service.rb +1 -2
  59. data/generated/google/apis/file_v1beta1.rb +1 -1
  60. data/generated/google/apis/file_v1beta1/classes.rb +11 -10
  61. data/generated/google/apis/file_v1beta1/representations.rb +1 -0
  62. data/generated/google/apis/file_v1beta1/service.rb +1 -2
  63. data/generated/google/apis/firebase_v1beta1.rb +1 -1
  64. data/generated/google/apis/firebase_v1beta1/classes.rb +1 -1
  65. data/generated/google/apis/firebase_v1beta1/service.rb +4 -1
  66. data/generated/google/apis/fitness_v1.rb +1 -1
  67. data/generated/google/apis/fitness_v1/classes.rb +1 -3
  68. data/generated/google/apis/healthcare_v1alpha2.rb +1 -1
  69. data/generated/google/apis/healthcare_v1alpha2/classes.rb +107 -0
  70. data/generated/google/apis/healthcare_v1alpha2/representations.rb +46 -0
  71. data/generated/google/apis/iam_v1.rb +1 -1
  72. data/generated/google/apis/iam_v1/classes.rb +1 -1
  73. data/generated/google/apis/iam_v1/service.rb +306 -51
  74. data/generated/google/apis/iap_v1.rb +1 -1
  75. data/generated/google/apis/iap_v1/classes.rb +28 -0
  76. data/generated/google/apis/iap_v1/representations.rb +15 -0
  77. data/generated/google/apis/iap_v1beta1.rb +1 -1
  78. data/generated/google/apis/iap_v1beta1/classes.rb +28 -0
  79. data/generated/google/apis/iap_v1beta1/representations.rb +15 -0
  80. data/generated/google/apis/ml_v1.rb +1 -1
  81. data/generated/google/apis/ml_v1/classes.rb +8 -0
  82. data/generated/google/apis/ml_v1/representations.rb +1 -0
  83. data/generated/google/apis/ml_v1/service.rb +0 -33
  84. data/generated/google/apis/securitycenter_v1.rb +1 -1
  85. data/generated/google/apis/securitycenter_v1/classes.rb +28 -0
  86. data/generated/google/apis/securitycenter_v1/representations.rb +15 -0
  87. data/generated/google/apis/securitycenter_v1/service.rb +4 -4
  88. data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
  89. data/generated/google/apis/securitycenter_v1beta1/classes.rb +28 -0
  90. data/generated/google/apis/securitycenter_v1beta1/representations.rb +15 -0
  91. data/generated/google/apis/securitycenter_v1beta1/service.rb +4 -4
  92. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  93. data/generated/google/apis/servicemanagement_v1/classes.rb +28 -0
  94. data/generated/google/apis/servicemanagement_v1/representations.rb +15 -0
  95. data/generated/google/apis/slides_v1.rb +1 -1
  96. data/generated/google/apis/speech_v1.rb +1 -1
  97. data/generated/google/apis/speech_v1/classes.rb +2 -8
  98. data/generated/google/apis/speech_v1p1beta1.rb +1 -1
  99. data/generated/google/apis/speech_v1p1beta1/classes.rb +2 -8
  100. data/generated/google/apis/tasks_v1.rb +1 -1
  101. data/generated/google/apis/tasks_v1/classes.rb +4 -1
  102. data/generated/google/apis/texttospeech_v1.rb +1 -1
  103. data/generated/google/apis/texttospeech_v1/classes.rb +4 -4
  104. data/generated/google/apis/texttospeech_v1beta1.rb +1 -1
  105. data/generated/google/apis/texttospeech_v1beta1/classes.rb +4 -4
  106. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  107. data/generated/google/apis/toolresults_v1beta3/classes.rb +8 -0
  108. data/generated/google/apis/toolresults_v1beta3/representations.rb +1 -0
  109. data/generated/google/apis/websecurityscanner_v1alpha.rb +1 -1
  110. data/generated/google/apis/websecurityscanner_v1alpha/classes.rb +44 -66
  111. data/generated/google/apis/websecurityscanner_v1alpha/service.rb +24 -26
  112. data/generated/google/apis/websecurityscanner_v1beta.rb +1 -1
  113. data/generated/google/apis/websecurityscanner_v1beta/classes.rb +52 -78
  114. data/generated/google/apis/websecurityscanner_v1beta/service.rb +24 -26
  115. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  116. data/lib/google/apis/version.rb +1 -1
  117. metadata +2 -2
@@ -199,6 +199,7 @@ module Google
199
199
  class Representation < Google::Apis::Core::JsonRepresentation
200
200
  collection :exclusions, as: 'exclusions', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation
201
201
 
202
+ property :location, as: 'location'
202
203
  property :node_id, as: 'nodeId'
203
204
  end
204
205
  end
@@ -267,8 +267,7 @@ module Google
267
267
 
268
268
  # Updates the settings of a specific instance.
269
269
  # @param [String] name
270
- # Output only.
271
- # The resource name of the instance, in the format
270
+ # Output only. The resource name of the instance, in the format
272
271
  # projects/`project_id`/locations/`location_id`/instances/`instance_id`.
273
272
  # @param [Google::Apis::FileV1beta1::Instance] instance_object
274
273
  # @param [String] update_mask
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://firebase.google.com
27
27
  module FirebaseV1beta1
28
28
  VERSION = 'V1beta1'
29
- REVISION = '20190620'
29
+ REVISION = '20190703'
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'
@@ -870,7 +870,7 @@ module Google
870
870
 
871
871
  # The fully qualified resource name of the `sha-key`, in the format:
872
872
  # <br><code>projects/<var>projectId</var>/androidApps/<var>appId</var>/sha/<var>
873
- # shaHash</var></code>
873
+ # shaId</var></code>
874
874
  # Corresponds to the JSON property `name`
875
875
  # @return [String]
876
876
  attr_accessor :name
@@ -646,7 +646,10 @@ module Google
646
646
  # @param [String] name
647
647
  # The fully qualified resource name of the `sha-key`, in the format:
648
648
  # <br><code>projects/<var>projectId</var>/androidApps/<var>appId</var>/sha/<var>
649
- # shaHash</var></code>
649
+ # shaId</var></code>
650
+ # <br>You can obtain the full name from the response of
651
+ # [`ListShaCertificates`](../projects.androidApps.sha/list) or the original
652
+ # [`CreateShaCertificate`](../projects.androidApps.sha/create).
650
653
  # @param [String] fields
651
654
  # Selector specifying which fields to include in a partial response.
652
655
  # @param [String] quota_user
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/fit/rest/
26
26
  module FitnessV1
27
27
  VERSION = 'V1'
28
- REVISION = '20190408'
28
+ REVISION = '20190627'
29
29
 
30
30
  # View your activity information in Google Fit
31
31
  AUTH_FITNESS_ACTIVITY_READ = 'https://www.googleapis.com/auth/fitness.activity.read'
@@ -151,9 +151,7 @@ module Google
151
151
  # @return [Fixnum]
152
152
  attr_accessor :end_time_millis
153
153
 
154
- # DO NOT POPULATE THIS FIELD. As data quality standards are deprecated, filling
155
- # it in will result in no data sources being returned. It will be removed in a
156
- # future version entirely.
154
+ # DO NOT POPULATE THIS FIELD. It is ignored.
157
155
  # Corresponds to the JSON property `filteredDataQualityStandard`
158
156
  # @return [Array<String>]
159
157
  attr_accessor :filtered_data_quality_standard
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/healthcare
26
26
  module HealthcareV1alpha2
27
27
  VERSION = 'V1alpha2'
28
- REVISION = '20190626'
28
+ REVISION = '20190628'
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'
@@ -950,6 +950,17 @@ module Google
950
950
  # @return [Array<Google::Apis::HealthcareV1alpha2::StreamConfig>]
951
951
  attr_accessor :stream_configs
952
952
 
953
+ # Configuration of FHIR Subscription:
954
+ # https://www.hl7.org/fhir/subscription.html.
955
+ # Corresponds to the JSON property `subscriptionConfig`
956
+ # @return [Google::Apis::HealthcareV1alpha2::SubscriptionConfig]
957
+ attr_accessor :subscription_config
958
+
959
+ # This structure contains the configuration for FHIR profiles and validation.
960
+ # Corresponds to the JSON property `validationConfig`
961
+ # @return [Google::Apis::HealthcareV1alpha2::ValidationConfig]
962
+ attr_accessor :validation_config
963
+
953
964
  def initialize(**args)
954
965
  update!(**args)
955
966
  end
@@ -964,6 +975,8 @@ module Google
964
975
  @name = args[:name] if args.key?(:name)
965
976
  @notification_config = args[:notification_config] if args.key?(:notification_config)
966
977
  @stream_configs = args[:stream_configs] if args.key?(:stream_configs)
978
+ @subscription_config = args[:subscription_config] if args.key?(:subscription_config)
979
+ @validation_config = args[:validation_config] if args.key?(:validation_config)
967
980
  end
968
981
  end
969
982
 
@@ -2707,6 +2720,65 @@ module Google
2707
2720
  end
2708
2721
  end
2709
2722
 
2723
+ # Configuration of FHIR Subscription:
2724
+ # https://www.hl7.org/fhir/subscription.html.
2725
+ class SubscriptionConfig
2726
+ include Google::Apis::Core::Hashable
2727
+
2728
+ # REST hook endpoints that are allowed to receive subscription notifications.
2729
+ # The create or update operation on a FHIR Subscription resource will fail if
2730
+ # the FHIR Subscription resource contains a REST hook endpoint that is not in
2731
+ # this list.
2732
+ # A subscription notification push will fail if the FHIR Subscription
2733
+ # resource contains a REST hook endpoint that is not in this list.
2734
+ # The REST hook endpoint in a subscription resource will be compared with the
2735
+ # endpoints in this list by exact matching.
2736
+ # Users must verify their ownership of the domain of an endpoint before
2737
+ # adding it to this list. To verify domain ownership, go to
2738
+ # https://search.google.com/search-console/welcome.
2739
+ # Corresponds to the JSON property `allowedRestHookEndpoints`
2740
+ # @return [Array<Google::Apis::HealthcareV1alpha2::SubscriptionRestHookEndpoint>]
2741
+ attr_accessor :allowed_rest_hook_endpoints
2742
+
2743
+ def initialize(**args)
2744
+ update!(**args)
2745
+ end
2746
+
2747
+ # Update properties of this object
2748
+ def update!(**args)
2749
+ @allowed_rest_hook_endpoints = args[:allowed_rest_hook_endpoints] if args.key?(:allowed_rest_hook_endpoints)
2750
+ end
2751
+ end
2752
+
2753
+ # REST hook endpoint of FHIR Subscription.
2754
+ class SubscriptionRestHookEndpoint
2755
+ include Google::Apis::Core::Hashable
2756
+
2757
+ # Whether this endpoint is allowed to receive full resource payloads. If set
2758
+ # to false, the subscription notificiation sending to this endpoint with full
2759
+ # resource payload will be blocked.
2760
+ # Corresponds to the JSON property `allowResourcePayload`
2761
+ # @return [Boolean]
2762
+ attr_accessor :allow_resource_payload
2763
+ alias_method :allow_resource_payload?, :allow_resource_payload
2764
+
2765
+ # Address of the REST hook endpoint. It must be a valid HTTPS URL with TLS
2766
+ # certificate.
2767
+ # Corresponds to the JSON property `endpoint`
2768
+ # @return [String]
2769
+ attr_accessor :endpoint
2770
+
2771
+ def initialize(**args)
2772
+ update!(**args)
2773
+ end
2774
+
2775
+ # Update properties of this object
2776
+ def update!(**args)
2777
+ @allow_resource_payload = args[:allow_resource_payload] if args.key?(:allow_resource_payload)
2778
+ @endpoint = args[:endpoint] if args.key?(:endpoint)
2779
+ end
2780
+ end
2781
+
2710
2782
  # List of tags to be filtered.
2711
2783
  class TagFilterList
2712
2784
  include Google::Apis::Core::Hashable
@@ -2798,6 +2870,41 @@ module Google
2798
2870
  end
2799
2871
  end
2800
2872
 
2873
+ # This structure contains the configuration for FHIR profiles and validation.
2874
+ class ValidationConfig
2875
+ include Google::Apis::Core::Hashable
2876
+
2877
+ # Whether profile validation should be disabled for this FHIR store. Set
2878
+ # this to true to disable checking incoming resources for conformance
2879
+ # against StructureDefinitions in this FHIR store.
2880
+ # Corresponds to the JSON property `disableProfileValidation`
2881
+ # @return [Boolean]
2882
+ attr_accessor :disable_profile_validation
2883
+ alias_method :disable_profile_validation?, :disable_profile_validation
2884
+
2885
+ # A list of ImplementationGuide IDs in this FHIR store that will be used to
2886
+ # configure which profiles are used for validation. For example, to enable
2887
+ # an implementation guide with ID 1 set `enabled_implementation_guides` to
2888
+ # `["1"]`. If `enabled_implementation_guides` is empty or omitted then
2889
+ # incoming resources will only be required to conform to the base FHIR
2890
+ # profiles. Otherwise, a resource must conform to at least one profile
2891
+ # listed in the `global` property of one of the enabled
2892
+ # ImplementationGuides.
2893
+ # Corresponds to the JSON property `enabledImplementationGuides`
2894
+ # @return [Array<String>]
2895
+ attr_accessor :enabled_implementation_guides
2896
+
2897
+ def initialize(**args)
2898
+ update!(**args)
2899
+ end
2900
+
2901
+ # Update properties of this object
2902
+ def update!(**args)
2903
+ @disable_profile_validation = args[:disable_profile_validation] if args.key?(:disable_profile_validation)
2904
+ @enabled_implementation_guides = args[:enabled_implementation_guides] if args.key?(:enabled_implementation_guides)
2905
+ end
2906
+ end
2907
+
2801
2908
  # A 2D coordinate in an image. The origin is the top-left.
2802
2909
  class Vertex
2803
2910
  include Google::Apis::Core::Hashable
@@ -502,6 +502,18 @@ module Google
502
502
  include Google::Apis::Core::JsonObjectSupport
503
503
  end
504
504
 
505
+ class SubscriptionConfig
506
+ class Representation < Google::Apis::Core::JsonRepresentation; end
507
+
508
+ include Google::Apis::Core::JsonObjectSupport
509
+ end
510
+
511
+ class SubscriptionRestHookEndpoint
512
+ class Representation < Google::Apis::Core::JsonRepresentation; end
513
+
514
+ include Google::Apis::Core::JsonObjectSupport
515
+ end
516
+
505
517
  class TagFilterList
506
518
  class Representation < Google::Apis::Core::JsonRepresentation; end
507
519
 
@@ -526,6 +538,12 @@ module Google
526
538
  include Google::Apis::Core::JsonObjectSupport
527
539
  end
528
540
 
541
+ class ValidationConfig
542
+ class Representation < Google::Apis::Core::JsonRepresentation; end
543
+
544
+ include Google::Apis::Core::JsonObjectSupport
545
+ end
546
+
529
547
  class Vertex
530
548
  class Representation < Google::Apis::Core::JsonRepresentation; end
531
549
 
@@ -779,6 +797,10 @@ module Google
779
797
 
780
798
  collection :stream_configs, as: 'streamConfigs', class: Google::Apis::HealthcareV1alpha2::StreamConfig, decorator: Google::Apis::HealthcareV1alpha2::StreamConfig::Representation
781
799
 
800
+ property :subscription_config, as: 'subscriptionConfig', class: Google::Apis::HealthcareV1alpha2::SubscriptionConfig, decorator: Google::Apis::HealthcareV1alpha2::SubscriptionConfig::Representation
801
+
802
+ property :validation_config, as: 'validationConfig', class: Google::Apis::HealthcareV1alpha2::ValidationConfig, decorator: Google::Apis::HealthcareV1alpha2::ValidationConfig::Representation
803
+
782
804
  end
783
805
  end
784
806
 
@@ -1250,6 +1272,22 @@ module Google
1250
1272
  end
1251
1273
  end
1252
1274
 
1275
+ class SubscriptionConfig
1276
+ # @private
1277
+ class Representation < Google::Apis::Core::JsonRepresentation
1278
+ collection :allowed_rest_hook_endpoints, as: 'allowedRestHookEndpoints', class: Google::Apis::HealthcareV1alpha2::SubscriptionRestHookEndpoint, decorator: Google::Apis::HealthcareV1alpha2::SubscriptionRestHookEndpoint::Representation
1279
+
1280
+ end
1281
+ end
1282
+
1283
+ class SubscriptionRestHookEndpoint
1284
+ # @private
1285
+ class Representation < Google::Apis::Core::JsonRepresentation
1286
+ property :allow_resource_payload, as: 'allowResourcePayload'
1287
+ property :endpoint, as: 'endpoint'
1288
+ end
1289
+ end
1290
+
1253
1291
  class TagFilterList
1254
1292
  # @private
1255
1293
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1280,6 +1318,14 @@ module Google
1280
1318
  end
1281
1319
  end
1282
1320
 
1321
+ class ValidationConfig
1322
+ # @private
1323
+ class Representation < Google::Apis::Core::JsonRepresentation
1324
+ property :disable_profile_validation, as: 'disableProfileValidation'
1325
+ collection :enabled_implementation_guides, as: 'enabledImplementationGuides'
1326
+ end
1327
+ end
1328
+
1283
1329
  class Vertex
1284
1330
  # @private
1285
1331
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -27,7 +27,7 @@ module Google
27
27
  # @see https://cloud.google.com/iam/
28
28
  module IamV1
29
29
  VERSION = 'V1'
30
- REVISION = '20190607'
30
+ REVISION = '20190627'
31
31
 
32
32
  # View and manage your data across Google Cloud Platform services
33
33
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -304,7 +304,7 @@ module Google
304
304
  # @return [Google::Apis::IamV1::Role]
305
305
  attr_accessor :role
306
306
 
307
- # The role id to use for this role.
307
+ # The role ID to use for this role.
308
308
  # Corresponds to the JSON property `roleId`
309
309
  # @return [String]
310
310
  attr_accessor :role_id
@@ -131,9 +131,24 @@ module Google
131
131
 
132
132
  # Creates a new Role.
133
133
  # @param [String] parent
134
- # The resource name of the parent resource in one of the following formats:
135
- # `organizations/`ORGANIZATION_ID``
136
- # `projects/`PROJECT_ID``
134
+ # The `parent` parameter's value depends on the target resource for the
135
+ # request, namely
136
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
137
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
138
+ # resource type's `parent` value format is described below:
139
+ # * [`projects.roles.create()`](/iam/reference/rest/v1/projects.roles/create):
140
+ # `projects/`PROJECT_ID``. This method creates project-level
141
+ # [custom roles](/iam/docs/understanding-custom-roles).
142
+ # Example request URL:
143
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
144
+ # * [`organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
145
+ # create):
146
+ # `organizations/`ORGANIZATION_ID``. This method creates organization-level
147
+ # [custom roles](/iam/docs/understanding-custom-roles). Example request
148
+ # URL:
149
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
150
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
151
+ # ID or organization ID.
137
152
  # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
138
153
  # @param [String] fields
139
154
  # Selector specifying which fields to include in a partial response.
@@ -172,9 +187,25 @@ module Google
172
187
  # within 7 days. After 7 days the Role is deleted and all Bindings associated
173
188
  # with the role are removed.
174
189
  # @param [String] name
175
- # The resource name of the role in one of the following formats:
176
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
177
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
190
+ # The `name` parameter's value depends on the target resource for the
191
+ # request, namely
192
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
193
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
194
+ # resource type's `name` value format is described below:
195
+ # * [`projects.roles.delete()`](/iam/reference/rest/v1/projects.roles/delete):
196
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only
197
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
198
+ # created at the project level. Example request URL:
199
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
200
+ # * [`organizations.roles.delete()`](/iam/reference/rest/v1/organizations.roles/
201
+ # delete):
202
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
203
+ # deletes only [custom roles](/iam/docs/understanding-custom-roles) that
204
+ # have been created at the organization level. Example request URL:
205
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
206
+ # CUSTOM_ROLE_ID``
207
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
208
+ # ID or organization ID.
178
209
  # @param [String] etag
179
210
  # Used to perform a consistent read-modify-write.
180
211
  # @param [String] fields
@@ -207,10 +238,31 @@ module Google
207
238
 
208
239
  # Gets a Role definition.
209
240
  # @param [String] name
210
- # The resource name of the role in one of the following formats:
211
- # `roles/`ROLE_NAME``
212
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
213
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
241
+ # The `name` parameter's value depends on the target resource for the
242
+ # request, namely
243
+ # [`roles`](/iam/reference/rest/v1/roles),
244
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
245
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
246
+ # resource type's `name` value format is described below:
247
+ # * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
248
+ # This method returns results from all
249
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
250
+ # Cloud IAM. Example request URL:
251
+ # `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
252
+ # * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
253
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
254
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
255
+ # created at the project level. Example request URL:
256
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
257
+ # * [`organizations.roles.get()`](/iam/reference/rest/v1/organizations.roles/get)
258
+ # :
259
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
260
+ # returns only [custom roles](/iam/docs/understanding-custom-roles) that
261
+ # have been created at the organization level. Example request URL:
262
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
263
+ # CUSTOM_ROLE_ID``
264
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
265
+ # ID or organization ID.
214
266
  # @param [String] fields
215
267
  # Selector specifying which fields to include in a partial response.
216
268
  # @param [String] quota_user
@@ -240,10 +292,30 @@ module Google
240
292
 
241
293
  # Lists the Roles defined on a resource.
242
294
  # @param [String] parent
243
- # The resource name of the parent resource in one of the following formats:
244
- # `` (empty string) -- this refers to curated roles.
245
- # `organizations/`ORGANIZATION_ID``
246
- # `projects/`PROJECT_ID``
295
+ # The `parent` parameter's value depends on the target resource for the
296
+ # request, namely
297
+ # [`roles`](/iam/reference/rest/v1/roles),
298
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
299
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
300
+ # resource type's `parent` value format is described below:
301
+ # * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
302
+ # This method doesn't require a resource; it simply returns all
303
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
304
+ # Cloud IAM. Example request URL:
305
+ # `https://iam.googleapis.com/v1/roles`
306
+ # * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
307
+ # `projects/`PROJECT_ID``. This method lists all project-level
308
+ # [custom roles](/iam/docs/understanding-custom-roles).
309
+ # Example request URL:
310
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
311
+ # * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
312
+ # list):
313
+ # `organizations/`ORGANIZATION_ID``. This method lists all
314
+ # organization-level [custom roles](/iam/docs/understanding-custom-roles).
315
+ # Example request URL:
316
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
317
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
318
+ # ID or organization ID.
247
319
  # @param [Fixnum] page_size
248
320
  # Optional limit on the number of roles to include in the response.
249
321
  # @param [String] page_token
@@ -288,10 +360,25 @@ module Google
288
360
 
289
361
  # Updates a Role definition.
290
362
  # @param [String] name
291
- # The resource name of the role in one of the following formats:
292
- # `roles/`ROLE_NAME``
293
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
294
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
363
+ # The `name` parameter's value depends on the target resource for the
364
+ # request, namely
365
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
366
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
367
+ # resource type's `name` value format is described below:
368
+ # * [`projects.roles.patch()`](/iam/reference/rest/v1/projects.roles/patch):
369
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only
370
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
371
+ # created at the project level. Example request URL:
372
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
373
+ # * [`organizations.roles.patch()`](/iam/reference/rest/v1/organizations.roles/
374
+ # patch):
375
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
376
+ # updates only [custom roles](/iam/docs/understanding-custom-roles) that
377
+ # have been created at the organization level. Example request URL:
378
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
379
+ # CUSTOM_ROLE_ID``
380
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
381
+ # ID or organization ID.
295
382
  # @param [Google::Apis::IamV1::Role] role_object
296
383
  # @param [String] update_mask
297
384
  # A mask describing which fields in the Role have changed.
@@ -327,9 +414,26 @@ module Google
327
414
 
328
415
  # Undelete a Role, bringing it back in its previous state.
329
416
  # @param [String] name
330
- # The resource name of the role in one of the following formats:
331
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
332
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
417
+ # The `name` parameter's value depends on the target resource for the
418
+ # request, namely
419
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
420
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
421
+ # resource type's `name` value format is described below:
422
+ # * [`projects.roles.undelete()`](/iam/reference/rest/v1/projects.roles/undelete)
423
+ # :
424
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes
425
+ # only [custom roles](/iam/docs/understanding-custom-roles) that have been
426
+ # created at the project level. Example request URL:
427
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
428
+ # * [`organizations.roles.undelete()`](/iam/reference/rest/v1/organizations.
429
+ # roles/undelete):
430
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
431
+ # undeletes only [custom roles](/iam/docs/understanding-custom-roles) that
432
+ # have been created at the organization level. Example request URL:
433
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
434
+ # CUSTOM_ROLE_ID``
435
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
436
+ # ID or organization ID.
333
437
  # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
334
438
  # @param [String] fields
335
439
  # Selector specifying which fields to include in a partial response.
@@ -393,9 +497,24 @@ module Google
393
497
 
394
498
  # Creates a new Role.
395
499
  # @param [String] parent
396
- # The resource name of the parent resource in one of the following formats:
397
- # `organizations/`ORGANIZATION_ID``
398
- # `projects/`PROJECT_ID``
500
+ # The `parent` parameter's value depends on the target resource for the
501
+ # request, namely
502
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
503
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
504
+ # resource type's `parent` value format is described below:
505
+ # * [`projects.roles.create()`](/iam/reference/rest/v1/projects.roles/create):
506
+ # `projects/`PROJECT_ID``. This method creates project-level
507
+ # [custom roles](/iam/docs/understanding-custom-roles).
508
+ # Example request URL:
509
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
510
+ # * [`organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
511
+ # create):
512
+ # `organizations/`ORGANIZATION_ID``. This method creates organization-level
513
+ # [custom roles](/iam/docs/understanding-custom-roles). Example request
514
+ # URL:
515
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
516
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
517
+ # ID or organization ID.
399
518
  # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
400
519
  # @param [String] fields
401
520
  # Selector specifying which fields to include in a partial response.
@@ -434,9 +553,25 @@ module Google
434
553
  # within 7 days. After 7 days the Role is deleted and all Bindings associated
435
554
  # with the role are removed.
436
555
  # @param [String] name
437
- # The resource name of the role in one of the following formats:
438
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
439
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
556
+ # The `name` parameter's value depends on the target resource for the
557
+ # request, namely
558
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
559
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
560
+ # resource type's `name` value format is described below:
561
+ # * [`projects.roles.delete()`](/iam/reference/rest/v1/projects.roles/delete):
562
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only
563
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
564
+ # created at the project level. Example request URL:
565
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
566
+ # * [`organizations.roles.delete()`](/iam/reference/rest/v1/organizations.roles/
567
+ # delete):
568
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
569
+ # deletes only [custom roles](/iam/docs/understanding-custom-roles) that
570
+ # have been created at the organization level. Example request URL:
571
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
572
+ # CUSTOM_ROLE_ID``
573
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
574
+ # ID or organization ID.
440
575
  # @param [String] etag
441
576
  # Used to perform a consistent read-modify-write.
442
577
  # @param [String] fields
@@ -469,10 +604,31 @@ module Google
469
604
 
470
605
  # Gets a Role definition.
471
606
  # @param [String] name
472
- # The resource name of the role in one of the following formats:
473
- # `roles/`ROLE_NAME``
474
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
475
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
607
+ # The `name` parameter's value depends on the target resource for the
608
+ # request, namely
609
+ # [`roles`](/iam/reference/rest/v1/roles),
610
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
611
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
612
+ # resource type's `name` value format is described below:
613
+ # * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
614
+ # This method returns results from all
615
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
616
+ # Cloud IAM. Example request URL:
617
+ # `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
618
+ # * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
619
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
620
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
621
+ # created at the project level. Example request URL:
622
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
623
+ # * [`organizations.roles.get()`](/iam/reference/rest/v1/organizations.roles/get)
624
+ # :
625
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
626
+ # returns only [custom roles](/iam/docs/understanding-custom-roles) that
627
+ # have been created at the organization level. Example request URL:
628
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
629
+ # CUSTOM_ROLE_ID``
630
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
631
+ # ID or organization ID.
476
632
  # @param [String] fields
477
633
  # Selector specifying which fields to include in a partial response.
478
634
  # @param [String] quota_user
@@ -502,10 +658,30 @@ module Google
502
658
 
503
659
  # Lists the Roles defined on a resource.
504
660
  # @param [String] parent
505
- # The resource name of the parent resource in one of the following formats:
506
- # `` (empty string) -- this refers to curated roles.
507
- # `organizations/`ORGANIZATION_ID``
508
- # `projects/`PROJECT_ID``
661
+ # The `parent` parameter's value depends on the target resource for the
662
+ # request, namely
663
+ # [`roles`](/iam/reference/rest/v1/roles),
664
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
665
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
666
+ # resource type's `parent` value format is described below:
667
+ # * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
668
+ # This method doesn't require a resource; it simply returns all
669
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
670
+ # Cloud IAM. Example request URL:
671
+ # `https://iam.googleapis.com/v1/roles`
672
+ # * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
673
+ # `projects/`PROJECT_ID``. This method lists all project-level
674
+ # [custom roles](/iam/docs/understanding-custom-roles).
675
+ # Example request URL:
676
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
677
+ # * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
678
+ # list):
679
+ # `organizations/`ORGANIZATION_ID``. This method lists all
680
+ # organization-level [custom roles](/iam/docs/understanding-custom-roles).
681
+ # Example request URL:
682
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
683
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
684
+ # ID or organization ID.
509
685
  # @param [Fixnum] page_size
510
686
  # Optional limit on the number of roles to include in the response.
511
687
  # @param [String] page_token
@@ -550,10 +726,25 @@ module Google
550
726
 
551
727
  # Updates a Role definition.
552
728
  # @param [String] name
553
- # The resource name of the role in one of the following formats:
554
- # `roles/`ROLE_NAME``
555
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
556
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
729
+ # The `name` parameter's value depends on the target resource for the
730
+ # request, namely
731
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
732
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
733
+ # resource type's `name` value format is described below:
734
+ # * [`projects.roles.patch()`](/iam/reference/rest/v1/projects.roles/patch):
735
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only
736
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
737
+ # created at the project level. Example request URL:
738
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
739
+ # * [`organizations.roles.patch()`](/iam/reference/rest/v1/organizations.roles/
740
+ # patch):
741
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
742
+ # updates only [custom roles](/iam/docs/understanding-custom-roles) that
743
+ # have been created at the organization level. Example request URL:
744
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
745
+ # CUSTOM_ROLE_ID``
746
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
747
+ # ID or organization ID.
557
748
  # @param [Google::Apis::IamV1::Role] role_object
558
749
  # @param [String] update_mask
559
750
  # A mask describing which fields in the Role have changed.
@@ -589,9 +780,26 @@ module Google
589
780
 
590
781
  # Undelete a Role, bringing it back in its previous state.
591
782
  # @param [String] name
592
- # The resource name of the role in one of the following formats:
593
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
594
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
783
+ # The `name` parameter's value depends on the target resource for the
784
+ # request, namely
785
+ # [`projects`](/iam/reference/rest/v1/projects.roles) or
786
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
787
+ # resource type's `name` value format is described below:
788
+ # * [`projects.roles.undelete()`](/iam/reference/rest/v1/projects.roles/undelete)
789
+ # :
790
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes
791
+ # only [custom roles](/iam/docs/understanding-custom-roles) that have been
792
+ # created at the project level. Example request URL:
793
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
794
+ # * [`organizations.roles.undelete()`](/iam/reference/rest/v1/organizations.
795
+ # roles/undelete):
796
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
797
+ # undeletes only [custom roles](/iam/docs/understanding-custom-roles) that
798
+ # have been created at the organization level. Example request URL:
799
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
800
+ # CUSTOM_ROLE_ID``
801
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
802
+ # ID or organization ID.
595
803
  # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
596
804
  # @param [String] fields
597
805
  # Selector specifying which fields to include in a partial response.
@@ -835,6 +1043,11 @@ module Google
835
1043
  # @param [String] resource
836
1044
  # REQUIRED: The resource for which the policy is being requested.
837
1045
  # See the operation documentation for the appropriate value for this field.
1046
+ # @param [Fixnum] options_requested_policy_version
1047
+ # Optional. The policy format version to be returned.
1048
+ # Acceptable values are 0 and 1.
1049
+ # If the value is 0, or the field is omitted, policy format version 1 will be
1050
+ # returned.
838
1051
  # @param [String] fields
839
1052
  # Selector specifying which fields to include in a partial response.
840
1053
  # @param [String] quota_user
@@ -852,11 +1065,12 @@ module Google
852
1065
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
853
1066
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
854
1067
  # @raise [Google::Apis::AuthorizationError] Authorization is required
855
- def get_project_service_account_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
1068
+ def get_project_service_account_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
856
1069
  command = make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
857
1070
  command.response_representation = Google::Apis::IamV1::Policy::Representation
858
1071
  command.response_class = Google::Apis::IamV1::Policy
859
1072
  command.params['resource'] = resource unless resource.nil?
1073
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
860
1074
  command.query['fields'] = fields unless fields.nil?
861
1075
  command.query['quotaUser'] = quota_user unless quota_user.nil?
862
1076
  execute_or_queue_command(command, &block)
@@ -1348,10 +1562,31 @@ module Google
1348
1562
 
1349
1563
  # Gets a Role definition.
1350
1564
  # @param [String] name
1351
- # The resource name of the role in one of the following formats:
1352
- # `roles/`ROLE_NAME``
1353
- # `organizations/`ORGANIZATION_ID`/roles/`ROLE_NAME``
1354
- # `projects/`PROJECT_ID`/roles/`ROLE_NAME``
1565
+ # The `name` parameter's value depends on the target resource for the
1566
+ # request, namely
1567
+ # [`roles`](/iam/reference/rest/v1/roles),
1568
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
1569
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
1570
+ # resource type's `name` value format is described below:
1571
+ # * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
1572
+ # This method returns results from all
1573
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
1574
+ # Cloud IAM. Example request URL:
1575
+ # `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
1576
+ # * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
1577
+ # `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
1578
+ # [custom roles](/iam/docs/understanding-custom-roles) that have been
1579
+ # created at the project level. Example request URL:
1580
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``
1581
+ # * [`organizations.roles.get()`](/iam/reference/rest/v1/organizations.roles/get)
1582
+ # :
1583
+ # `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
1584
+ # returns only [custom roles](/iam/docs/understanding-custom-roles) that
1585
+ # have been created at the organization level. Example request URL:
1586
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
1587
+ # CUSTOM_ROLE_ID``
1588
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
1589
+ # ID or organization ID.
1355
1590
  # @param [String] fields
1356
1591
  # Selector specifying which fields to include in a partial response.
1357
1592
  # @param [String] quota_user
@@ -1385,10 +1620,30 @@ module Google
1385
1620
  # @param [String] page_token
1386
1621
  # Optional pagination token returned in an earlier ListRolesResponse.
1387
1622
  # @param [String] parent
1388
- # The resource name of the parent resource in one of the following formats:
1389
- # `` (empty string) -- this refers to curated roles.
1390
- # `organizations/`ORGANIZATION_ID``
1391
- # `projects/`PROJECT_ID``
1623
+ # The `parent` parameter's value depends on the target resource for the
1624
+ # request, namely
1625
+ # [`roles`](/iam/reference/rest/v1/roles),
1626
+ # [`projects`](/iam/reference/rest/v1/projects.roles), or
1627
+ # [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
1628
+ # resource type's `parent` value format is described below:
1629
+ # * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
1630
+ # This method doesn't require a resource; it simply returns all
1631
+ # [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
1632
+ # Cloud IAM. Example request URL:
1633
+ # `https://iam.googleapis.com/v1/roles`
1634
+ # * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
1635
+ # `projects/`PROJECT_ID``. This method lists all project-level
1636
+ # [custom roles](/iam/docs/understanding-custom-roles).
1637
+ # Example request URL:
1638
+ # `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
1639
+ # * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
1640
+ # list):
1641
+ # `organizations/`ORGANIZATION_ID``. This method lists all
1642
+ # organization-level [custom roles](/iam/docs/understanding-custom-roles).
1643
+ # Example request URL:
1644
+ # `https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles`
1645
+ # Note: Wildcard (*) values are invalid; you must specify a complete project
1646
+ # ID or organization ID.
1392
1647
  # @param [Boolean] show_deleted
1393
1648
  # Include Roles that have been deleted.
1394
1649
  # @param [String] view