google-api-client 0.34.1 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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