google-api-client 0.34.1 → 0.35.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (312) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +16 -3
  3. data/CHANGELOG.md +114 -0
  4. data/OVERVIEW.md +36 -0
  5. data/README.md +49 -1
  6. data/Rakefile +1 -1
  7. data/docs/api-keys.md +20 -0
  8. data/docs/auth.md +53 -0
  9. data/docs/client-secrets.md +69 -0
  10. data/docs/getting-started.md +340 -0
  11. data/docs/installation.md +0 -0
  12. data/docs/logging.md +34 -0
  13. data/docs/media-upload.md +25 -0
  14. data/docs/oauth-installed.md +191 -0
  15. data/docs/oauth-server.md +135 -0
  16. data/docs/oauth-web.md +280 -0
  17. data/docs/oauth.md +268 -0
  18. data/docs/pagination.md +29 -0
  19. data/docs/performance.md +25 -0
  20. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  21. data/generated/google/apis/adexchangebuyer_v1_3.rb +1 -1
  22. data/generated/google/apis/adexchangebuyer_v1_3/classes.rb +9 -0
  23. data/generated/google/apis/adexchangebuyer_v1_3/representations.rb +1 -0
  24. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  25. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +9 -0
  26. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +1 -0
  27. data/generated/google/apis/androidmanagement_v1.rb +1 -1
  28. data/generated/google/apis/androidpublisher_v3.rb +1 -1
  29. data/generated/google/apis/androidpublisher_v3/classes.rb +93 -0
  30. data/generated/google/apis/androidpublisher_v3/representations.rb +49 -0
  31. data/generated/google/apis/appengine_v1.rb +1 -1
  32. data/generated/google/apis/appengine_v1beta.rb +1 -1
  33. data/generated/google/apis/appsmarket_v2.rb +1 -1
  34. data/generated/google/apis/bigquery_v2.rb +1 -1
  35. data/generated/google/apis/bigquery_v2/classes.rb +46 -4
  36. data/generated/google/apis/bigquery_v2/representations.rb +17 -0
  37. data/generated/google/apis/bigquery_v2/service.rb +1 -5
  38. data/generated/google/apis/bigqueryconnection_v1beta1.rb +1 -1
  39. data/generated/google/apis/bigqueryconnection_v1beta1/classes.rb +6 -5
  40. data/generated/google/apis/bigquerydatatransfer_v1.rb +1 -1
  41. data/generated/google/apis/bigquerydatatransfer_v1/service.rb +30 -4
  42. data/generated/google/apis/bigqueryreservation_v1.rb +1 -1
  43. data/generated/google/apis/bigqueryreservation_v1/classes.rb +0 -21
  44. data/generated/google/apis/bigqueryreservation_v1/representations.rb +0 -13
  45. data/generated/google/apis/bigqueryreservation_v1alpha2.rb +1 -1
  46. data/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb +116 -1
  47. data/generated/google/apis/bigqueryreservation_v1alpha2/representations.rb +35 -0
  48. data/generated/google/apis/bigqueryreservation_v1alpha2/service.rb +71 -0
  49. data/generated/google/apis/bigqueryreservation_v1beta1.rb +1 -1
  50. data/generated/google/apis/bigqueryreservation_v1beta1/classes.rb +61 -77
  51. data/generated/google/apis/bigqueryreservation_v1beta1/representations.rb +16 -17
  52. data/generated/google/apis/bigqueryreservation_v1beta1/service.rb +112 -78
  53. data/generated/google/apis/bigtableadmin_v1.rb +1 -1
  54. data/generated/google/apis/bigtableadmin_v1/classes.rb +1 -1
  55. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  56. data/generated/google/apis/bigtableadmin_v2/classes.rb +1 -1
  57. data/generated/google/apis/bigtableadmin_v2/service.rb +1 -1
  58. data/generated/google/apis/{sqladmin_v1beta4.rb → billingbudgets_v1beta1.rb} +10 -13
  59. data/generated/google/apis/billingbudgets_v1beta1/classes.rb +392 -0
  60. data/generated/google/apis/billingbudgets_v1beta1/representations.rb +191 -0
  61. data/generated/google/apis/billingbudgets_v1beta1/service.rb +233 -0
  62. data/generated/google/apis/binaryauthorization_v1.rb +1 -1
  63. data/generated/google/apis/binaryauthorization_v1/classes.rb +6 -5
  64. data/generated/google/apis/binaryauthorization_v1beta1.rb +1 -1
  65. data/generated/google/apis/binaryauthorization_v1beta1/classes.rb +6 -5
  66. data/generated/google/apis/books_v1.rb +1 -1
  67. data/generated/google/apis/books_v1/classes.rb +20 -0
  68. data/generated/google/apis/books_v1/representations.rb +3 -0
  69. data/generated/google/apis/calendar_v3.rb +1 -1
  70. data/generated/google/apis/calendar_v3/classes.rb +1 -1
  71. data/generated/google/apis/calendar_v3/service.rb +18 -30
  72. data/generated/google/apis/civicinfo_v2.rb +1 -1
  73. data/generated/google/apis/civicinfo_v2/classes.rb +0 -156
  74. data/generated/google/apis/civicinfo_v2/representations.rb +0 -58
  75. data/generated/google/apis/cloudasset_v1.rb +1 -1
  76. data/generated/google/apis/cloudasset_v1/classes.rb +6 -5
  77. data/generated/google/apis/cloudasset_v1beta1.rb +1 -1
  78. data/generated/google/apis/cloudasset_v1beta1/classes.rb +6 -5
  79. data/generated/google/apis/cloudbilling_v1.rb +1 -1
  80. data/generated/google/apis/cloudbilling_v1/classes.rb +17 -0
  81. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  82. data/generated/google/apis/cloudbuild_v1/classes.rb +8 -2
  83. data/generated/google/apis/cloudbuild_v1/representations.rb +1 -0
  84. data/generated/google/apis/cloudbuild_v1/service.rb +18 -18
  85. data/generated/google/apis/cloudbuild_v1alpha1.rb +1 -1
  86. data/generated/google/apis/cloudbuild_v1alpha1/classes.rb +8 -2
  87. data/generated/google/apis/cloudbuild_v1alpha1/representations.rb +1 -0
  88. data/generated/google/apis/cloudbuild_v1alpha1/service.rb +4 -1
  89. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  90. data/generated/google/apis/cloudfunctions_v1/classes.rb +13 -5
  91. data/generated/google/apis/cloudfunctions_v1/representations.rb +1 -0
  92. data/generated/google/apis/cloudfunctions_v1/service.rb +3 -1
  93. data/generated/google/apis/cloudiot_v1.rb +1 -1
  94. data/generated/google/apis/cloudiot_v1/classes.rb +6 -5
  95. data/generated/google/apis/cloudkms_v1.rb +1 -1
  96. data/generated/google/apis/cloudkms_v1/classes.rb +6 -5
  97. data/generated/google/apis/cloudprivatecatalogproducer_v1beta1.rb +1 -1
  98. data/generated/google/apis/cloudprivatecatalogproducer_v1beta1/classes.rb +6 -5
  99. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  100. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +6 -5
  101. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  102. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +6 -5
  103. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  104. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +6 -5
  105. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  106. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +6 -5
  107. data/generated/google/apis/cloudscheduler_v1.rb +1 -1
  108. data/generated/google/apis/cloudscheduler_v1/classes.rb +2 -1
  109. data/generated/google/apis/cloudscheduler_v1beta1.rb +1 -1
  110. data/generated/google/apis/cloudscheduler_v1beta1/classes.rb +2 -1
  111. data/generated/google/apis/cloudsearch_v1.rb +8 -8
  112. data/generated/google/apis/cloudsearch_v1/classes.rb +5 -130
  113. data/generated/google/apis/cloudsearch_v1/representations.rb +0 -75
  114. data/generated/google/apis/cloudsearch_v1/service.rb +42 -7
  115. data/generated/google/apis/cloudtasks_v2.rb +1 -1
  116. data/generated/google/apis/cloudtasks_v2/classes.rb +212 -5
  117. data/generated/google/apis/cloudtasks_v2/representations.rb +50 -0
  118. data/generated/google/apis/cloudtasks_v2beta2.rb +1 -1
  119. data/generated/google/apis/cloudtasks_v2beta2/classes.rb +6 -5
  120. data/generated/google/apis/cloudtasks_v2beta3.rb +1 -1
  121. data/generated/google/apis/cloudtasks_v2beta3/classes.rb +6 -5
  122. data/generated/google/apis/commentanalyzer_v1alpha1.rb +1 -1
  123. data/generated/google/apis/commentanalyzer_v1alpha1/classes.rb +14 -19
  124. data/generated/google/apis/compute_alpha.rb +1 -1
  125. data/generated/google/apis/compute_alpha/classes.rb +75 -12
  126. data/generated/google/apis/compute_alpha/representations.rb +2 -0
  127. data/generated/google/apis/compute_beta.rb +1 -1
  128. data/generated/google/apis/compute_beta/classes.rb +54 -10
  129. data/generated/google/apis/compute_v1.rb +1 -1
  130. data/generated/google/apis/compute_v1/classes.rb +54 -10
  131. data/generated/google/apis/containeranalysis_v1alpha1.rb +1 -1
  132. data/generated/google/apis/containeranalysis_v1alpha1/classes.rb +6 -5
  133. data/generated/google/apis/containeranalysis_v1beta1.rb +1 -1
  134. data/generated/google/apis/containeranalysis_v1beta1/classes.rb +6 -5
  135. data/generated/google/apis/content_v2.rb +1 -1
  136. data/generated/google/apis/content_v2/classes.rb +13 -4
  137. data/generated/google/apis/content_v2_1.rb +1 -1
  138. data/generated/google/apis/content_v2_1/classes.rb +13 -4
  139. data/generated/google/apis/datacatalog_v1beta1.rb +35 -0
  140. data/generated/google/apis/datacatalog_v1beta1/classes.rb +1646 -0
  141. data/generated/google/apis/datacatalog_v1beta1/representations.rb +700 -0
  142. data/generated/google/apis/datacatalog_v1beta1/service.rb +1982 -0
  143. data/generated/google/apis/dataproc_v1.rb +1 -1
  144. data/generated/google/apis/dataproc_v1/classes.rb +75 -4
  145. data/generated/google/apis/dataproc_v1/representations.rb +22 -0
  146. data/generated/google/apis/dataproc_v1/service.rb +14 -7
  147. data/generated/google/apis/dataproc_v1beta2.rb +1 -1
  148. data/generated/google/apis/dataproc_v1beta2/classes.rb +2 -4
  149. data/generated/google/apis/dataproc_v1beta2/service.rb +14 -7
  150. data/generated/google/apis/dfareporting_v3_3.rb +1 -1
  151. data/generated/google/apis/dfareporting_v3_3/classes.rb +21 -1
  152. data/generated/google/apis/dfareporting_v3_3/service.rb +6 -6
  153. data/generated/google/apis/dfareporting_v3_4.rb +40 -0
  154. data/generated/google/apis/dfareporting_v3_4/classes.rb +12717 -0
  155. data/generated/google/apis/dfareporting_v3_4/representations.rb +4595 -0
  156. data/generated/google/apis/dfareporting_v3_4/service.rb +8685 -0
  157. data/generated/google/apis/dialogflow_v2.rb +1 -1
  158. data/generated/google/apis/dialogflow_v2/classes.rb +484 -1
  159. data/generated/google/apis/dialogflow_v2/representations.rb +220 -0
  160. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  161. data/generated/google/apis/dialogflow_v2beta1/classes.rb +497 -1
  162. data/generated/google/apis/dialogflow_v2beta1/representations.rb +221 -0
  163. data/generated/google/apis/dlp_v2.rb +1 -1
  164. data/generated/google/apis/dlp_v2/classes.rb +68 -25
  165. data/generated/google/apis/dlp_v2/representations.rb +9 -4
  166. data/generated/google/apis/dlp_v2/service.rb +1925 -193
  167. data/generated/google/apis/dns_v1beta2.rb +1 -1
  168. data/generated/google/apis/dns_v1beta2/classes.rb +47 -0
  169. data/generated/google/apis/dns_v1beta2/representations.rb +17 -0
  170. data/generated/google/apis/docs_v1.rb +1 -1
  171. data/generated/google/apis/docs_v1/classes.rb +4 -8
  172. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  173. data/generated/google/apis/doubleclickbidmanager_v1_1.rb +34 -0
  174. data/generated/google/apis/doubleclickbidmanager_v1_1/classes.rb +826 -0
  175. data/generated/google/apis/doubleclickbidmanager_v1_1/representations.rb +372 -0
  176. data/generated/google/apis/doubleclickbidmanager_v1_1/service.rb +371 -0
  177. data/generated/google/apis/drive_v3.rb +1 -1
  178. data/generated/google/apis/drive_v3/classes.rb +12 -3
  179. data/generated/google/apis/fcm_v1.rb +1 -1
  180. data/generated/google/apis/fcm_v1/classes.rb +15 -0
  181. data/generated/google/apis/fcm_v1/representations.rb +2 -0
  182. data/generated/google/apis/firebase_v1beta1.rb +1 -1
  183. data/generated/google/apis/firebase_v1beta1/classes.rb +3 -4
  184. data/generated/google/apis/firebase_v1beta1/service.rb +6 -6
  185. data/generated/google/apis/firebasehosting_v1beta1.rb +1 -1
  186. data/generated/google/apis/firebasehosting_v1beta1/classes.rb +25 -0
  187. data/generated/google/apis/firebasehosting_v1beta1/representations.rb +15 -0
  188. data/generated/google/apis/firebasehosting_v1beta1/service.rb +47 -0
  189. data/generated/google/apis/firebaserules_v1.rb +1 -1
  190. data/generated/google/apis/firebaserules_v1/classes.rb +26 -0
  191. data/generated/google/apis/firebaserules_v1/representations.rb +15 -0
  192. data/generated/google/apis/genomics_v2alpha1.rb +1 -1
  193. data/generated/google/apis/genomics_v2alpha1/classes.rb +32 -0
  194. data/generated/google/apis/genomics_v2alpha1/representations.rb +16 -0
  195. data/generated/google/apis/healthcare_v1beta1.rb +1 -1
  196. data/generated/google/apis/healthcare_v1beta1/classes.rb +8 -7
  197. data/generated/google/apis/homegraph_v1.rb +1 -1
  198. data/generated/google/apis/homegraph_v1/classes.rb +15 -1
  199. data/generated/google/apis/homegraph_v1/representations.rb +2 -1
  200. data/generated/google/apis/iam_v1.rb +1 -1
  201. data/generated/google/apis/iam_v1/classes.rb +6 -5
  202. data/generated/google/apis/logging_v2.rb +1 -1
  203. data/generated/google/apis/logging_v2/classes.rb +18 -2
  204. data/generated/google/apis/logging_v2/representations.rb +2 -0
  205. data/generated/google/apis/ml_v1.rb +1 -1
  206. data/generated/google/apis/ml_v1/classes.rb +173 -97
  207. data/generated/google/apis/ml_v1/representations.rb +58 -0
  208. data/generated/google/apis/ml_v1/service.rb +37 -0
  209. data/generated/google/apis/monitoring_v3.rb +1 -1
  210. data/generated/google/apis/monitoring_v3/classes.rb +780 -6
  211. data/generated/google/apis/monitoring_v3/representations.rb +347 -0
  212. data/generated/google/apis/monitoring_v3/service.rb +382 -0
  213. data/generated/google/apis/pagespeedonline_v5.rb +1 -1
  214. data/generated/google/apis/pagespeedonline_v5/classes.rb +8 -0
  215. data/generated/google/apis/pagespeedonline_v5/representations.rb +1 -0
  216. data/generated/google/apis/policytroubleshooter_v1beta.rb +1 -1
  217. data/generated/google/apis/policytroubleshooter_v1beta/classes.rb +6 -5
  218. data/generated/google/apis/pubsub_v1.rb +1 -1
  219. data/generated/google/apis/pubsub_v1/classes.rb +8 -6
  220. data/generated/google/apis/pubsub_v1/service.rb +6 -7
  221. data/generated/google/apis/pubsub_v1beta2.rb +1 -1
  222. data/generated/google/apis/pubsub_v1beta2/classes.rb +6 -5
  223. data/generated/google/apis/recommender_v1beta1.rb +1 -1
  224. data/generated/google/apis/recommender_v1beta1/classes.rb +1 -1
  225. data/generated/google/apis/recommender_v1beta1/service.rb +10 -8
  226. data/generated/google/apis/remotebuildexecution_v1.rb +1 -1
  227. data/generated/google/apis/remotebuildexecution_v1/classes.rb +33 -0
  228. data/generated/google/apis/remotebuildexecution_v1/representations.rb +15 -0
  229. data/generated/google/apis/remotebuildexecution_v1alpha.rb +1 -1
  230. data/generated/google/apis/remotebuildexecution_v1alpha/classes.rb +33 -0
  231. data/generated/google/apis/remotebuildexecution_v1alpha/representations.rb +15 -0
  232. data/generated/google/apis/remotebuildexecution_v2.rb +1 -1
  233. data/generated/google/apis/remotebuildexecution_v2/classes.rb +33 -0
  234. data/generated/google/apis/remotebuildexecution_v2/representations.rb +15 -0
  235. data/generated/google/apis/run_v1.rb +1 -1
  236. data/generated/google/apis/run_v1/classes.rb +8 -169
  237. data/generated/google/apis/run_v1/representations.rb +0 -71
  238. data/generated/google/apis/run_v1/service.rb +229 -1207
  239. data/generated/google/apis/run_v1alpha1.rb +1 -1
  240. data/generated/google/apis/run_v1alpha1/classes.rb +9 -9
  241. data/generated/google/apis/runtimeconfig_v1beta1.rb +1 -1
  242. data/generated/google/apis/runtimeconfig_v1beta1/classes.rb +6 -5
  243. data/generated/google/apis/securitycenter_v1.rb +1 -1
  244. data/generated/google/apis/securitycenter_v1/classes.rb +66 -11
  245. data/generated/google/apis/securitycenter_v1/representations.rb +19 -0
  246. data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
  247. data/generated/google/apis/securitycenter_v1beta1/classes.rb +16 -13
  248. data/generated/google/apis/servicebroker_v1.rb +1 -1
  249. data/generated/google/apis/servicebroker_v1/classes.rb +6 -5
  250. data/generated/google/apis/servicebroker_v1alpha1.rb +1 -1
  251. data/generated/google/apis/servicebroker_v1alpha1/classes.rb +6 -5
  252. data/generated/google/apis/servicebroker_v1beta1.rb +1 -1
  253. data/generated/google/apis/servicebroker_v1beta1/classes.rb +6 -5
  254. data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
  255. data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +3 -2
  256. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  257. data/generated/google/apis/servicecontrol_v1/classes.rb +8 -1
  258. data/generated/google/apis/servicecontrol_v1/representations.rb +1 -0
  259. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  260. data/generated/google/apis/servicemanagement_v1/classes.rb +12 -9
  261. data/generated/google/apis/servicemanagement_v1/service.rb +1 -9
  262. data/generated/google/apis/servicenetworking_v1.rb +1 -1
  263. data/generated/google/apis/servicenetworking_v1/classes.rb +130 -13
  264. data/generated/google/apis/servicenetworking_v1/representations.rb +58 -0
  265. data/generated/google/apis/servicenetworking_v1/service.rb +42 -3
  266. data/generated/google/apis/servicenetworking_v1beta.rb +1 -1
  267. data/generated/google/apis/servicenetworking_v1beta/classes.rb +3 -2
  268. data/generated/google/apis/serviceusage_v1.rb +1 -1
  269. data/generated/google/apis/serviceusage_v1/classes.rb +3 -2
  270. data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
  271. data/generated/google/apis/serviceusage_v1beta1/classes.rb +3 -2
  272. data/generated/google/apis/sheets_v4.rb +1 -1
  273. data/generated/google/apis/spanner_v1.rb +1 -1
  274. data/generated/google/apis/spanner_v1/classes.rb +70 -30
  275. data/generated/google/apis/spanner_v1/service.rb +270 -0
  276. data/generated/google/apis/speech_v1.rb +1 -1
  277. data/generated/google/apis/speech_v1/classes.rb +6 -0
  278. data/generated/google/apis/speech_v1/representations.rb +1 -0
  279. data/generated/google/apis/speech_v1p1beta1.rb +1 -1
  280. data/generated/google/apis/speech_v1p1beta1/classes.rb +6 -0
  281. data/generated/google/apis/speech_v1p1beta1/representations.rb +1 -0
  282. data/generated/google/apis/sql_v1beta4.rb +1 -1
  283. data/generated/google/apis/sql_v1beta4/service.rb +59 -10
  284. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  285. data/generated/google/apis/videointelligence_v1.rb +1 -1
  286. data/generated/google/apis/videointelligence_v1/classes.rb +112 -0
  287. data/generated/google/apis/videointelligence_v1/representations.rb +62 -0
  288. data/generated/google/apis/videointelligence_v1beta2.rb +1 -1
  289. data/generated/google/apis/videointelligence_v1beta2/classes.rb +112 -0
  290. data/generated/google/apis/videointelligence_v1beta2/representations.rb +62 -0
  291. data/generated/google/apis/videointelligence_v1p1beta1.rb +1 -1
  292. data/generated/google/apis/videointelligence_v1p1beta1/classes.rb +112 -0
  293. data/generated/google/apis/videointelligence_v1p1beta1/representations.rb +62 -0
  294. data/generated/google/apis/videointelligence_v1p2beta1.rb +1 -1
  295. data/generated/google/apis/videointelligence_v1p2beta1/classes.rb +112 -0
  296. data/generated/google/apis/videointelligence_v1p2beta1/representations.rb +62 -0
  297. data/generated/google/apis/videointelligence_v1p3beta1.rb +1 -1
  298. data/generated/google/apis/videointelligence_v1p3beta1/classes.rb +112 -0
  299. data/generated/google/apis/videointelligence_v1p3beta1/representations.rb +62 -0
  300. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  301. data/lib/google/apis/core/api_command.rb +3 -0
  302. data/lib/google/apis/core/http_command.rb +10 -8
  303. data/lib/google/apis/version.rb +1 -1
  304. data/rakelib/devsite/devsite_builder.rb +1 -1
  305. metadata +33 -11
  306. data/generated/google/apis/sqladmin_v1beta4/classes.rb +0 -2633
  307. data/generated/google/apis/sqladmin_v1beta4/representations.rb +0 -1110
  308. data/generated/google/apis/sqladmin_v1beta4/service.rb +0 -1793
  309. data/generated/google/apis/storage_v1beta1.rb +0 -40
  310. data/generated/google/apis/storage_v1beta1/classes.rb +0 -616
  311. data/generated/google/apis/storage_v1beta1/representations.rb +0 -249
  312. data/generated/google/apis/storage_v1beta1/service.rb +0 -1032
@@ -0,0 +1,1982 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module DatacatalogV1beta1
23
+ # Google Cloud Data Catalog API
24
+ #
25
+ # A fully managed and highly scalable data discovery and metadata management
26
+ # service.
27
+ #
28
+ # @example
29
+ # require 'google/apis/datacatalog_v1beta1'
30
+ #
31
+ # Datacatalog = Google::Apis::DatacatalogV1beta1 # Alias the module
32
+ # service = Datacatalog::DataCatalogService.new
33
+ #
34
+ # @see https://cloud.google.com/data-catalog/docs/
35
+ class DataCatalogService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ attr_accessor :quota_user
45
+
46
+ def initialize
47
+ super('https://datacatalog.googleapis.com/', '')
48
+ @batch_path = 'batch'
49
+ end
50
+
51
+ # Searches Data Catalog for multiple resources like entries, tags that
52
+ # match a query.
53
+ # This is a custom method
54
+ # (https://cloud.google.com/apis/design/custom_methods) and does not return
55
+ # the complete resource, only the resource identifier and high level
56
+ # fields. Clients can subsequentally call `Get` methods.
57
+ # Note that searches do not have full recall. There may be results that match
58
+ # your query but are not returned, even in subsequent pages of results. These
59
+ # missing results may vary across repeated calls to search. Do not rely on
60
+ # this method if you need to guarantee full recall.
61
+ # See [Data Catalog Search
62
+ # Syntax](/data-catalog/docs/how-to/search-reference) for more information.
63
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogRequest] google_cloud_datacatalog_v1beta1_search_catalog_request_object
64
+ # @param [String] fields
65
+ # Selector specifying which fields to include in a partial response.
66
+ # @param [String] quota_user
67
+ # Available to use for quota purposes for server-side applications. Can be any
68
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
69
+ # @param [Google::Apis::RequestOptions] options
70
+ # Request-specific options
71
+ #
72
+ # @yield [result, err] Result & error if block supplied
73
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogResponse] parsed result object
74
+ # @yieldparam err [StandardError] error object if request failed
75
+ #
76
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogResponse]
77
+ #
78
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
79
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
80
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
81
+ def search_catalogs(google_cloud_datacatalog_v1beta1_search_catalog_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
82
+ command = make_simple_command(:post, 'v1beta1/catalog:search', options)
83
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogRequest::Representation
84
+ command.request_object = google_cloud_datacatalog_v1beta1_search_catalog_request_object
85
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogResponse::Representation
86
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogResponse
87
+ command.query['fields'] = fields unless fields.nil?
88
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
89
+ execute_or_queue_command(command, &block)
90
+ end
91
+
92
+ # Get an entry by target resource name. This method allows clients to use
93
+ # the resource name from the source Google Cloud Platform service to get the
94
+ # Data Catalog Entry.
95
+ # @param [String] linked_resource
96
+ # The full name of the Google Cloud Platform resource the Data Catalog
97
+ # entry represents. See:
98
+ # https://cloud.google.com/apis/design/resource_names#full_resource_name.
99
+ # Full names are case-sensitive.
100
+ # Examples:
101
+ # * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/
102
+ # tableId
103
+ # * //pubsub.googleapis.com/projects/projectId/topics/topicId
104
+ # @param [String] sql_resource
105
+ # The SQL name of the entry. SQL names are case-sensitive.
106
+ # Examples:
107
+ # * `cloud_pubsub.project_id.topic_id`
108
+ # * ``pubsub.project_id.`topic.id.with.dots` ``
109
+ # * `bigquery.table.project_id.dataset_id.table_id`
110
+ # * `bigquery.dataset.project_id.dataset_id`
111
+ # * `datacatalog.project_id.location_id.entry_group_id.entry_id`
112
+ # `*_id`s shoud satisfy the standard SQL rules for identifiers.
113
+ # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical.
114
+ # @param [String] fields
115
+ # Selector specifying which fields to include in a partial response.
116
+ # @param [String] quota_user
117
+ # Available to use for quota purposes for server-side applications. Can be any
118
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
119
+ # @param [Google::Apis::RequestOptions] options
120
+ # Request-specific options
121
+ #
122
+ # @yield [result, err] Result & error if block supplied
123
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] parsed result object
124
+ # @yieldparam err [StandardError] error object if request failed
125
+ #
126
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry]
127
+ #
128
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
129
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
130
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
131
+ def lookup_entry(linked_resource: nil, sql_resource: nil, fields: nil, quota_user: nil, options: nil, &block)
132
+ command = make_simple_command(:get, 'v1beta1/entries:lookup', options)
133
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
134
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry
135
+ command.query['linkedResource'] = linked_resource unless linked_resource.nil?
136
+ command.query['sqlResource'] = sql_resource unless sql_resource.nil?
137
+ command.query['fields'] = fields unless fields.nil?
138
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
139
+ execute_or_queue_command(command, &block)
140
+ end
141
+
142
+ # Alpha feature.
143
+ # Creates an EntryGroup.
144
+ # The user should enable the Data Catalog API in the project identified by
145
+ # the `parent` parameter (see [Data Catalog Resource Project]
146
+ # (/data-catalog/docs/concepts/resource-project) for more information).
147
+ # @param [String] parent
148
+ # Required. The name of the project this entry group is in. Example:
149
+ # * projects/`project_id`/locations/`location`
150
+ # Note that this EntryGroup and its child resources may not actually be
151
+ # stored in the location in this name.
152
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup] google_cloud_datacatalog_v1beta1_entry_group_object
153
+ # @param [String] entry_group_id
154
+ # Required. The id of the entry group to create.
155
+ # The id must begin with a letter or underscore, contain only English
156
+ # letters, numbers and underscores, and be at most 64 characters.
157
+ # @param [String] fields
158
+ # Selector specifying which fields to include in a partial response.
159
+ # @param [String] quota_user
160
+ # Available to use for quota purposes for server-side applications. Can be any
161
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
162
+ # @param [Google::Apis::RequestOptions] options
163
+ # Request-specific options
164
+ #
165
+ # @yield [result, err] Result & error if block supplied
166
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup] parsed result object
167
+ # @yieldparam err [StandardError] error object if request failed
168
+ #
169
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup]
170
+ #
171
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
172
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
173
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
174
+ def create_project_location_entry_group(parent, google_cloud_datacatalog_v1beta1_entry_group_object = nil, entry_group_id: nil, fields: nil, quota_user: nil, options: nil, &block)
175
+ command = make_simple_command(:post, 'v1beta1/{+parent}/entryGroups', options)
176
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup::Representation
177
+ command.request_object = google_cloud_datacatalog_v1beta1_entry_group_object
178
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup::Representation
179
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup
180
+ command.params['parent'] = parent unless parent.nil?
181
+ command.query['entryGroupId'] = entry_group_id unless entry_group_id.nil?
182
+ command.query['fields'] = fields unless fields.nil?
183
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
184
+ execute_or_queue_command(command, &block)
185
+ end
186
+
187
+ # Alpha feature.
188
+ # Deletes an EntryGroup. Only entry groups that do not contain entries can be
189
+ # deleted. The user should enable the Data Catalog API in the project
190
+ # identified by the `name` parameter (see [Data Catalog Resource Project]
191
+ # (/data-catalog/docs/concepts/resource-project) for more information).
192
+ # @param [String] name
193
+ # Required. The name of the entry group. For example,
194
+ # `projects/`project_id`/locations/`location`/entryGroups/`entry_group_id``.
195
+ # @param [String] fields
196
+ # Selector specifying which fields to include in a partial response.
197
+ # @param [String] quota_user
198
+ # Available to use for quota purposes for server-side applications. Can be any
199
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
200
+ # @param [Google::Apis::RequestOptions] options
201
+ # Request-specific options
202
+ #
203
+ # @yield [result, err] Result & error if block supplied
204
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
205
+ # @yieldparam err [StandardError] error object if request failed
206
+ #
207
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
208
+ #
209
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
210
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
211
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
212
+ def delete_project_location_entry_group(name, fields: nil, quota_user: nil, options: nil, &block)
213
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
214
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
215
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
216
+ command.params['name'] = name unless name.nil?
217
+ command.query['fields'] = fields unless fields.nil?
218
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
219
+ execute_or_queue_command(command, &block)
220
+ end
221
+
222
+ # Alpha feature.
223
+ # Gets an EntryGroup.
224
+ # @param [String] name
225
+ # Required. The name of the entry group. For example,
226
+ # `projects/`project_id`/locations/`location`/entryGroups/`entry_group_id``.
227
+ # @param [String] read_mask
228
+ # The fields to return. If not set or empty, all fields are returned.
229
+ # @param [String] fields
230
+ # Selector specifying which fields to include in a partial response.
231
+ # @param [String] quota_user
232
+ # Available to use for quota purposes for server-side applications. Can be any
233
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
234
+ # @param [Google::Apis::RequestOptions] options
235
+ # Request-specific options
236
+ #
237
+ # @yield [result, err] Result & error if block supplied
238
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup] parsed result object
239
+ # @yieldparam err [StandardError] error object if request failed
240
+ #
241
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup]
242
+ #
243
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
244
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
245
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
246
+ def get_project_location_entry_group(name, read_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
247
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
248
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup::Representation
249
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup
250
+ command.params['name'] = name unless name.nil?
251
+ command.query['readMask'] = read_mask unless read_mask.nil?
252
+ command.query['fields'] = fields unless fields.nil?
253
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
254
+ execute_or_queue_command(command, &block)
255
+ end
256
+
257
+ # Gets the access control policy for a resource. A `NOT_FOUND` error
258
+ # is returned if the resource does not exist. An empty policy is returned
259
+ # if the resource exists but does not have a policy set on it.
260
+ # Supported resources are:
261
+ # - Tag templates.
262
+ # - Entries.
263
+ # - Entry groups.
264
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
265
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
266
+ # Data Catalog.
267
+ # Callers must have following Google IAM permission
268
+ # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
269
+ # templates.
270
+ # - `datacatalog.entries.getIamPolicy` to get policies on entries.
271
+ # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
272
+ # @param [String] resource
273
+ # REQUIRED: The resource for which the policy is being requested.
274
+ # See the operation documentation for the appropriate value for this field.
275
+ # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
276
+ # @param [String] fields
277
+ # Selector specifying which fields to include in a partial response.
278
+ # @param [String] quota_user
279
+ # Available to use for quota purposes for server-side applications. Can be any
280
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
281
+ # @param [Google::Apis::RequestOptions] options
282
+ # Request-specific options
283
+ #
284
+ # @yield [result, err] Result & error if block supplied
285
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
286
+ # @yieldparam err [StandardError] error object if request failed
287
+ #
288
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
289
+ #
290
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
291
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
292
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
293
+ def get_entry_group_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
294
+ command = make_simple_command(:post, 'v1beta1/{+resource}:getIamPolicy', options)
295
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest::Representation
296
+ command.request_object = get_iam_policy_request_object
297
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
298
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
299
+ command.params['resource'] = resource unless resource.nil?
300
+ command.query['fields'] = fields unless fields.nil?
301
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
302
+ execute_or_queue_command(command, &block)
303
+ end
304
+
305
+ # Sets the access control policy for a resource. Replaces any existing
306
+ # policy.
307
+ # Supported resources are:
308
+ # - Tag templates.
309
+ # - Entries.
310
+ # - Entry groups.
311
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
312
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
313
+ # Data Catalog.
314
+ # Callers must have following Google IAM permission
315
+ # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
316
+ # templates.
317
+ # - `datacatalog.entries.setIamPolicy` to set policies on entries.
318
+ # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
319
+ # @param [String] resource
320
+ # REQUIRED: The resource for which the policy is being specified.
321
+ # See the operation documentation for the appropriate value for this field.
322
+ # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
323
+ # @param [String] fields
324
+ # Selector specifying which fields to include in a partial response.
325
+ # @param [String] quota_user
326
+ # Available to use for quota purposes for server-side applications. Can be any
327
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
328
+ # @param [Google::Apis::RequestOptions] options
329
+ # Request-specific options
330
+ #
331
+ # @yield [result, err] Result & error if block supplied
332
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
333
+ # @yieldparam err [StandardError] error object if request failed
334
+ #
335
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
336
+ #
337
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
338
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
339
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
340
+ def set_entry_group_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
341
+ command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
342
+ command.request_representation = Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest::Representation
343
+ command.request_object = set_iam_policy_request_object
344
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
345
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
346
+ command.params['resource'] = resource unless resource.nil?
347
+ command.query['fields'] = fields unless fields.nil?
348
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
349
+ execute_or_queue_command(command, &block)
350
+ end
351
+
352
+ # Returns the caller's permissions on a resource.
353
+ # If the resource does not exist, an empty set of permissions is returned
354
+ # (We don't return a `NOT_FOUND` error).
355
+ # Supported resources are:
356
+ # - Tag templates.
357
+ # - Entries.
358
+ # - Entry groups.
359
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
360
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
361
+ # Data Catalog.
362
+ # A caller is not required to have Google IAM permission to make this
363
+ # request.
364
+ # @param [String] resource
365
+ # REQUIRED: The resource for which the policy detail is being requested.
366
+ # See the operation documentation for the appropriate value for this field.
367
+ # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
368
+ # @param [String] fields
369
+ # Selector specifying which fields to include in a partial response.
370
+ # @param [String] quota_user
371
+ # Available to use for quota purposes for server-side applications. Can be any
372
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
373
+ # @param [Google::Apis::RequestOptions] options
374
+ # Request-specific options
375
+ #
376
+ # @yield [result, err] Result & error if block supplied
377
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse] parsed result object
378
+ # @yieldparam err [StandardError] error object if request failed
379
+ #
380
+ # @return [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse]
381
+ #
382
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
383
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
384
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
385
+ def test_entry_group_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
386
+ command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
387
+ command.request_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest::Representation
388
+ command.request_object = test_iam_permissions_request_object
389
+ command.response_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse::Representation
390
+ command.response_class = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse
391
+ command.params['resource'] = resource unless resource.nil?
392
+ command.query['fields'] = fields unless fields.nil?
393
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
394
+ execute_or_queue_command(command, &block)
395
+ end
396
+
397
+ # Alpha feature.
398
+ # Creates an entry. Currently only entries of 'FILESET' type can be created.
399
+ # The user should enable the Data Catalog API in the project identified by
400
+ # the `parent` parameter (see [Data Catalog Resource Project]
401
+ # (/data-catalog/docs/concepts/resource-project) for more information).
402
+ # @param [String] parent
403
+ # Required. The name of the entry group this entry is in. Example:
404
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`
405
+ # Note that this Entry and its child resources may not actually be stored in
406
+ # the location in this name.
407
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] google_cloud_datacatalog_v1beta1_entry_object
408
+ # @param [String] entry_id
409
+ # Required. The id of the entry to create.
410
+ # @param [String] fields
411
+ # Selector specifying which fields to include in a partial response.
412
+ # @param [String] quota_user
413
+ # Available to use for quota purposes for server-side applications. Can be any
414
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
415
+ # @param [Google::Apis::RequestOptions] options
416
+ # Request-specific options
417
+ #
418
+ # @yield [result, err] Result & error if block supplied
419
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] parsed result object
420
+ # @yieldparam err [StandardError] error object if request failed
421
+ #
422
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry]
423
+ #
424
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
425
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
426
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
427
+ def create_project_location_entry_group_entry(parent, google_cloud_datacatalog_v1beta1_entry_object = nil, entry_id: nil, fields: nil, quota_user: nil, options: nil, &block)
428
+ command = make_simple_command(:post, 'v1beta1/{+parent}/entries', options)
429
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
430
+ command.request_object = google_cloud_datacatalog_v1beta1_entry_object
431
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
432
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry
433
+ command.params['parent'] = parent unless parent.nil?
434
+ command.query['entryId'] = entry_id unless entry_id.nil?
435
+ command.query['fields'] = fields unless fields.nil?
436
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
437
+ execute_or_queue_command(command, &block)
438
+ end
439
+
440
+ # Alpha feature.
441
+ # Deletes an existing entry. Only entries created through
442
+ # CreateEntry
443
+ # method can be deleted.
444
+ # The user should enable the Data Catalog API in the project identified by
445
+ # the `name` parameter (see [Data Catalog Resource Project]
446
+ # (/data-catalog/docs/concepts/resource-project) for more information).
447
+ # @param [String] name
448
+ # Required. The name of the entry. Example:
449
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/
450
+ # entries/`entry_id`
451
+ # @param [String] fields
452
+ # Selector specifying which fields to include in a partial response.
453
+ # @param [String] quota_user
454
+ # Available to use for quota purposes for server-side applications. Can be any
455
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
456
+ # @param [Google::Apis::RequestOptions] options
457
+ # Request-specific options
458
+ #
459
+ # @yield [result, err] Result & error if block supplied
460
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
461
+ # @yieldparam err [StandardError] error object if request failed
462
+ #
463
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
464
+ #
465
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
466
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
467
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
468
+ def delete_project_location_entry_group_entry(name, fields: nil, quota_user: nil, options: nil, &block)
469
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
470
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
471
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
472
+ command.params['name'] = name unless name.nil?
473
+ command.query['fields'] = fields unless fields.nil?
474
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
475
+ execute_or_queue_command(command, &block)
476
+ end
477
+
478
+ # Gets an entry.
479
+ # @param [String] name
480
+ # Required. The name of the entry. Example:
481
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/
482
+ # entries/`entry_id`
483
+ # Entry groups are logical groupings of entries. Currently, users cannot
484
+ # create/modify entry groups. They are created by Data Catalog; they include
485
+ # `@bigquery` for all BigQuery entries, and `@pubsub` for all Cloud Pub/Sub
486
+ # entries.
487
+ # @param [String] fields
488
+ # Selector specifying which fields to include in a partial response.
489
+ # @param [String] quota_user
490
+ # Available to use for quota purposes for server-side applications. Can be any
491
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
492
+ # @param [Google::Apis::RequestOptions] options
493
+ # Request-specific options
494
+ #
495
+ # @yield [result, err] Result & error if block supplied
496
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] parsed result object
497
+ # @yieldparam err [StandardError] error object if request failed
498
+ #
499
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry]
500
+ #
501
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
502
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
503
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
504
+ def get_project_location_entry_group_entry(name, fields: nil, quota_user: nil, options: nil, &block)
505
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
506
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
507
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry
508
+ command.params['name'] = name unless name.nil?
509
+ command.query['fields'] = fields unless fields.nil?
510
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
511
+ execute_or_queue_command(command, &block)
512
+ end
513
+
514
+ # Gets the access control policy for a resource. A `NOT_FOUND` error
515
+ # is returned if the resource does not exist. An empty policy is returned
516
+ # if the resource exists but does not have a policy set on it.
517
+ # Supported resources are:
518
+ # - Tag templates.
519
+ # - Entries.
520
+ # - Entry groups.
521
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
522
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
523
+ # Data Catalog.
524
+ # Callers must have following Google IAM permission
525
+ # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
526
+ # templates.
527
+ # - `datacatalog.entries.getIamPolicy` to get policies on entries.
528
+ # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
529
+ # @param [String] resource
530
+ # REQUIRED: The resource for which the policy is being requested.
531
+ # See the operation documentation for the appropriate value for this field.
532
+ # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
533
+ # @param [String] fields
534
+ # Selector specifying which fields to include in a partial response.
535
+ # @param [String] quota_user
536
+ # Available to use for quota purposes for server-side applications. Can be any
537
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
538
+ # @param [Google::Apis::RequestOptions] options
539
+ # Request-specific options
540
+ #
541
+ # @yield [result, err] Result & error if block supplied
542
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
543
+ # @yieldparam err [StandardError] error object if request failed
544
+ #
545
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
546
+ #
547
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
548
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
549
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
550
+ def get_entry_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
551
+ command = make_simple_command(:post, 'v1beta1/{+resource}:getIamPolicy', options)
552
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest::Representation
553
+ command.request_object = get_iam_policy_request_object
554
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
555
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
556
+ command.params['resource'] = resource unless resource.nil?
557
+ command.query['fields'] = fields unless fields.nil?
558
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
559
+ execute_or_queue_command(command, &block)
560
+ end
561
+
562
+ # Updates an existing entry.
563
+ # The user should enable the Data Catalog API in the project identified by
564
+ # the `entry.name` parameter (see [Data Catalog Resource Project]
565
+ # (/data-catalog/docs/concepts/resource-project) for more information).
566
+ # @param [String] name
567
+ # The Data Catalog resource name of the entry in URL format. Example:
568
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/
569
+ # entries/`entry_id`
570
+ # Note that this Entry and its child resources may not actually be stored in
571
+ # the location in this name.
572
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] google_cloud_datacatalog_v1beta1_entry_object
573
+ # @param [String] update_mask
574
+ # The fields to update on the entry. If absent or empty, all modifiable
575
+ # fields are updated.
576
+ # The following fields are modifiable:
577
+ # * For entries with type `DATA_STREAM`:
578
+ # * `schema`
579
+ # * For entries with type `FILESET`
580
+ # * `schema`
581
+ # * `display_name`
582
+ # * `description`
583
+ # * `gcs_fileset_spec`
584
+ # * `gcs_fileset_spec.file_patterns`
585
+ # @param [String] fields
586
+ # Selector specifying which fields to include in a partial response.
587
+ # @param [String] quota_user
588
+ # Available to use for quota purposes for server-side applications. Can be any
589
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
590
+ # @param [Google::Apis::RequestOptions] options
591
+ # Request-specific options
592
+ #
593
+ # @yield [result, err] Result & error if block supplied
594
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] parsed result object
595
+ # @yieldparam err [StandardError] error object if request failed
596
+ #
597
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry]
598
+ #
599
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
600
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
601
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
602
+ def patch_project_location_entry_group_entry(name, google_cloud_datacatalog_v1beta1_entry_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
603
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
604
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
605
+ command.request_object = google_cloud_datacatalog_v1beta1_entry_object
606
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry::Representation
607
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry
608
+ command.params['name'] = name unless name.nil?
609
+ command.query['updateMask'] = update_mask unless update_mask.nil?
610
+ command.query['fields'] = fields unless fields.nil?
611
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
612
+ execute_or_queue_command(command, &block)
613
+ end
614
+
615
+ # Sets the access control policy for a resource. Replaces any existing
616
+ # policy.
617
+ # Supported resources are:
618
+ # - Tag templates.
619
+ # - Entries.
620
+ # - Entry groups.
621
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
622
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
623
+ # Data Catalog.
624
+ # Callers must have following Google IAM permission
625
+ # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
626
+ # templates.
627
+ # - `datacatalog.entries.setIamPolicy` to set policies on entries.
628
+ # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
629
+ # @param [String] resource
630
+ # REQUIRED: The resource for which the policy is being specified.
631
+ # See the operation documentation for the appropriate value for this field.
632
+ # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
633
+ # @param [String] fields
634
+ # Selector specifying which fields to include in a partial response.
635
+ # @param [String] quota_user
636
+ # Available to use for quota purposes for server-side applications. Can be any
637
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
638
+ # @param [Google::Apis::RequestOptions] options
639
+ # Request-specific options
640
+ #
641
+ # @yield [result, err] Result & error if block supplied
642
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
643
+ # @yieldparam err [StandardError] error object if request failed
644
+ #
645
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
646
+ #
647
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
648
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
649
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
650
+ def set_entry_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
651
+ command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
652
+ command.request_representation = Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest::Representation
653
+ command.request_object = set_iam_policy_request_object
654
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
655
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
656
+ command.params['resource'] = resource unless resource.nil?
657
+ command.query['fields'] = fields unless fields.nil?
658
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
659
+ execute_or_queue_command(command, &block)
660
+ end
661
+
662
+ # Returns the caller's permissions on a resource.
663
+ # If the resource does not exist, an empty set of permissions is returned
664
+ # (We don't return a `NOT_FOUND` error).
665
+ # Supported resources are:
666
+ # - Tag templates.
667
+ # - Entries.
668
+ # - Entry groups.
669
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
670
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
671
+ # Data Catalog.
672
+ # A caller is not required to have Google IAM permission to make this
673
+ # request.
674
+ # @param [String] resource
675
+ # REQUIRED: The resource for which the policy detail is being requested.
676
+ # See the operation documentation for the appropriate value for this field.
677
+ # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
678
+ # @param [String] fields
679
+ # Selector specifying which fields to include in a partial response.
680
+ # @param [String] quota_user
681
+ # Available to use for quota purposes for server-side applications. Can be any
682
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
683
+ # @param [Google::Apis::RequestOptions] options
684
+ # Request-specific options
685
+ #
686
+ # @yield [result, err] Result & error if block supplied
687
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse] parsed result object
688
+ # @yieldparam err [StandardError] error object if request failed
689
+ #
690
+ # @return [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse]
691
+ #
692
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
693
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
694
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
695
+ def test_entry_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
696
+ command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
697
+ command.request_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest::Representation
698
+ command.request_object = test_iam_permissions_request_object
699
+ command.response_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse::Representation
700
+ command.response_class = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse
701
+ command.params['resource'] = resource unless resource.nil?
702
+ command.query['fields'] = fields unless fields.nil?
703
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
704
+ execute_or_queue_command(command, &block)
705
+ end
706
+
707
+ # Creates a tag on an Entry.
708
+ # Note: The project identified by the `parent` parameter for the
709
+ # [tag](/data-catalog/docs/reference/rest/v1beta1/projects.locations.entryGroups.
710
+ # entries.tags/create#path-parameters)
711
+ # and the
712
+ # [tag
713
+ # template](/data-catalog/docs/reference/rest/v1beta1/projects.locations.
714
+ # tagTemplates/create#path-parameters)
715
+ # used to create the tag must be from the same organization.
716
+ # @param [String] parent
717
+ # Required. The name of the resource to attach this tag to. Tags can be attached
718
+ # to
719
+ # Entries. Example:
720
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/
721
+ # entries/`entry_id`
722
+ # Note that this Tag and its child resources may not actually be stored in
723
+ # the location in this name.
724
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object
725
+ # @param [String] fields
726
+ # Selector specifying which fields to include in a partial response.
727
+ # @param [String] quota_user
728
+ # Available to use for quota purposes for server-side applications. Can be any
729
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
730
+ # @param [Google::Apis::RequestOptions] options
731
+ # Request-specific options
732
+ #
733
+ # @yield [result, err] Result & error if block supplied
734
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] parsed result object
735
+ # @yieldparam err [StandardError] error object if request failed
736
+ #
737
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag]
738
+ #
739
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
740
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
741
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
742
+ def create_project_location_entry_group_entry_tag(parent, google_cloud_datacatalog_v1beta1_tag_object = nil, fields: nil, quota_user: nil, options: nil, &block)
743
+ command = make_simple_command(:post, 'v1beta1/{+parent}/tags', options)
744
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag::Representation
745
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_object
746
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag::Representation
747
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag
748
+ command.params['parent'] = parent unless parent.nil?
749
+ command.query['fields'] = fields unless fields.nil?
750
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
751
+ execute_or_queue_command(command, &block)
752
+ end
753
+
754
+ # Deletes a tag.
755
+ # @param [String] name
756
+ # Required. The name of the tag to delete. Example:
757
+ # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/
758
+ # entries/`entry_id`/tags/`tag_id`
759
+ # @param [String] fields
760
+ # Selector specifying which fields to include in a partial response.
761
+ # @param [String] quota_user
762
+ # Available to use for quota purposes for server-side applications. Can be any
763
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
764
+ # @param [Google::Apis::RequestOptions] options
765
+ # Request-specific options
766
+ #
767
+ # @yield [result, err] Result & error if block supplied
768
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
769
+ # @yieldparam err [StandardError] error object if request failed
770
+ #
771
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
772
+ #
773
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
774
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
775
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
776
+ def delete_project_location_entry_group_entry_tag(name, fields: nil, quota_user: nil, options: nil, &block)
777
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
778
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
779
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
780
+ command.params['name'] = name unless name.nil?
781
+ command.query['fields'] = fields unless fields.nil?
782
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
783
+ execute_or_queue_command(command, &block)
784
+ end
785
+
786
+ # Lists the tags on an Entry.
787
+ # @param [String] parent
788
+ # Required. The name of the Data Catalog resource to list the tags of. The
789
+ # resource could be an Entry.
790
+ # @param [Fixnum] page_size
791
+ # The maximum number of tags to return. Default is 10. Max limit is 1000.
792
+ # @param [String] page_token
793
+ # Token that specifies which page is requested. If empty, the first page is
794
+ # returned.
795
+ # @param [String] fields
796
+ # Selector specifying which fields to include in a partial response.
797
+ # @param [String] quota_user
798
+ # Available to use for quota purposes for server-side applications. Can be any
799
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
800
+ # @param [Google::Apis::RequestOptions] options
801
+ # Request-specific options
802
+ #
803
+ # @yield [result, err] Result & error if block supplied
804
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTagsResponse] parsed result object
805
+ # @yieldparam err [StandardError] error object if request failed
806
+ #
807
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTagsResponse]
808
+ #
809
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
810
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
811
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
812
+ def list_project_location_entry_group_entry_tags(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
813
+ command = make_simple_command(:get, 'v1beta1/{+parent}/tags', options)
814
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTagsResponse::Representation
815
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTagsResponse
816
+ command.params['parent'] = parent unless parent.nil?
817
+ command.query['pageSize'] = page_size unless page_size.nil?
818
+ command.query['pageToken'] = page_token unless page_token.nil?
819
+ command.query['fields'] = fields unless fields.nil?
820
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
821
+ execute_or_queue_command(command, &block)
822
+ end
823
+
824
+ # Updates an existing tag.
825
+ # @param [String] name
826
+ # The resource name of the tag in URL format. Example:
827
+ # * projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/
828
+ # entries/`entry_id`/tags/`tag_id`
829
+ # where `tag_id` is a system-generated identifier.
830
+ # Note that this Tag may not actually be stored in the location in this name.
831
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object
832
+ # @param [String] update_mask
833
+ # The fields to update on the Tag. If absent or empty, all modifiable fields
834
+ # are updated. Currently the only modifiable field is the field `fields`.
835
+ # @param [String] fields
836
+ # Selector specifying which fields to include in a partial response.
837
+ # @param [String] quota_user
838
+ # Available to use for quota purposes for server-side applications. Can be any
839
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
840
+ # @param [Google::Apis::RequestOptions] options
841
+ # Request-specific options
842
+ #
843
+ # @yield [result, err] Result & error if block supplied
844
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] parsed result object
845
+ # @yieldparam err [StandardError] error object if request failed
846
+ #
847
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag]
848
+ #
849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
852
+ def patch_project_location_entry_group_entry_tag(name, google_cloud_datacatalog_v1beta1_tag_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
853
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
854
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag::Representation
855
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_object
856
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag::Representation
857
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag
858
+ command.params['name'] = name unless name.nil?
859
+ command.query['updateMask'] = update_mask unless update_mask.nil?
860
+ command.query['fields'] = fields unless fields.nil?
861
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
862
+ execute_or_queue_command(command, &block)
863
+ end
864
+
865
+ # Creates a tag template. The user should enable the Data Catalog API in
866
+ # the project identified by the `parent` parameter (see [Data Catalog
867
+ # Resource Project](/data-catalog/docs/concepts/resource-project) for more
868
+ # information).
869
+ # @param [String] parent
870
+ # Required. The name of the project and the location this template is in.
871
+ # Example:
872
+ # * projects/`project_id`/locations/`location`
873
+ # TagTemplate and its child resources may not actually be stored in the
874
+ # location in this name.
875
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] google_cloud_datacatalog_v1beta1_tag_template_object
876
+ # @param [String] tag_template_id
877
+ # Required. The id of the tag template to create.
878
+ # @param [String] fields
879
+ # Selector specifying which fields to include in a partial response.
880
+ # @param [String] quota_user
881
+ # Available to use for quota purposes for server-side applications. Can be any
882
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
883
+ # @param [Google::Apis::RequestOptions] options
884
+ # Request-specific options
885
+ #
886
+ # @yield [result, err] Result & error if block supplied
887
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] parsed result object
888
+ # @yieldparam err [StandardError] error object if request failed
889
+ #
890
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate]
891
+ #
892
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
893
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
894
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
895
+ def create_project_location_tag_template(parent, google_cloud_datacatalog_v1beta1_tag_template_object = nil, tag_template_id: nil, fields: nil, quota_user: nil, options: nil, &block)
896
+ command = make_simple_command(:post, 'v1beta1/{+parent}/tagTemplates', options)
897
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate::Representation
898
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_template_object
899
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate::Representation
900
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate
901
+ command.params['parent'] = parent unless parent.nil?
902
+ command.query['tagTemplateId'] = tag_template_id unless tag_template_id.nil?
903
+ command.query['fields'] = fields unless fields.nil?
904
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
905
+ execute_or_queue_command(command, &block)
906
+ end
907
+
908
+ # Deletes a tag template and all tags using the template.
909
+ # The user should enable the Data Catalog API in the project identified by
910
+ # the `name` parameter (see [Data Catalog Resource Project]
911
+ # (/data-catalog/docs/concepts/resource-project) for more information).
912
+ # @param [String] name
913
+ # Required. The name of the tag template to delete. Example:
914
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`
915
+ # @param [Boolean] force
916
+ # Required. Currently, this field must always be set to `true`.
917
+ # This confirms the deletion of any possible tags using this template.
918
+ # `force = false` will be supported in the future.
919
+ # @param [String] fields
920
+ # Selector specifying which fields to include in a partial response.
921
+ # @param [String] quota_user
922
+ # Available to use for quota purposes for server-side applications. Can be any
923
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
924
+ # @param [Google::Apis::RequestOptions] options
925
+ # Request-specific options
926
+ #
927
+ # @yield [result, err] Result & error if block supplied
928
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
929
+ # @yieldparam err [StandardError] error object if request failed
930
+ #
931
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
932
+ #
933
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
934
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
935
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
936
+ def delete_project_location_tag_template(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
937
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
938
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
939
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
940
+ command.params['name'] = name unless name.nil?
941
+ command.query['force'] = force unless force.nil?
942
+ command.query['fields'] = fields unless fields.nil?
943
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
944
+ execute_or_queue_command(command, &block)
945
+ end
946
+
947
+ # Gets a tag template.
948
+ # @param [String] name
949
+ # Required. The name of the tag template. Example:
950
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`
951
+ # @param [String] fields
952
+ # Selector specifying which fields to include in a partial response.
953
+ # @param [String] quota_user
954
+ # Available to use for quota purposes for server-side applications. Can be any
955
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
956
+ # @param [Google::Apis::RequestOptions] options
957
+ # Request-specific options
958
+ #
959
+ # @yield [result, err] Result & error if block supplied
960
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] parsed result object
961
+ # @yieldparam err [StandardError] error object if request failed
962
+ #
963
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate]
964
+ #
965
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
966
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
967
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
968
+ def get_project_location_tag_template(name, fields: nil, quota_user: nil, options: nil, &block)
969
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
970
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate::Representation
971
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate
972
+ command.params['name'] = name unless name.nil?
973
+ command.query['fields'] = fields unless fields.nil?
974
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
975
+ execute_or_queue_command(command, &block)
976
+ end
977
+
978
+ # Gets the access control policy for a resource. A `NOT_FOUND` error
979
+ # is returned if the resource does not exist. An empty policy is returned
980
+ # if the resource exists but does not have a policy set on it.
981
+ # Supported resources are:
982
+ # - Tag templates.
983
+ # - Entries.
984
+ # - Entry groups.
985
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
986
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
987
+ # Data Catalog.
988
+ # Callers must have following Google IAM permission
989
+ # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
990
+ # templates.
991
+ # - `datacatalog.entries.getIamPolicy` to get policies on entries.
992
+ # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
993
+ # @param [String] resource
994
+ # REQUIRED: The resource for which the policy is being requested.
995
+ # See the operation documentation for the appropriate value for this field.
996
+ # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
997
+ # @param [String] fields
998
+ # Selector specifying which fields to include in a partial response.
999
+ # @param [String] quota_user
1000
+ # Available to use for quota purposes for server-side applications. Can be any
1001
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1002
+ # @param [Google::Apis::RequestOptions] options
1003
+ # Request-specific options
1004
+ #
1005
+ # @yield [result, err] Result & error if block supplied
1006
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1007
+ # @yieldparam err [StandardError] error object if request failed
1008
+ #
1009
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1010
+ #
1011
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1012
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1013
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1014
+ def get_tag_template_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1015
+ command = make_simple_command(:post, 'v1beta1/{+resource}:getIamPolicy', options)
1016
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest::Representation
1017
+ command.request_object = get_iam_policy_request_object
1018
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1019
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1020
+ command.params['resource'] = resource unless resource.nil?
1021
+ command.query['fields'] = fields unless fields.nil?
1022
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1023
+ execute_or_queue_command(command, &block)
1024
+ end
1025
+
1026
+ # Updates a tag template. This method cannot be used to update the fields of
1027
+ # a template. The tag template fields are represented as separate resources
1028
+ # and should be updated using their own create/update/delete methods.
1029
+ # The user should enable the Data Catalog API in the project identified by
1030
+ # the `tag_template.name` parameter (see [Data Catalog Resource Project]
1031
+ # (/data-catalog/docs/concepts/resource-project) for more information).
1032
+ # @param [String] name
1033
+ # The resource name of the tag template in URL format. Example:
1034
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`
1035
+ # Note that this TagTemplate and its child resources may not actually be
1036
+ # stored in the location in this name.
1037
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] google_cloud_datacatalog_v1beta1_tag_template_object
1038
+ # @param [String] update_mask
1039
+ # The field mask specifies the parts of the template to overwrite.
1040
+ # Allowed fields:
1041
+ # * `display_name`
1042
+ # If absent or empty, all of the allowed fields above will be updated.
1043
+ # @param [String] fields
1044
+ # Selector specifying which fields to include in a partial response.
1045
+ # @param [String] quota_user
1046
+ # Available to use for quota purposes for server-side applications. Can be any
1047
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1048
+ # @param [Google::Apis::RequestOptions] options
1049
+ # Request-specific options
1050
+ #
1051
+ # @yield [result, err] Result & error if block supplied
1052
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] parsed result object
1053
+ # @yieldparam err [StandardError] error object if request failed
1054
+ #
1055
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate]
1056
+ #
1057
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1058
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1059
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1060
+ def patch_project_location_tag_template(name, google_cloud_datacatalog_v1beta1_tag_template_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1061
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1062
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate::Representation
1063
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_template_object
1064
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate::Representation
1065
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate
1066
+ command.params['name'] = name unless name.nil?
1067
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1068
+ command.query['fields'] = fields unless fields.nil?
1069
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1070
+ execute_or_queue_command(command, &block)
1071
+ end
1072
+
1073
+ # Sets the access control policy for a resource. Replaces any existing
1074
+ # policy.
1075
+ # Supported resources are:
1076
+ # - Tag templates.
1077
+ # - Entries.
1078
+ # - Entry groups.
1079
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
1080
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
1081
+ # Data Catalog.
1082
+ # Callers must have following Google IAM permission
1083
+ # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
1084
+ # templates.
1085
+ # - `datacatalog.entries.setIamPolicy` to set policies on entries.
1086
+ # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
1087
+ # @param [String] resource
1088
+ # REQUIRED: The resource for which the policy is being specified.
1089
+ # See the operation documentation for the appropriate value for this field.
1090
+ # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
1091
+ # @param [String] fields
1092
+ # Selector specifying which fields to include in a partial response.
1093
+ # @param [String] quota_user
1094
+ # Available to use for quota purposes for server-side applications. Can be any
1095
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1096
+ # @param [Google::Apis::RequestOptions] options
1097
+ # Request-specific options
1098
+ #
1099
+ # @yield [result, err] Result & error if block supplied
1100
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1101
+ # @yieldparam err [StandardError] error object if request failed
1102
+ #
1103
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1104
+ #
1105
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1106
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1107
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1108
+ def set_tag_template_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1109
+ command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
1110
+ command.request_representation = Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest::Representation
1111
+ command.request_object = set_iam_policy_request_object
1112
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1113
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1114
+ command.params['resource'] = resource unless resource.nil?
1115
+ command.query['fields'] = fields unless fields.nil?
1116
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1117
+ execute_or_queue_command(command, &block)
1118
+ end
1119
+
1120
+ # Returns the caller's permissions on a resource.
1121
+ # If the resource does not exist, an empty set of permissions is returned
1122
+ # (We don't return a `NOT_FOUND` error).
1123
+ # Supported resources are:
1124
+ # - Tag templates.
1125
+ # - Entries.
1126
+ # - Entry groups.
1127
+ # Note, this method cannot be used to manage policies for BigQuery, Cloud
1128
+ # Pub/Sub and any external Google Cloud Platform resources synced to Cloud
1129
+ # Data Catalog.
1130
+ # A caller is not required to have Google IAM permission to make this
1131
+ # request.
1132
+ # @param [String] resource
1133
+ # REQUIRED: The resource for which the policy detail is being requested.
1134
+ # See the operation documentation for the appropriate value for this field.
1135
+ # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
1136
+ # @param [String] fields
1137
+ # Selector specifying which fields to include in a partial response.
1138
+ # @param [String] quota_user
1139
+ # Available to use for quota purposes for server-side applications. Can be any
1140
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1141
+ # @param [Google::Apis::RequestOptions] options
1142
+ # Request-specific options
1143
+ #
1144
+ # @yield [result, err] Result & error if block supplied
1145
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse] parsed result object
1146
+ # @yieldparam err [StandardError] error object if request failed
1147
+ #
1148
+ # @return [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse]
1149
+ #
1150
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1151
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1152
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1153
+ def test_tag_template_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1154
+ command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
1155
+ command.request_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest::Representation
1156
+ command.request_object = test_iam_permissions_request_object
1157
+ command.response_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse::Representation
1158
+ command.response_class = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse
1159
+ command.params['resource'] = resource unless resource.nil?
1160
+ command.query['fields'] = fields unless fields.nil?
1161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1162
+ execute_or_queue_command(command, &block)
1163
+ end
1164
+
1165
+ # Creates a field in a tag template. The user should enable the Data Catalog
1166
+ # API in the project identified by the `parent` parameter (see
1167
+ # [Data Catalog Resource
1168
+ # Project](/data-catalog/docs/concepts/resource-project) for more
1169
+ # information).
1170
+ # @param [String] parent
1171
+ # Required. The name of the project this template is in. Example:
1172
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`
1173
+ # Note that this TagTemplateField may not actually be stored in the location
1174
+ # in this name.
1175
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] google_cloud_datacatalog_v1beta1_tag_template_field_object
1176
+ # @param [String] tag_template_field_id
1177
+ # Required. The ID of the tag template field to create.
1178
+ # Field ids can contain letters (both uppercase and lowercase), numbers
1179
+ # (0-9), underscores (_) and dashes (-). Field IDs must be at least 1
1180
+ # character long and at most 128 characters long. Field IDs must also be
1181
+ # unique within their template.
1182
+ # @param [String] fields
1183
+ # Selector specifying which fields to include in a partial response.
1184
+ # @param [String] quota_user
1185
+ # Available to use for quota purposes for server-side applications. Can be any
1186
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1187
+ # @param [Google::Apis::RequestOptions] options
1188
+ # Request-specific options
1189
+ #
1190
+ # @yield [result, err] Result & error if block supplied
1191
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] parsed result object
1192
+ # @yieldparam err [StandardError] error object if request failed
1193
+ #
1194
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField]
1195
+ #
1196
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1197
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1198
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1199
+ def create_project_location_tag_template_field(parent, google_cloud_datacatalog_v1beta1_tag_template_field_object = nil, tag_template_field_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1200
+ command = make_simple_command(:post, 'v1beta1/{+parent}/fields', options)
1201
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField::Representation
1202
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_template_field_object
1203
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField::Representation
1204
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField
1205
+ command.params['parent'] = parent unless parent.nil?
1206
+ command.query['tagTemplateFieldId'] = tag_template_field_id unless tag_template_field_id.nil?
1207
+ command.query['fields'] = fields unless fields.nil?
1208
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1209
+ execute_or_queue_command(command, &block)
1210
+ end
1211
+
1212
+ # Deletes a field in a tag template and all uses of that field.
1213
+ # The user should enable the Data Catalog API in the project identified by
1214
+ # the `name` parameter (see [Data Catalog Resource Project]
1215
+ # (/data-catalog/docs/concepts/resource-project) for more information).
1216
+ # @param [String] name
1217
+ # Required. The name of the tag template field to delete. Example:
1218
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/
1219
+ # fields/`tag_template_field_id`
1220
+ # @param [Boolean] force
1221
+ # Required. Currently, this field must always be set to `true`.
1222
+ # This confirms the deletion of this field from any tags using this field.
1223
+ # `force = false` will be supported in the future.
1224
+ # @param [String] fields
1225
+ # Selector specifying which fields to include in a partial response.
1226
+ # @param [String] quota_user
1227
+ # Available to use for quota purposes for server-side applications. Can be any
1228
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1229
+ # @param [Google::Apis::RequestOptions] options
1230
+ # Request-specific options
1231
+ #
1232
+ # @yield [result, err] Result & error if block supplied
1233
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
1234
+ # @yieldparam err [StandardError] error object if request failed
1235
+ #
1236
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
1237
+ #
1238
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1239
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1240
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1241
+ def delete_project_location_tag_template_field(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
1242
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1243
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
1244
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
1245
+ command.params['name'] = name unless name.nil?
1246
+ command.query['force'] = force unless force.nil?
1247
+ command.query['fields'] = fields unless fields.nil?
1248
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1249
+ execute_or_queue_command(command, &block)
1250
+ end
1251
+
1252
+ # Updates a field in a tag template. This method cannot be used to update the
1253
+ # field type. The user should enable the Data Catalog API in the project
1254
+ # identified by the `name` parameter (see [Data Catalog Resource Project]
1255
+ # (/data-catalog/docs/concepts/resource-project) for more information).
1256
+ # @param [String] name
1257
+ # Required. The name of the tag template field. Example:
1258
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/
1259
+ # fields/`tag_template_field_id`
1260
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] google_cloud_datacatalog_v1beta1_tag_template_field_object
1261
+ # @param [String] update_mask
1262
+ # The field mask specifies the parts of the template to be updated.
1263
+ # Allowed fields:
1264
+ # * `display_name`
1265
+ # * `type.enum_type`
1266
+ # If `update_mask` is not set or empty, all of the allowed fields above will
1267
+ # be updated.
1268
+ # When updating an enum type, the provided values will be merged with the
1269
+ # existing values. Therefore, enum values can only be added, existing enum
1270
+ # values cannot be deleted nor renamed.
1271
+ # @param [String] fields
1272
+ # Selector specifying which fields to include in a partial response.
1273
+ # @param [String] quota_user
1274
+ # Available to use for quota purposes for server-side applications. Can be any
1275
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1276
+ # @param [Google::Apis::RequestOptions] options
1277
+ # Request-specific options
1278
+ #
1279
+ # @yield [result, err] Result & error if block supplied
1280
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] parsed result object
1281
+ # @yieldparam err [StandardError] error object if request failed
1282
+ #
1283
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField]
1284
+ #
1285
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1286
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1287
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1288
+ def patch_project_location_tag_template_field(name, google_cloud_datacatalog_v1beta1_tag_template_field_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1289
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1290
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField::Representation
1291
+ command.request_object = google_cloud_datacatalog_v1beta1_tag_template_field_object
1292
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField::Representation
1293
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField
1294
+ command.params['name'] = name unless name.nil?
1295
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1296
+ command.query['fields'] = fields unless fields.nil?
1297
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1298
+ execute_or_queue_command(command, &block)
1299
+ end
1300
+
1301
+ # Renames a field in a tag template. The user should enable the Data Catalog
1302
+ # API in the project identified by the `name` parameter (see [Data Catalog
1303
+ # Resource Project](/data-catalog/docs/concepts/resource-project) for more
1304
+ # information).
1305
+ # @param [String] name
1306
+ # Required. The name of the tag template. Example:
1307
+ # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/
1308
+ # fields/`tag_template_field_id`
1309
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest] google_cloud_datacatalog_v1beta1_rename_tag_template_field_request_object
1310
+ # @param [String] fields
1311
+ # Selector specifying which fields to include in a partial response.
1312
+ # @param [String] quota_user
1313
+ # Available to use for quota purposes for server-side applications. Can be any
1314
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1315
+ # @param [Google::Apis::RequestOptions] options
1316
+ # Request-specific options
1317
+ #
1318
+ # @yield [result, err] Result & error if block supplied
1319
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] parsed result object
1320
+ # @yieldparam err [StandardError] error object if request failed
1321
+ #
1322
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField]
1323
+ #
1324
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1325
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1326
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1327
+ def rename_project_location_tag_template_field(name, google_cloud_datacatalog_v1beta1_rename_tag_template_field_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1328
+ command = make_simple_command(:post, 'v1beta1/{+name}:rename', options)
1329
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest::Representation
1330
+ command.request_object = google_cloud_datacatalog_v1beta1_rename_tag_template_field_request_object
1331
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField::Representation
1332
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField
1333
+ command.params['name'] = name unless name.nil?
1334
+ command.query['fields'] = fields unless fields.nil?
1335
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1336
+ execute_or_queue_command(command, &block)
1337
+ end
1338
+
1339
+ # Creates a taxonomy in the specified project.
1340
+ # @param [String] parent
1341
+ # Required. Resource name of the project that the taxonomy will belong to.
1342
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] google_cloud_datacatalog_v1beta1_taxonomy_object
1343
+ # @param [String] fields
1344
+ # Selector specifying which fields to include in a partial response.
1345
+ # @param [String] quota_user
1346
+ # Available to use for quota purposes for server-side applications. Can be any
1347
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1348
+ # @param [Google::Apis::RequestOptions] options
1349
+ # Request-specific options
1350
+ #
1351
+ # @yield [result, err] Result & error if block supplied
1352
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] parsed result object
1353
+ # @yieldparam err [StandardError] error object if request failed
1354
+ #
1355
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy]
1356
+ #
1357
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1358
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1359
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1360
+ def create_project_location_taxonomy(parent, google_cloud_datacatalog_v1beta1_taxonomy_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1361
+ command = make_simple_command(:post, 'v1beta1/{+parent}/taxonomies', options)
1362
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy::Representation
1363
+ command.request_object = google_cloud_datacatalog_v1beta1_taxonomy_object
1364
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy::Representation
1365
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy
1366
+ command.params['parent'] = parent unless parent.nil?
1367
+ command.query['fields'] = fields unless fields.nil?
1368
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1369
+ execute_or_queue_command(command, &block)
1370
+ end
1371
+
1372
+ # Deletes a taxonomy. This operation will also delete all
1373
+ # policy tags in this taxonomy along with their associated policies.
1374
+ # @param [String] name
1375
+ # Required. Resource name of the taxonomy to be deleted. All policy tags in
1376
+ # this taxonomy will also be deleted.
1377
+ # @param [String] fields
1378
+ # Selector specifying which fields to include in a partial response.
1379
+ # @param [String] quota_user
1380
+ # Available to use for quota purposes for server-side applications. Can be any
1381
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1382
+ # @param [Google::Apis::RequestOptions] options
1383
+ # Request-specific options
1384
+ #
1385
+ # @yield [result, err] Result & error if block supplied
1386
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
1387
+ # @yieldparam err [StandardError] error object if request failed
1388
+ #
1389
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
1390
+ #
1391
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1392
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1393
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1394
+ def delete_project_location_taxonomy(name, fields: nil, quota_user: nil, options: nil, &block)
1395
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1396
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
1397
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
1398
+ command.params['name'] = name unless name.nil?
1399
+ command.query['fields'] = fields unless fields.nil?
1400
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1401
+ execute_or_queue_command(command, &block)
1402
+ end
1403
+
1404
+ # Exports all taxonomies and their policy tags in a project.
1405
+ # This method generates SerializedTaxonomy protos with nested policy tags
1406
+ # that can be used as an input for future ImportTaxonomies calls.
1407
+ # @param [String] parent
1408
+ # Required. Resource name of the project that taxonomies to be exported
1409
+ # will share.
1410
+ # @param [Boolean] serialized_taxonomies
1411
+ # Export taxonomies as serialized taxonomies.
1412
+ # @param [Array<String>, String] taxonomies
1413
+ # Required. Resource names of the taxonomies to be exported.
1414
+ # @param [String] fields
1415
+ # Selector specifying which fields to include in a partial response.
1416
+ # @param [String] quota_user
1417
+ # Available to use for quota purposes for server-side applications. Can be any
1418
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1419
+ # @param [Google::Apis::RequestOptions] options
1420
+ # Request-specific options
1421
+ #
1422
+ # @yield [result, err] Result & error if block supplied
1423
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ExportTaxonomiesResponse] parsed result object
1424
+ # @yieldparam err [StandardError] error object if request failed
1425
+ #
1426
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ExportTaxonomiesResponse]
1427
+ #
1428
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1429
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1430
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1431
+ def export_project_location_taxonomy(parent, serialized_taxonomies: nil, taxonomies: nil, fields: nil, quota_user: nil, options: nil, &block)
1432
+ command = make_simple_command(:get, 'v1beta1/{+parent}/taxonomies:export', options)
1433
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ExportTaxonomiesResponse::Representation
1434
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ExportTaxonomiesResponse
1435
+ command.params['parent'] = parent unless parent.nil?
1436
+ command.query['serializedTaxonomies'] = serialized_taxonomies unless serialized_taxonomies.nil?
1437
+ command.query['taxonomies'] = taxonomies unless taxonomies.nil?
1438
+ command.query['fields'] = fields unless fields.nil?
1439
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1440
+ execute_or_queue_command(command, &block)
1441
+ end
1442
+
1443
+ # Gets a taxonomy.
1444
+ # @param [String] name
1445
+ # Required. Resource name of the requested taxonomy.
1446
+ # @param [String] fields
1447
+ # Selector specifying which fields to include in a partial response.
1448
+ # @param [String] quota_user
1449
+ # Available to use for quota purposes for server-side applications. Can be any
1450
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1451
+ # @param [Google::Apis::RequestOptions] options
1452
+ # Request-specific options
1453
+ #
1454
+ # @yield [result, err] Result & error if block supplied
1455
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] parsed result object
1456
+ # @yieldparam err [StandardError] error object if request failed
1457
+ #
1458
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy]
1459
+ #
1460
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1461
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1462
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1463
+ def get_project_location_taxonomy(name, fields: nil, quota_user: nil, options: nil, &block)
1464
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1465
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy::Representation
1466
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy
1467
+ command.params['name'] = name unless name.nil?
1468
+ command.query['fields'] = fields unless fields.nil?
1469
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1470
+ execute_or_queue_command(command, &block)
1471
+ end
1472
+
1473
+ # Gets the IAM policy for a taxonomy or a policy tag.
1474
+ # @param [String] resource
1475
+ # REQUIRED: The resource for which the policy is being requested.
1476
+ # See the operation documentation for the appropriate value for this field.
1477
+ # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
1478
+ # @param [String] fields
1479
+ # Selector specifying which fields to include in a partial response.
1480
+ # @param [String] quota_user
1481
+ # Available to use for quota purposes for server-side applications. Can be any
1482
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1483
+ # @param [Google::Apis::RequestOptions] options
1484
+ # Request-specific options
1485
+ #
1486
+ # @yield [result, err] Result & error if block supplied
1487
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1488
+ # @yieldparam err [StandardError] error object if request failed
1489
+ #
1490
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1491
+ #
1492
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1493
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1494
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1495
+ def get_taxonomy_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1496
+ command = make_simple_command(:post, 'v1beta1/{+resource}:getIamPolicy', options)
1497
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest::Representation
1498
+ command.request_object = get_iam_policy_request_object
1499
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1500
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1501
+ command.params['resource'] = resource unless resource.nil?
1502
+ command.query['fields'] = fields unless fields.nil?
1503
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1504
+ execute_or_queue_command(command, &block)
1505
+ end
1506
+
1507
+ # Imports all taxonomies and their policy tags to a project as new
1508
+ # taxonomies.
1509
+ # This method provides a bulk taxonomy / policy tag creation using nested
1510
+ # proto structure.
1511
+ # @param [String] parent
1512
+ # Required. Resource name of project that the newly created taxonomies will
1513
+ # belong to.
1514
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesRequest] google_cloud_datacatalog_v1beta1_import_taxonomies_request_object
1515
+ # @param [String] fields
1516
+ # Selector specifying which fields to include in a partial response.
1517
+ # @param [String] quota_user
1518
+ # Available to use for quota purposes for server-side applications. Can be any
1519
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1520
+ # @param [Google::Apis::RequestOptions] options
1521
+ # Request-specific options
1522
+ #
1523
+ # @yield [result, err] Result & error if block supplied
1524
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesResponse] parsed result object
1525
+ # @yieldparam err [StandardError] error object if request failed
1526
+ #
1527
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesResponse]
1528
+ #
1529
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1530
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1531
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1532
+ def import_project_location_taxonomy(parent, google_cloud_datacatalog_v1beta1_import_taxonomies_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1533
+ command = make_simple_command(:post, 'v1beta1/{+parent}/taxonomies:import', options)
1534
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesRequest::Representation
1535
+ command.request_object = google_cloud_datacatalog_v1beta1_import_taxonomies_request_object
1536
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesResponse::Representation
1537
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesResponse
1538
+ command.params['parent'] = parent unless parent.nil?
1539
+ command.query['fields'] = fields unless fields.nil?
1540
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1541
+ execute_or_queue_command(command, &block)
1542
+ end
1543
+
1544
+ # Lists all taxonomies in a project in a particular location that the caller
1545
+ # has permission to view.
1546
+ # @param [String] parent
1547
+ # Required. Resource name of the project to list the taxonomies of.
1548
+ # @param [Fixnum] page_size
1549
+ # The maximum number of items to return. Must be a value between 1 and 1000.
1550
+ # If not set, defaults to 50.
1551
+ # @param [String] page_token
1552
+ # The next_page_token value returned from a previous list request, if any. If
1553
+ # not set, defaults to an empty string.
1554
+ # @param [String] fields
1555
+ # Selector specifying which fields to include in a partial response.
1556
+ # @param [String] quota_user
1557
+ # Available to use for quota purposes for server-side applications. Can be any
1558
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1559
+ # @param [Google::Apis::RequestOptions] options
1560
+ # Request-specific options
1561
+ #
1562
+ # @yield [result, err] Result & error if block supplied
1563
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTaxonomiesResponse] parsed result object
1564
+ # @yieldparam err [StandardError] error object if request failed
1565
+ #
1566
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTaxonomiesResponse]
1567
+ #
1568
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1569
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1570
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1571
+ def list_project_location_taxonomies(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1572
+ command = make_simple_command(:get, 'v1beta1/{+parent}/taxonomies', options)
1573
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTaxonomiesResponse::Representation
1574
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListTaxonomiesResponse
1575
+ command.params['parent'] = parent unless parent.nil?
1576
+ command.query['pageSize'] = page_size unless page_size.nil?
1577
+ command.query['pageToken'] = page_token unless page_token.nil?
1578
+ command.query['fields'] = fields unless fields.nil?
1579
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1580
+ execute_or_queue_command(command, &block)
1581
+ end
1582
+
1583
+ # Updates a taxonomy.
1584
+ # @param [String] name
1585
+ # Output only. Resource name of this taxonomy, whose format is:
1586
+ # "projects/`project_number`/locations/`location_id`/taxonomies/`id`".
1587
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] google_cloud_datacatalog_v1beta1_taxonomy_object
1588
+ # @param [String] update_mask
1589
+ # The update mask applies to the resource. For the `FieldMask` definition,
1590
+ # see
1591
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
1592
+ # fieldmask
1593
+ # If not set, defaults to all of the fields that are allowed to update.
1594
+ # @param [String] fields
1595
+ # Selector specifying which fields to include in a partial response.
1596
+ # @param [String] quota_user
1597
+ # Available to use for quota purposes for server-side applications. Can be any
1598
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1599
+ # @param [Google::Apis::RequestOptions] options
1600
+ # Request-specific options
1601
+ #
1602
+ # @yield [result, err] Result & error if block supplied
1603
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] parsed result object
1604
+ # @yieldparam err [StandardError] error object if request failed
1605
+ #
1606
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy]
1607
+ #
1608
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1609
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1610
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1611
+ def patch_project_location_taxonomy(name, google_cloud_datacatalog_v1beta1_taxonomy_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1612
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1613
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy::Representation
1614
+ command.request_object = google_cloud_datacatalog_v1beta1_taxonomy_object
1615
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy::Representation
1616
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy
1617
+ command.params['name'] = name unless name.nil?
1618
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1619
+ command.query['fields'] = fields unless fields.nil?
1620
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1621
+ execute_or_queue_command(command, &block)
1622
+ end
1623
+
1624
+ # Sets the IAM policy for a taxonomy or a policy tag.
1625
+ # @param [String] resource
1626
+ # REQUIRED: The resource for which the policy is being specified.
1627
+ # See the operation documentation for the appropriate value for this field.
1628
+ # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
1629
+ # @param [String] fields
1630
+ # Selector specifying which fields to include in a partial response.
1631
+ # @param [String] quota_user
1632
+ # Available to use for quota purposes for server-side applications. Can be any
1633
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1634
+ # @param [Google::Apis::RequestOptions] options
1635
+ # Request-specific options
1636
+ #
1637
+ # @yield [result, err] Result & error if block supplied
1638
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1639
+ # @yieldparam err [StandardError] error object if request failed
1640
+ #
1641
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1642
+ #
1643
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1644
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1645
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1646
+ def set_taxonomy_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1647
+ command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
1648
+ command.request_representation = Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest::Representation
1649
+ command.request_object = set_iam_policy_request_object
1650
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1651
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1652
+ command.params['resource'] = resource unless resource.nil?
1653
+ command.query['fields'] = fields unless fields.nil?
1654
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1655
+ execute_or_queue_command(command, &block)
1656
+ end
1657
+
1658
+ # Returns the permissions that a caller has on the specified taxonomy or
1659
+ # policy tag.
1660
+ # @param [String] resource
1661
+ # REQUIRED: The resource for which the policy detail is being requested.
1662
+ # See the operation documentation for the appropriate value for this field.
1663
+ # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
1664
+ # @param [String] fields
1665
+ # Selector specifying which fields to include in a partial response.
1666
+ # @param [String] quota_user
1667
+ # Available to use for quota purposes for server-side applications. Can be any
1668
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1669
+ # @param [Google::Apis::RequestOptions] options
1670
+ # Request-specific options
1671
+ #
1672
+ # @yield [result, err] Result & error if block supplied
1673
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse] parsed result object
1674
+ # @yieldparam err [StandardError] error object if request failed
1675
+ #
1676
+ # @return [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse]
1677
+ #
1678
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1679
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1680
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1681
+ def test_taxonomy_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1682
+ command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
1683
+ command.request_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest::Representation
1684
+ command.request_object = test_iam_permissions_request_object
1685
+ command.response_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse::Representation
1686
+ command.response_class = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse
1687
+ command.params['resource'] = resource unless resource.nil?
1688
+ command.query['fields'] = fields unless fields.nil?
1689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1690
+ execute_or_queue_command(command, &block)
1691
+ end
1692
+
1693
+ # Creates a policy tag in the specified taxonomy.
1694
+ # @param [String] parent
1695
+ # Required. Resource name of the taxonomy that the policy tag will belong to.
1696
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] google_cloud_datacatalog_v1beta1_policy_tag_object
1697
+ # @param [String] fields
1698
+ # Selector specifying which fields to include in a partial response.
1699
+ # @param [String] quota_user
1700
+ # Available to use for quota purposes for server-side applications. Can be any
1701
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1702
+ # @param [Google::Apis::RequestOptions] options
1703
+ # Request-specific options
1704
+ #
1705
+ # @yield [result, err] Result & error if block supplied
1706
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] parsed result object
1707
+ # @yieldparam err [StandardError] error object if request failed
1708
+ #
1709
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag]
1710
+ #
1711
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1712
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1713
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1714
+ def create_project_location_taxonomy_policy_tag(parent, google_cloud_datacatalog_v1beta1_policy_tag_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1715
+ command = make_simple_command(:post, 'v1beta1/{+parent}/policyTags', options)
1716
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag::Representation
1717
+ command.request_object = google_cloud_datacatalog_v1beta1_policy_tag_object
1718
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag::Representation
1719
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag
1720
+ command.params['parent'] = parent unless parent.nil?
1721
+ command.query['fields'] = fields unless fields.nil?
1722
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1723
+ execute_or_queue_command(command, &block)
1724
+ end
1725
+
1726
+ # Deletes a policy tag. Also deletes all of its descendant policy tags.
1727
+ # @param [String] name
1728
+ # Required. Resource name of the policy tag to be deleted. All of its descendant
1729
+ # policy tags will also be deleted.
1730
+ # @param [String] fields
1731
+ # Selector specifying which fields to include in a partial response.
1732
+ # @param [String] quota_user
1733
+ # Available to use for quota purposes for server-side applications. Can be any
1734
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1735
+ # @param [Google::Apis::RequestOptions] options
1736
+ # Request-specific options
1737
+ #
1738
+ # @yield [result, err] Result & error if block supplied
1739
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Empty] parsed result object
1740
+ # @yieldparam err [StandardError] error object if request failed
1741
+ #
1742
+ # @return [Google::Apis::DatacatalogV1beta1::Empty]
1743
+ #
1744
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1745
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1746
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1747
+ def delete_project_location_taxonomy_policy_tag(name, fields: nil, quota_user: nil, options: nil, &block)
1748
+ command = make_simple_command(:delete, 'v1beta1/{+name}', options)
1749
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Empty::Representation
1750
+ command.response_class = Google::Apis::DatacatalogV1beta1::Empty
1751
+ command.params['name'] = name unless name.nil?
1752
+ command.query['fields'] = fields unless fields.nil?
1753
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1754
+ execute_or_queue_command(command, &block)
1755
+ end
1756
+
1757
+ # Gets a policy tag.
1758
+ # @param [String] name
1759
+ # Required. Resource name of the requested policy tag.
1760
+ # @param [String] fields
1761
+ # Selector specifying which fields to include in a partial response.
1762
+ # @param [String] quota_user
1763
+ # Available to use for quota purposes for server-side applications. Can be any
1764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1765
+ # @param [Google::Apis::RequestOptions] options
1766
+ # Request-specific options
1767
+ #
1768
+ # @yield [result, err] Result & error if block supplied
1769
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] parsed result object
1770
+ # @yieldparam err [StandardError] error object if request failed
1771
+ #
1772
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag]
1773
+ #
1774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1777
+ def get_project_location_taxonomy_policy_tag(name, fields: nil, quota_user: nil, options: nil, &block)
1778
+ command = make_simple_command(:get, 'v1beta1/{+name}', options)
1779
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag::Representation
1780
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag
1781
+ command.params['name'] = name unless name.nil?
1782
+ command.query['fields'] = fields unless fields.nil?
1783
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1784
+ execute_or_queue_command(command, &block)
1785
+ end
1786
+
1787
+ # Gets the IAM policy for a taxonomy or a policy tag.
1788
+ # @param [String] resource
1789
+ # REQUIRED: The resource for which the policy is being requested.
1790
+ # See the operation documentation for the appropriate value for this field.
1791
+ # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
1792
+ # @param [String] fields
1793
+ # Selector specifying which fields to include in a partial response.
1794
+ # @param [String] quota_user
1795
+ # Available to use for quota purposes for server-side applications. Can be any
1796
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1797
+ # @param [Google::Apis::RequestOptions] options
1798
+ # Request-specific options
1799
+ #
1800
+ # @yield [result, err] Result & error if block supplied
1801
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1802
+ # @yieldparam err [StandardError] error object if request failed
1803
+ #
1804
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1805
+ #
1806
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1807
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1808
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1809
+ def get_policy_tag_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1810
+ command = make_simple_command(:post, 'v1beta1/{+resource}:getIamPolicy', options)
1811
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest::Representation
1812
+ command.request_object = get_iam_policy_request_object
1813
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1814
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1815
+ command.params['resource'] = resource unless resource.nil?
1816
+ command.query['fields'] = fields unless fields.nil?
1817
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1818
+ execute_or_queue_command(command, &block)
1819
+ end
1820
+
1821
+ # Lists all policy tags in a taxonomy.
1822
+ # @param [String] parent
1823
+ # Required. Resource name of the taxonomy to list the policy tags of.
1824
+ # @param [Fixnum] page_size
1825
+ # The maximum number of items to return. Must be a value between 1 and 1000.
1826
+ # If not set, defaults to 50.
1827
+ # @param [String] page_token
1828
+ # The next_page_token value returned from a previous List request, if any. If
1829
+ # not set, defaults to an empty string.
1830
+ # @param [String] fields
1831
+ # Selector specifying which fields to include in a partial response.
1832
+ # @param [String] quota_user
1833
+ # Available to use for quota purposes for server-side applications. Can be any
1834
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1835
+ # @param [Google::Apis::RequestOptions] options
1836
+ # Request-specific options
1837
+ #
1838
+ # @yield [result, err] Result & error if block supplied
1839
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListPolicyTagsResponse] parsed result object
1840
+ # @yieldparam err [StandardError] error object if request failed
1841
+ #
1842
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListPolicyTagsResponse]
1843
+ #
1844
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1845
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1846
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1847
+ def list_project_location_taxonomy_policy_tags(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1848
+ command = make_simple_command(:get, 'v1beta1/{+parent}/policyTags', options)
1849
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListPolicyTagsResponse::Representation
1850
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ListPolicyTagsResponse
1851
+ command.params['parent'] = parent unless parent.nil?
1852
+ command.query['pageSize'] = page_size unless page_size.nil?
1853
+ command.query['pageToken'] = page_token unless page_token.nil?
1854
+ command.query['fields'] = fields unless fields.nil?
1855
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1856
+ execute_or_queue_command(command, &block)
1857
+ end
1858
+
1859
+ # Updates a policy tag.
1860
+ # @param [String] name
1861
+ # Output only. Resource name of this policy tag, whose format is:
1862
+ # "projects/`project_number`/locations/`location_id`/taxonomies/`taxonomy_id`/
1863
+ # policyTags/`id`".
1864
+ # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] google_cloud_datacatalog_v1beta1_policy_tag_object
1865
+ # @param [String] update_mask
1866
+ # The update mask applies to the resource. Only display_name, description and
1867
+ # parent_policy_tag can be updated and thus can be listed in the mask. If
1868
+ # update_mask is not provided, all allowed fields (i.e. display_name,
1869
+ # description and parent) will be updated. For more information including the
1870
+ # `FieldMask` definition, see
1871
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
1872
+ # fieldmask
1873
+ # If not set, defaults to all of the fields that are allowed to update.
1874
+ # @param [String] fields
1875
+ # Selector specifying which fields to include in a partial response.
1876
+ # @param [String] quota_user
1877
+ # Available to use for quota purposes for server-side applications. Can be any
1878
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1879
+ # @param [Google::Apis::RequestOptions] options
1880
+ # Request-specific options
1881
+ #
1882
+ # @yield [result, err] Result & error if block supplied
1883
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] parsed result object
1884
+ # @yieldparam err [StandardError] error object if request failed
1885
+ #
1886
+ # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag]
1887
+ #
1888
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1889
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1890
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1891
+ def patch_project_location_taxonomy_policy_tag(name, google_cloud_datacatalog_v1beta1_policy_tag_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1892
+ command = make_simple_command(:patch, 'v1beta1/{+name}', options)
1893
+ command.request_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag::Representation
1894
+ command.request_object = google_cloud_datacatalog_v1beta1_policy_tag_object
1895
+ command.response_representation = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag::Representation
1896
+ command.response_class = Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag
1897
+ command.params['name'] = name unless name.nil?
1898
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1899
+ command.query['fields'] = fields unless fields.nil?
1900
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1901
+ execute_or_queue_command(command, &block)
1902
+ end
1903
+
1904
+ # Sets the IAM policy for a taxonomy or a policy tag.
1905
+ # @param [String] resource
1906
+ # REQUIRED: The resource for which the policy is being specified.
1907
+ # See the operation documentation for the appropriate value for this field.
1908
+ # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
1909
+ # @param [String] fields
1910
+ # Selector specifying which fields to include in a partial response.
1911
+ # @param [String] quota_user
1912
+ # Available to use for quota purposes for server-side applications. Can be any
1913
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1914
+ # @param [Google::Apis::RequestOptions] options
1915
+ # Request-specific options
1916
+ #
1917
+ # @yield [result, err] Result & error if block supplied
1918
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::Policy] parsed result object
1919
+ # @yieldparam err [StandardError] error object if request failed
1920
+ #
1921
+ # @return [Google::Apis::DatacatalogV1beta1::Policy]
1922
+ #
1923
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1924
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1925
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1926
+ def set_policy_tag_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1927
+ command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
1928
+ command.request_representation = Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest::Representation
1929
+ command.request_object = set_iam_policy_request_object
1930
+ command.response_representation = Google::Apis::DatacatalogV1beta1::Policy::Representation
1931
+ command.response_class = Google::Apis::DatacatalogV1beta1::Policy
1932
+ command.params['resource'] = resource unless resource.nil?
1933
+ command.query['fields'] = fields unless fields.nil?
1934
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1935
+ execute_or_queue_command(command, &block)
1936
+ end
1937
+
1938
+ # Returns the permissions that a caller has on the specified taxonomy or
1939
+ # policy tag.
1940
+ # @param [String] resource
1941
+ # REQUIRED: The resource for which the policy detail is being requested.
1942
+ # See the operation documentation for the appropriate value for this field.
1943
+ # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
1944
+ # @param [String] fields
1945
+ # Selector specifying which fields to include in a partial response.
1946
+ # @param [String] quota_user
1947
+ # Available to use for quota purposes for server-side applications. Can be any
1948
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1949
+ # @param [Google::Apis::RequestOptions] options
1950
+ # Request-specific options
1951
+ #
1952
+ # @yield [result, err] Result & error if block supplied
1953
+ # @yieldparam result [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse] parsed result object
1954
+ # @yieldparam err [StandardError] error object if request failed
1955
+ #
1956
+ # @return [Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse]
1957
+ #
1958
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1959
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1960
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1961
+ def test_policy_tag_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1962
+ command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
1963
+ command.request_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest::Representation
1964
+ command.request_object = test_iam_permissions_request_object
1965
+ command.response_representation = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse::Representation
1966
+ command.response_class = Google::Apis::DatacatalogV1beta1::TestIamPermissionsResponse
1967
+ command.params['resource'] = resource unless resource.nil?
1968
+ command.query['fields'] = fields unless fields.nil?
1969
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1970
+ execute_or_queue_command(command, &block)
1971
+ end
1972
+
1973
+ protected
1974
+
1975
+ def apply_command_defaults(command)
1976
+ command.query['key'] = key unless key.nil?
1977
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1978
+ end
1979
+ end
1980
+ end
1981
+ end
1982
+ end