google-api-client 0.41.1 → 0.43.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (571) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +352 -0
  3. data/bin/generate-api +1 -3
  4. data/generated/google/apis/abusiveexperiencereport_v1.rb +1 -1
  5. data/generated/google/apis/abusiveexperiencereport_v1/classes.rb +8 -13
  6. data/generated/google/apis/abusiveexperiencereport_v1/service.rb +2 -3
  7. data/generated/google/apis/accessapproval_v1.rb +1 -1
  8. data/generated/google/apis/accessapproval_v1/classes.rb +9 -0
  9. data/generated/google/apis/accessapproval_v1/representations.rb +1 -0
  10. data/generated/google/apis/accessapproval_v1/service.rb +3 -0
  11. data/generated/google/apis/accessapproval_v1beta1.rb +1 -1
  12. data/generated/google/apis/accessapproval_v1beta1/service.rb +3 -0
  13. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  14. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +523 -653
  15. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +467 -631
  16. data/generated/google/apis/adexperiencereport_v1.rb +1 -1
  17. data/generated/google/apis/adexperiencereport_v1/classes.rb +11 -18
  18. data/generated/google/apis/adexperiencereport_v1/service.rb +2 -3
  19. data/generated/google/apis/admob_v1.rb +1 -1
  20. data/generated/google/apis/admob_v1/classes.rb +139 -268
  21. data/generated/google/apis/admob_v1/service.rb +11 -13
  22. data/generated/google/apis/alertcenter_v1beta1.rb +1 -1
  23. data/generated/google/apis/alertcenter_v1beta1/classes.rb +107 -138
  24. data/generated/google/apis/alertcenter_v1beta1/service.rb +50 -55
  25. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  26. data/generated/google/apis/analyticsreporting_v4/classes.rb +315 -399
  27. data/generated/google/apis/androiddeviceprovisioning_v1.rb +1 -1
  28. data/generated/google/apis/androiddeviceprovisioning_v1/classes.rb +199 -220
  29. data/generated/google/apis/androiddeviceprovisioning_v1/service.rb +55 -61
  30. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  31. data/generated/google/apis/androidenterprise_v1/classes.rb +452 -557
  32. data/generated/google/apis/androidenterprise_v1/service.rb +181 -240
  33. data/generated/google/apis/androidmanagement_v1.rb +1 -1
  34. data/generated/google/apis/androidpublisher_v3.rb +1 -1
  35. data/generated/google/apis/androidpublisher_v3/classes.rb +356 -339
  36. data/generated/google/apis/androidpublisher_v3/representations.rb +44 -0
  37. data/generated/google/apis/androidpublisher_v3/service.rb +272 -152
  38. data/generated/google/apis/apigee_v1.rb +6 -7
  39. data/generated/google/apis/apigee_v1/classes.rb +1898 -1067
  40. data/generated/google/apis/apigee_v1/representations.rb +542 -0
  41. data/generated/google/apis/apigee_v1/service.rb +1895 -1090
  42. data/generated/google/apis/appengine_v1.rb +1 -1
  43. data/generated/google/apis/appengine_v1/service.rb +6 -3
  44. data/generated/google/apis/appengine_v1beta.rb +1 -1
  45. data/generated/google/apis/appengine_v1beta/service.rb +6 -2
  46. data/generated/google/apis/appsmarket_v2.rb +1 -1
  47. data/generated/google/apis/artifactregistry_v1beta1.rb +1 -1
  48. data/generated/google/apis/bigquery_v2.rb +1 -1
  49. data/generated/google/apis/bigquery_v2/classes.rb +198 -3
  50. data/generated/google/apis/bigquery_v2/representations.rb +70 -0
  51. data/generated/google/apis/bigqueryreservation_v1.rb +1 -1
  52. data/generated/google/apis/bigqueryreservation_v1/classes.rb +34 -0
  53. data/generated/google/apis/bigqueryreservation_v1/representations.rb +16 -0
  54. data/generated/google/apis/bigqueryreservation_v1/service.rb +60 -0
  55. data/generated/google/apis/bigqueryreservation_v1beta1.rb +1 -1
  56. data/generated/google/apis/bigqueryreservation_v1beta1/classes.rb +8 -0
  57. data/generated/google/apis/bigqueryreservation_v1beta1/representations.rb +1 -0
  58. data/generated/google/apis/bigtableadmin_v1.rb +1 -1
  59. data/generated/google/apis/bigtableadmin_v1/classes.rb +267 -0
  60. data/generated/google/apis/bigtableadmin_v1/representations.rb +100 -0
  61. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  62. data/generated/google/apis/bigtableadmin_v2/classes.rb +361 -6
  63. data/generated/google/apis/bigtableadmin_v2/representations.rb +146 -0
  64. data/generated/google/apis/bigtableadmin_v2/service.rb +298 -0
  65. data/generated/google/apis/billingbudgets_v1beta1.rb +1 -1
  66. data/generated/google/apis/billingbudgets_v1beta1/classes.rb +103 -109
  67. data/generated/google/apis/billingbudgets_v1beta1/representations.rb +1 -0
  68. data/generated/google/apis/billingbudgets_v1beta1/service.rb +30 -33
  69. data/generated/google/apis/blogger_v2.rb +2 -3
  70. data/generated/google/apis/blogger_v2/classes.rb +1 -2
  71. data/generated/google/apis/blogger_v2/service.rb +1 -2
  72. data/generated/google/apis/blogger_v3.rb +2 -3
  73. data/generated/google/apis/blogger_v3/classes.rb +1 -2
  74. data/generated/google/apis/blogger_v3/service.rb +1 -2
  75. data/generated/google/apis/books_v1.rb +1 -1
  76. data/generated/google/apis/books_v1/classes.rb +140 -159
  77. data/generated/google/apis/books_v1/service.rb +47 -49
  78. data/generated/google/apis/chat_v1.rb +1 -1
  79. data/generated/google/apis/chat_v1/classes.rb +130 -0
  80. data/generated/google/apis/chat_v1/representations.rb +63 -0
  81. data/generated/google/apis/chat_v1/service.rb +71 -0
  82. data/generated/google/apis/chromeuxreport_v1.rb +1 -1
  83. data/generated/google/apis/chromeuxreport_v1/classes.rb +68 -57
  84. data/generated/google/apis/chromeuxreport_v1/representations.rb +2 -0
  85. data/generated/google/apis/civicinfo_v2.rb +1 -1
  86. data/generated/google/apis/civicinfo_v2/classes.rb +9 -1
  87. data/generated/google/apis/civicinfo_v2/representations.rb +1 -0
  88. data/generated/google/apis/civicinfo_v2/service.rb +1 -1
  89. data/generated/google/apis/classroom_v1.rb +1 -1
  90. data/generated/google/apis/classroom_v1/classes.rb +250 -365
  91. data/generated/google/apis/classroom_v1/service.rb +645 -900
  92. data/generated/google/apis/cloudasset_v1.rb +1 -1
  93. data/generated/google/apis/cloudasset_v1/classes.rb +15 -11
  94. data/generated/google/apis/cloudasset_v1/service.rb +62 -45
  95. data/generated/google/apis/cloudasset_v1beta1.rb +1 -1
  96. data/generated/google/apis/cloudasset_v1beta1/classes.rb +3 -1
  97. data/generated/google/apis/cloudasset_v1p4beta1.rb +1 -1
  98. data/generated/google/apis/{androidpublisher_v1_1.rb → cloudasset_v1p5beta1.rb} +11 -11
  99. data/generated/google/apis/cloudasset_v1p5beta1/classes.rb +1539 -0
  100. data/generated/google/apis/cloudasset_v1p5beta1/representations.rb +399 -0
  101. data/generated/google/apis/cloudasset_v1p5beta1/service.rb +129 -0
  102. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  103. data/generated/google/apis/cloudbuild_v1/classes.rb +272 -12
  104. data/generated/google/apis/cloudbuild_v1/representations.rb +130 -4
  105. data/generated/google/apis/cloudbuild_v1/service.rb +0 -94
  106. data/generated/google/apis/cloudbuild_v1alpha1.rb +1 -1
  107. data/generated/google/apis/cloudbuild_v1alpha1/classes.rb +284 -24
  108. data/generated/google/apis/cloudbuild_v1alpha1/representations.rb +135 -9
  109. data/generated/google/apis/cloudbuild_v1alpha1/service.rb +0 -47
  110. data/generated/google/apis/cloudbuild_v1alpha2.rb +1 -1
  111. data/generated/google/apis/cloudbuild_v1alpha2/classes.rb +284 -24
  112. data/generated/google/apis/cloudbuild_v1alpha2/representations.rb +135 -9
  113. data/generated/google/apis/cloudbuild_v1alpha2/service.rb +0 -47
  114. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  115. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +7 -0
  116. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +1 -0
  117. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  118. data/generated/google/apis/cloudfunctions_v1/classes.rb +12 -43
  119. data/generated/google/apis/cloudfunctions_v1/representations.rb +2 -17
  120. data/generated/google/apis/cloudidentity_v1beta1.rb +1 -1
  121. data/generated/google/apis/cloudidentity_v1beta1/classes.rb +32 -1
  122. data/generated/google/apis/cloudidentity_v1beta1/representations.rb +16 -0
  123. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  124. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +503 -754
  125. data/generated/google/apis/cloudresourcemanager_v1/service.rb +198 -249
  126. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  127. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +258 -429
  128. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +136 -178
  129. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  130. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +258 -414
  131. data/generated/google/apis/cloudresourcemanager_v2/service.rb +96 -129
  132. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  133. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +258 -414
  134. data/generated/google/apis/cloudresourcemanager_v2beta1/service.rb +96 -129
  135. data/generated/google/apis/cloudscheduler_v1.rb +1 -1
  136. data/generated/google/apis/cloudscheduler_v1/classes.rb +16 -5
  137. data/generated/google/apis/cloudscheduler_v1/representations.rb +1 -0
  138. data/generated/google/apis/cloudscheduler_v1beta1.rb +1 -1
  139. data/generated/google/apis/cloudscheduler_v1beta1/classes.rb +16 -5
  140. data/generated/google/apis/cloudscheduler_v1beta1/representations.rb +1 -0
  141. data/generated/google/apis/cloudsearch_v1.rb +1 -1
  142. data/generated/google/apis/cloudsearch_v1/classes.rb +1 -2
  143. data/generated/google/apis/cloudshell_v1.rb +1 -1
  144. data/generated/google/apis/cloudshell_v1/classes.rb +2 -2
  145. data/generated/google/apis/cloudshell_v1alpha1.rb +1 -1
  146. data/generated/google/apis/cloudshell_v1alpha1/classes.rb +8 -5
  147. data/generated/google/apis/cloudtrace_v1.rb +1 -1
  148. data/generated/google/apis/cloudtrace_v1/classes.rb +2 -3
  149. data/generated/google/apis/cloudtrace_v1/service.rb +1 -7
  150. data/generated/google/apis/cloudtrace_v2.rb +1 -1
  151. data/generated/google/apis/cloudtrace_v2/classes.rb +6 -5
  152. data/generated/google/apis/cloudtrace_v2/service.rb +3 -6
  153. data/generated/google/apis/compute_alpha.rb +1 -1
  154. data/generated/google/apis/compute_alpha/classes.rb +402 -48
  155. data/generated/google/apis/compute_alpha/representations.rb +103 -0
  156. data/generated/google/apis/compute_alpha/service.rb +38 -36
  157. data/generated/google/apis/compute_beta.rb +1 -1
  158. data/generated/google/apis/compute_beta/classes.rb +371 -41
  159. data/generated/google/apis/compute_beta/representations.rb +94 -0
  160. data/generated/google/apis/compute_beta/service.rb +347 -36
  161. data/generated/google/apis/compute_v1.rb +1 -1
  162. data/generated/google/apis/compute_v1/classes.rb +397 -40
  163. data/generated/google/apis/compute_v1/representations.rb +110 -0
  164. data/generated/google/apis/compute_v1/service.rb +341 -48
  165. data/generated/google/apis/container_v1.rb +1 -1
  166. data/generated/google/apis/container_v1/classes.rb +129 -2
  167. data/generated/google/apis/container_v1/representations.rb +51 -0
  168. data/generated/google/apis/container_v1beta1.rb +1 -1
  169. data/generated/google/apis/container_v1beta1/classes.rb +136 -17
  170. data/generated/google/apis/container_v1beta1/representations.rb +39 -0
  171. data/generated/google/apis/content_v2.rb +1 -1
  172. data/generated/google/apis/content_v2/classes.rb +17 -2
  173. data/generated/google/apis/content_v2/representations.rb +1 -0
  174. data/generated/google/apis/content_v2_1.rb +1 -1
  175. data/generated/google/apis/content_v2_1/classes.rb +19 -4
  176. data/generated/google/apis/content_v2_1/representations.rb +1 -0
  177. data/generated/google/apis/{androidpublisher_v1.rb → customsearch_v1.rb} +8 -8
  178. data/generated/google/apis/customsearch_v1/classes.rb +1421 -0
  179. data/generated/google/apis/customsearch_v1/representations.rb +372 -0
  180. data/generated/google/apis/customsearch_v1/service.rb +461 -0
  181. data/generated/google/apis/datacatalog_v1beta1.rb +1 -1
  182. data/generated/google/apis/datacatalog_v1beta1/classes.rb +6 -3
  183. data/generated/google/apis/dataflow_v1b3.rb +1 -1
  184. data/generated/google/apis/dataflow_v1b3/classes.rb +21 -1
  185. data/generated/google/apis/dataflow_v1b3/representations.rb +3 -0
  186. data/generated/google/apis/dataflow_v1b3/service.rb +2 -2
  187. data/generated/google/apis/datafusion_v1.rb +43 -0
  188. data/generated/google/apis/datafusion_v1/classes.rb +1154 -0
  189. data/generated/google/apis/{cloudfunctions_v1beta2 → datafusion_v1}/representations.rb +138 -93
  190. data/generated/google/apis/datafusion_v1/service.rb +680 -0
  191. data/generated/google/apis/dataproc_v1.rb +1 -1
  192. data/generated/google/apis/dataproc_v1/classes.rb +207 -330
  193. data/generated/google/apis/dataproc_v1/service.rb +134 -168
  194. data/generated/google/apis/dataproc_v1beta2.rb +1 -1
  195. data/generated/google/apis/dataproc_v1beta2/classes.rb +236 -325
  196. data/generated/google/apis/dataproc_v1beta2/representations.rb +4 -0
  197. data/generated/google/apis/dataproc_v1beta2/service.rb +137 -192
  198. data/generated/google/apis/datastore_v1.rb +1 -1
  199. data/generated/google/apis/datastore_v1/classes.rb +1 -1
  200. data/generated/google/apis/deploymentmanager_alpha.rb +1 -1
  201. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  202. data/generated/google/apis/deploymentmanager_v2beta.rb +1 -1
  203. data/generated/google/apis/dfareporting_v3_4.rb +1 -1
  204. data/generated/google/apis/dfareporting_v3_4/classes.rb +421 -0
  205. data/generated/google/apis/dfareporting_v3_4/representations.rb +182 -0
  206. data/generated/google/apis/dialogflow_v2.rb +1 -1
  207. data/generated/google/apis/dialogflow_v2/classes.rb +1341 -1513
  208. data/generated/google/apis/dialogflow_v2/representations.rb +31 -0
  209. data/generated/google/apis/dialogflow_v2/service.rb +324 -444
  210. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  211. data/generated/google/apis/dialogflow_v2beta1/classes.rb +1419 -1591
  212. data/generated/google/apis/dialogflow_v2beta1/representations.rb +31 -0
  213. data/generated/google/apis/dialogflow_v2beta1/service.rb +780 -1022
  214. data/generated/google/apis/displayvideo_v1.rb +7 -1
  215. data/generated/google/apis/displayvideo_v1/classes.rb +1776 -1728
  216. data/generated/google/apis/displayvideo_v1/representations.rb +300 -0
  217. data/generated/google/apis/displayvideo_v1/service.rb +1277 -929
  218. data/generated/google/apis/dlp_v2.rb +1 -1
  219. data/generated/google/apis/dlp_v2/classes.rb +10 -6
  220. data/generated/google/apis/dns_v1.rb +4 -4
  221. data/generated/google/apis/dns_v1/classes.rb +313 -162
  222. data/generated/google/apis/dns_v1/service.rb +247 -180
  223. data/generated/google/apis/dns_v1beta2.rb +4 -4
  224. data/generated/google/apis/dns_v1beta2/classes.rb +325 -171
  225. data/generated/google/apis/dns_v1beta2/service.rb +247 -180
  226. data/generated/google/apis/dns_v2beta1.rb +4 -4
  227. data/generated/google/apis/dns_v2beta1/classes.rb +313 -162
  228. data/generated/google/apis/dns_v2beta1/service.rb +247 -180
  229. data/generated/google/apis/domainsrdap_v1.rb +1 -1
  230. data/generated/google/apis/domainsrdap_v1/classes.rb +42 -69
  231. data/generated/google/apis/domainsrdap_v1/service.rb +16 -16
  232. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  233. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +1 -1
  234. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +4 -2
  235. data/generated/google/apis/doubleclickbidmanager_v1_1.rb +1 -1
  236. data/generated/google/apis/doubleclickbidmanager_v1_1/classes.rb +196 -1
  237. data/generated/google/apis/doubleclickbidmanager_v1_1/representations.rb +107 -0
  238. data/generated/google/apis/doubleclickbidmanager_v1_1/service.rb +4 -2
  239. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  240. data/generated/google/apis/doubleclicksearch_v2/classes.rb +109 -126
  241. data/generated/google/apis/doubleclicksearch_v2/service.rb +3 -4
  242. data/generated/google/apis/drive_v2.rb +1 -1
  243. data/generated/google/apis/drive_v2/classes.rb +77 -2
  244. data/generated/google/apis/drive_v2/representations.rb +23 -0
  245. data/generated/google/apis/drive_v2/service.rb +23 -10
  246. data/generated/google/apis/drive_v3.rb +1 -1
  247. data/generated/google/apis/drive_v3/classes.rb +82 -2
  248. data/generated/google/apis/drive_v3/representations.rb +24 -0
  249. data/generated/google/apis/drive_v3/service.rb +8 -5
  250. data/generated/google/apis/driveactivity_v2.rb +1 -1
  251. data/generated/google/apis/driveactivity_v2/classes.rb +55 -68
  252. data/generated/google/apis/factchecktools_v1alpha1.rb +1 -1
  253. data/generated/google/apis/factchecktools_v1alpha1/classes.rb +46 -56
  254. data/generated/google/apis/factchecktools_v1alpha1/service.rb +30 -33
  255. data/generated/google/apis/fcm_v1.rb +1 -1
  256. data/generated/google/apis/fcm_v1/classes.rb +245 -393
  257. data/generated/google/apis/fcm_v1/service.rb +5 -6
  258. data/generated/google/apis/file_v1.rb +1 -1
  259. data/generated/google/apis/file_v1beta1.rb +1 -1
  260. data/generated/google/apis/firebase_v1beta1.rb +1 -1
  261. data/generated/google/apis/firebase_v1beta1/classes.rb +313 -351
  262. data/generated/google/apis/firebase_v1beta1/representations.rb +1 -0
  263. data/generated/google/apis/firebase_v1beta1/service.rb +356 -420
  264. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  265. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +89 -112
  266. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +18 -21
  267. data/generated/google/apis/{androidpublisher_v2.rb → firebasehosting_v1.rb} +11 -12
  268. data/generated/google/apis/firebasehosting_v1/classes.rb +182 -0
  269. data/generated/google/apis/{androidpublisher_v2 → firebasehosting_v1}/representations.rb +22 -32
  270. data/generated/google/apis/firebasehosting_v1/service.rb +180 -0
  271. data/generated/google/apis/firebasehosting_v1beta1.rb +1 -1
  272. data/generated/google/apis/firebasehosting_v1beta1/classes.rb +148 -177
  273. data/generated/google/apis/firebasehosting_v1beta1/service.rb +112 -143
  274. data/generated/google/apis/firebaseml_v1.rb +1 -1
  275. data/generated/google/apis/firebaseml_v1/classes.rb +39 -44
  276. data/generated/google/apis/firebaseml_v1/service.rb +19 -22
  277. data/generated/google/apis/firebaseml_v1beta2.rb +1 -1
  278. data/generated/google/apis/firebaseml_v1beta2/classes.rb +67 -68
  279. data/generated/google/apis/firebaseml_v1beta2/representations.rb +1 -0
  280. data/generated/google/apis/firebaseml_v1beta2/service.rb +16 -18
  281. data/generated/google/apis/firestore_v1.rb +1 -1
  282. data/generated/google/apis/firestore_v1/classes.rb +152 -0
  283. data/generated/google/apis/firestore_v1/representations.rb +63 -0
  284. data/generated/google/apis/firestore_v1/service.rb +78 -0
  285. data/generated/google/apis/firestore_v1beta1.rb +1 -1
  286. data/generated/google/apis/firestore_v1beta1/classes.rb +152 -0
  287. data/generated/google/apis/firestore_v1beta1/representations.rb +63 -0
  288. data/generated/google/apis/firestore_v1beta1/service.rb +78 -0
  289. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  290. data/generated/google/apis/games_configuration_v1configuration/service.rb +2 -2
  291. data/generated/google/apis/games_management_v1management.rb +1 -1
  292. data/generated/google/apis/games_management_v1management/service.rb +2 -2
  293. data/generated/google/apis/games_v1.rb +6 -4
  294. data/generated/google/apis/games_v1/classes.rb +354 -2112
  295. data/generated/google/apis/games_v1/representations.rb +12 -647
  296. data/generated/google/apis/games_v1/service.rb +213 -1155
  297. data/generated/google/apis/{cloudfunctions_v1beta2.rb → gameservices_v1.rb} +9 -9
  298. data/generated/google/apis/gameservices_v1/classes.rb +2175 -0
  299. data/generated/google/apis/gameservices_v1/representations.rb +971 -0
  300. data/generated/google/apis/gameservices_v1/service.rb +1432 -0
  301. data/generated/google/apis/gameservices_v1beta.rb +1 -1
  302. data/generated/google/apis/gameservices_v1beta/classes.rb +344 -523
  303. data/generated/google/apis/gameservices_v1beta/service.rb +167 -207
  304. data/generated/google/apis/genomics_v1.rb +1 -1
  305. data/generated/google/apis/genomics_v1alpha2.rb +1 -1
  306. data/generated/google/apis/genomics_v2alpha1.rb +1 -1
  307. data/generated/google/apis/genomics_v2alpha1/classes.rb +3 -75
  308. data/generated/google/apis/genomics_v2alpha1/representations.rb +0 -27
  309. data/generated/google/apis/genomics_v2alpha1/service.rb +0 -34
  310. data/generated/google/apis/gmail_v1.rb +3 -3
  311. data/generated/google/apis/gmail_v1/classes.rb +216 -269
  312. data/generated/google/apis/gmail_v1/service.rb +260 -288
  313. data/generated/google/apis/gmailpostmastertools_v1beta1.rb +36 -0
  314. data/generated/google/apis/gmailpostmastertools_v1beta1/classes.rb +301 -0
  315. data/generated/google/apis/gmailpostmastertools_v1beta1/representations.rb +141 -0
  316. data/generated/google/apis/gmailpostmastertools_v1beta1/service.rb +230 -0
  317. data/generated/google/apis/groupssettings_v1.rb +1 -1
  318. data/generated/google/apis/groupssettings_v1/classes.rb +1 -1
  319. data/generated/google/apis/healthcare_v1.rb +1 -1
  320. data/generated/google/apis/healthcare_v1/service.rb +72 -13
  321. data/generated/google/apis/healthcare_v1beta1.rb +1 -1
  322. data/generated/google/apis/healthcare_v1beta1/classes.rb +85 -17
  323. data/generated/google/apis/healthcare_v1beta1/representations.rb +39 -0
  324. data/generated/google/apis/healthcare_v1beta1/service.rb +146 -16
  325. data/generated/google/apis/iam_v1.rb +1 -1
  326. data/generated/google/apis/iam_v1/classes.rb +22 -3
  327. data/generated/google/apis/iam_v1/service.rb +18 -6
  328. data/generated/google/apis/language_v1.rb +1 -1
  329. data/generated/google/apis/language_v1/classes.rb +93 -111
  330. data/generated/google/apis/language_v1/service.rb +4 -4
  331. data/generated/google/apis/language_v1beta1.rb +1 -1
  332. data/generated/google/apis/language_v1beta1/classes.rb +78 -90
  333. data/generated/google/apis/language_v1beta1/service.rb +2 -2
  334. data/generated/google/apis/language_v1beta2.rb +1 -1
  335. data/generated/google/apis/language_v1beta2/classes.rb +95 -112
  336. data/generated/google/apis/language_v1beta2/service.rb +4 -4
  337. data/generated/google/apis/libraryagent_v1.rb +1 -1
  338. data/generated/google/apis/libraryagent_v1/classes.rb +10 -16
  339. data/generated/google/apis/libraryagent_v1/service.rb +13 -16
  340. data/generated/google/apis/logging_v2.rb +1 -1
  341. data/generated/google/apis/logging_v2/classes.rb +6 -6
  342. data/generated/google/apis/managedidentities_v1.rb +1 -1
  343. data/generated/google/apis/managedidentities_v1/classes.rb +355 -437
  344. data/generated/google/apis/managedidentities_v1/representations.rb +15 -0
  345. data/generated/google/apis/managedidentities_v1/service.rb +78 -96
  346. data/generated/google/apis/managedidentities_v1alpha1.rb +1 -1
  347. data/generated/google/apis/managedidentities_v1alpha1/classes.rb +365 -442
  348. data/generated/google/apis/managedidentities_v1alpha1/representations.rb +15 -0
  349. data/generated/google/apis/managedidentities_v1alpha1/service.rb +88 -109
  350. data/generated/google/apis/managedidentities_v1beta1.rb +1 -1
  351. data/generated/google/apis/managedidentities_v1beta1/classes.rb +361 -441
  352. data/generated/google/apis/managedidentities_v1beta1/representations.rb +15 -0
  353. data/generated/google/apis/managedidentities_v1beta1/service.rb +76 -93
  354. data/generated/google/apis/{groupsmigration_v1.rb → memcache_v1.rb} +11 -11
  355. data/generated/google/apis/memcache_v1/classes.rb +1157 -0
  356. data/generated/google/apis/memcache_v1/representations.rb +471 -0
  357. data/generated/google/apis/{cloudfunctions_v1beta2 → memcache_v1}/service.rb +268 -196
  358. data/generated/google/apis/memcache_v1beta2.rb +1 -1
  359. data/generated/google/apis/memcache_v1beta2/classes.rb +42 -503
  360. data/generated/google/apis/memcache_v1beta2/representations.rb +9 -110
  361. data/generated/google/apis/memcache_v1beta2/service.rb +0 -119
  362. data/generated/google/apis/ml_v1.rb +1 -1
  363. data/generated/google/apis/ml_v1/classes.rb +23 -17
  364. data/generated/google/apis/monitoring_v1.rb +1 -1
  365. data/generated/google/apis/monitoring_v1/classes.rb +14 -12
  366. data/generated/google/apis/monitoring_v3.rb +1 -1
  367. data/generated/google/apis/monitoring_v3/classes.rb +97 -47
  368. data/generated/google/apis/monitoring_v3/representations.rb +3 -0
  369. data/generated/google/apis/monitoring_v3/service.rb +13 -9
  370. data/generated/google/apis/networkmanagement_v1.rb +1 -1
  371. data/generated/google/apis/networkmanagement_v1/classes.rb +6 -6
  372. data/generated/google/apis/networkmanagement_v1beta1.rb +1 -1
  373. data/generated/google/apis/networkmanagement_v1beta1/classes.rb +6 -6
  374. data/generated/google/apis/osconfig_v1.rb +1 -1
  375. data/generated/google/apis/osconfig_v1/classes.rb +798 -2
  376. data/generated/google/apis/osconfig_v1/representations.rb +372 -0
  377. data/generated/google/apis/osconfig_v1beta.rb +1 -1
  378. data/generated/google/apis/osconfig_v1beta/classes.rb +77 -2
  379. data/generated/google/apis/osconfig_v1beta/representations.rb +35 -0
  380. data/generated/google/apis/pagespeedonline_v5.rb +1 -1
  381. data/generated/google/apis/people_v1.rb +1 -1
  382. data/generated/google/apis/people_v1/classes.rb +382 -401
  383. data/generated/google/apis/people_v1/representations.rb +57 -0
  384. data/generated/google/apis/people_v1/service.rb +169 -385
  385. data/generated/google/apis/playcustomapp_v1.rb +1 -1
  386. data/generated/google/apis/playcustomapp_v1/classes.rb +2 -2
  387. data/generated/google/apis/policytroubleshooter_v1.rb +1 -1
  388. data/generated/google/apis/policytroubleshooter_v1/classes.rb +232 -394
  389. data/generated/google/apis/policytroubleshooter_v1/service.rb +2 -2
  390. data/generated/google/apis/policytroubleshooter_v1beta.rb +1 -1
  391. data/generated/google/apis/policytroubleshooter_v1beta/classes.rb +232 -393
  392. data/generated/google/apis/policytroubleshooter_v1beta/service.rb +2 -2
  393. data/generated/google/apis/prod_tt_sasportal_v1alpha1.rb +1 -1
  394. data/generated/google/apis/prod_tt_sasportal_v1alpha1/classes.rb +122 -146
  395. data/generated/google/apis/prod_tt_sasportal_v1alpha1/service.rb +38 -49
  396. data/generated/google/apis/pubsub_v1.rb +1 -1
  397. data/generated/google/apis/pubsub_v1/classes.rb +45 -28
  398. data/generated/google/apis/pubsub_v1/representations.rb +2 -0
  399. data/generated/google/apis/pubsub_v1/service.rb +35 -44
  400. data/generated/google/apis/realtimebidding_v1.rb +1 -4
  401. data/generated/google/apis/realtimebidding_v1/classes.rb +198 -291
  402. data/generated/google/apis/realtimebidding_v1/service.rb +98 -135
  403. data/generated/google/apis/recommendationengine_v1beta1.rb +36 -0
  404. data/generated/google/apis/recommendationengine_v1beta1/classes.rb +2017 -0
  405. data/generated/google/apis/recommendationengine_v1beta1/representations.rb +848 -0
  406. data/generated/google/apis/recommendationengine_v1beta1/service.rb +990 -0
  407. data/generated/google/apis/recommender_v1.rb +1 -1
  408. data/generated/google/apis/recommender_v1/classes.rb +271 -84
  409. data/generated/google/apis/recommender_v1/representations.rb +96 -0
  410. data/generated/google/apis/recommender_v1/service.rb +143 -35
  411. data/generated/google/apis/recommender_v1beta1.rb +1 -1
  412. data/generated/google/apis/recommender_v1beta1/classes.rb +75 -99
  413. data/generated/google/apis/recommender_v1beta1/service.rb +43 -58
  414. data/generated/google/apis/redis_v1.rb +1 -1
  415. data/generated/google/apis/redis_v1/classes.rb +397 -0
  416. data/generated/google/apis/redis_v1/representations.rb +139 -0
  417. data/generated/google/apis/redis_v1beta1.rb +1 -1
  418. data/generated/google/apis/redis_v1beta1/classes.rb +397 -0
  419. data/generated/google/apis/redis_v1beta1/representations.rb +139 -0
  420. data/generated/google/apis/remotebuildexecution_v1.rb +1 -1
  421. data/generated/google/apis/remotebuildexecution_v1alpha.rb +1 -1
  422. data/generated/google/apis/remotebuildexecution_v2.rb +1 -1
  423. data/generated/google/apis/reseller_v1.rb +4 -3
  424. data/generated/google/apis/reseller_v1/classes.rb +219 -160
  425. data/generated/google/apis/reseller_v1/service.rb +247 -252
  426. data/generated/google/apis/run_v1.rb +1 -1
  427. data/generated/google/apis/run_v1/classes.rb +835 -1248
  428. data/generated/google/apis/run_v1/service.rb +233 -247
  429. data/generated/google/apis/run_v1alpha1.rb +1 -1
  430. data/generated/google/apis/run_v1alpha1/classes.rb +934 -1331
  431. data/generated/google/apis/run_v1alpha1/service.rb +321 -377
  432. data/generated/google/apis/run_v1beta1.rb +1 -1
  433. data/generated/google/apis/run_v1beta1/classes.rb +209 -276
  434. data/generated/google/apis/run_v1beta1/service.rb +16 -18
  435. data/generated/google/apis/runtimeconfig_v1.rb +1 -1
  436. data/generated/google/apis/runtimeconfig_v1/classes.rb +36 -40
  437. data/generated/google/apis/runtimeconfig_v1/service.rb +19 -22
  438. data/generated/google/apis/sasportal_v1alpha1.rb +1 -1
  439. data/generated/google/apis/sasportal_v1alpha1/classes.rb +122 -146
  440. data/generated/google/apis/sasportal_v1alpha1/service.rb +38 -49
  441. data/generated/google/apis/searchconsole_v1.rb +4 -3
  442. data/generated/google/apis/searchconsole_v1/classes.rb +2 -2
  443. data/generated/google/apis/searchconsole_v1/service.rb +3 -2
  444. data/generated/google/apis/securitycenter_v1.rb +1 -1
  445. data/generated/google/apis/securitycenter_v1/classes.rb +574 -826
  446. data/generated/google/apis/securitycenter_v1/service.rb +250 -332
  447. data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
  448. data/generated/google/apis/securitycenter_v1beta1/classes.rb +521 -746
  449. data/generated/google/apis/securitycenter_v1beta1/service.rb +160 -202
  450. data/generated/google/apis/securitycenter_v1p1alpha1.rb +1 -1
  451. data/generated/google/apis/securitycenter_v1p1alpha1/classes.rb +176 -208
  452. data/generated/google/apis/securitycenter_v1p1alpha1/service.rb +21 -25
  453. data/generated/google/apis/securitycenter_v1p1beta1.rb +1 -1
  454. data/generated/google/apis/securitycenter_v1p1beta1/classes.rb +545 -791
  455. data/generated/google/apis/securitycenter_v1p1beta1/service.rb +247 -330
  456. data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
  457. data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +1150 -1784
  458. data/generated/google/apis/serviceconsumermanagement_v1/service.rb +114 -141
  459. data/generated/google/apis/serviceconsumermanagement_v1beta1.rb +1 -1
  460. data/generated/google/apis/serviceconsumermanagement_v1beta1/classes.rb +1137 -1774
  461. data/generated/google/apis/serviceconsumermanagement_v1beta1/service.rb +52 -66
  462. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  463. data/generated/google/apis/servicecontrol_v1/classes.rb +6 -6
  464. data/generated/google/apis/servicecontrol_v2.rb +38 -0
  465. data/generated/google/apis/servicecontrol_v2/classes.rb +1121 -0
  466. data/generated/google/apis/servicecontrol_v2/representations.rb +405 -0
  467. data/generated/google/apis/servicecontrol_v2/service.rb +165 -0
  468. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  469. data/generated/google/apis/servicemanagement_v1/classes.rb +50 -2
  470. data/generated/google/apis/servicemanagement_v1/representations.rb +14 -0
  471. data/generated/google/apis/servicenetworking_v1.rb +1 -1
  472. data/generated/google/apis/servicenetworking_v1/classes.rb +1119 -1758
  473. data/generated/google/apis/servicenetworking_v1/service.rb +94 -114
  474. data/generated/google/apis/servicenetworking_v1beta.rb +1 -1
  475. data/generated/google/apis/servicenetworking_v1beta/classes.rb +1065 -1684
  476. data/generated/google/apis/servicenetworking_v1beta/service.rb +52 -63
  477. data/generated/google/apis/serviceusage_v1.rb +1 -1
  478. data/generated/google/apis/serviceusage_v1/classes.rb +1140 -1823
  479. data/generated/google/apis/serviceusage_v1/service.rb +63 -80
  480. data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
  481. data/generated/google/apis/serviceusage_v1beta1/classes.rb +1235 -1986
  482. data/generated/google/apis/serviceusage_v1beta1/service.rb +130 -162
  483. data/generated/google/apis/sheets_v4.rb +1 -1
  484. data/generated/google/apis/sheets_v4/classes.rb +28 -28
  485. data/generated/google/apis/spanner_v1.rb +1 -1
  486. data/generated/google/apis/spanner_v1/classes.rb +3 -2
  487. data/generated/google/apis/spanner_v1/service.rb +5 -0
  488. data/generated/google/apis/sql_v1beta4.rb +1 -1
  489. data/generated/google/apis/sql_v1beta4/classes.rb +207 -200
  490. data/generated/google/apis/sql_v1beta4/representations.rb +2 -1
  491. data/generated/google/apis/sql_v1beta4/service.rb +2 -2
  492. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  493. data/generated/google/apis/storagetransfer_v1/classes.rb +8 -10
  494. data/generated/google/apis/storagetransfer_v1/service.rb +26 -2
  495. data/generated/google/apis/tagmanager_v1.rb +2 -3
  496. data/generated/google/apis/tagmanager_v1/classes.rb +225 -288
  497. data/generated/google/apis/tagmanager_v1/service.rb +20 -21
  498. data/generated/google/apis/tagmanager_v2.rb +2 -3
  499. data/generated/google/apis/tagmanager_v2/classes.rb +240 -280
  500. data/generated/google/apis/tagmanager_v2/representations.rb +1 -0
  501. data/generated/google/apis/tagmanager_v2/service.rb +187 -283
  502. data/generated/google/apis/testing_v1.rb +1 -1
  503. data/generated/google/apis/testing_v1/classes.rb +80 -6
  504. data/generated/google/apis/testing_v1/representations.rb +33 -0
  505. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  506. data/generated/google/apis/toolresults_v1beta3/classes.rb +671 -928
  507. data/generated/google/apis/toolresults_v1beta3/representations.rb +1 -0
  508. data/generated/google/apis/toolresults_v1beta3/service.rb +522 -640
  509. data/generated/google/apis/tpu_v1.rb +1 -1
  510. data/generated/google/apis/tpu_v1/classes.rb +68 -78
  511. data/generated/google/apis/tpu_v1/service.rb +21 -25
  512. data/generated/google/apis/tpu_v1alpha1.rb +1 -1
  513. data/generated/google/apis/tpu_v1alpha1/classes.rb +68 -78
  514. data/generated/google/apis/tpu_v1alpha1/service.rb +21 -25
  515. data/generated/google/apis/translate_v3.rb +1 -1
  516. data/generated/google/apis/translate_v3/service.rb +14 -1
  517. data/generated/google/apis/translate_v3beta1.rb +1 -1
  518. data/generated/google/apis/translate_v3beta1/service.rb +14 -1
  519. data/generated/google/apis/vision_v1.rb +1 -1
  520. data/generated/google/apis/vision_v1/classes.rb +1304 -1868
  521. data/generated/google/apis/vision_v1/service.rb +254 -340
  522. data/generated/google/apis/vision_v1p1beta1.rb +1 -1
  523. data/generated/google/apis/vision_v1p1beta1/classes.rb +1246 -1788
  524. data/generated/google/apis/vision_v1p1beta1/service.rb +91 -121
  525. data/generated/google/apis/vision_v1p2beta1.rb +1 -1
  526. data/generated/google/apis/vision_v1p2beta1/classes.rb +1246 -1788
  527. data/generated/google/apis/vision_v1p2beta1/service.rb +91 -121
  528. data/generated/google/apis/webfonts_v1.rb +1 -1
  529. data/generated/google/apis/webfonts_v1/service.rb +2 -2
  530. data/generated/google/apis/websecurityscanner_v1.rb +1 -1
  531. data/generated/google/apis/websecurityscanner_v1/classes.rb +71 -95
  532. data/generated/google/apis/websecurityscanner_v1/service.rb +46 -65
  533. data/generated/google/apis/websecurityscanner_v1alpha.rb +1 -1
  534. data/generated/google/apis/websecurityscanner_v1alpha/classes.rb +55 -63
  535. data/generated/google/apis/websecurityscanner_v1alpha/service.rb +46 -65
  536. data/generated/google/apis/websecurityscanner_v1beta.rb +1 -1
  537. data/generated/google/apis/websecurityscanner_v1beta/classes.rb +77 -92
  538. data/generated/google/apis/websecurityscanner_v1beta/service.rb +46 -65
  539. data/generated/google/apis/youtube_analytics_v2.rb +1 -1
  540. data/generated/google/apis/youtube_analytics_v2/classes.rb +77 -104
  541. data/generated/google/apis/youtube_analytics_v2/service.rb +106 -126
  542. data/generated/google/apis/youtube_partner_v1.rb +4 -3
  543. data/generated/google/apis/youtube_partner_v1/classes.rb +1106 -690
  544. data/generated/google/apis/youtube_partner_v1/representations.rb +357 -256
  545. data/generated/google/apis/youtube_partner_v1/service.rb +519 -1079
  546. data/generated/google/apis/youtube_v3.rb +1 -1
  547. data/generated/google/apis/youtube_v3/classes.rb +1456 -1134
  548. data/generated/google/apis/youtube_v3/representations.rb +282 -0
  549. data/generated/google/apis/youtube_v3/service.rb +1225 -1274
  550. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  551. data/generated/google/apis/youtubereporting_v1/classes.rb +20 -29
  552. data/generated/google/apis/youtubereporting_v1/service.rb +40 -43
  553. data/lib/google/apis/core/base_service.rb +7 -1
  554. data/lib/google/apis/version.rb +1 -1
  555. metadata +39 -27
  556. data/generated/google/apis/androidpublisher_v1/classes.rb +0 -26
  557. data/generated/google/apis/androidpublisher_v1/representations.rb +0 -26
  558. data/generated/google/apis/androidpublisher_v1/service.rb +0 -64
  559. data/generated/google/apis/androidpublisher_v1_1/classes.rb +0 -94
  560. data/generated/google/apis/androidpublisher_v1_1/representations.rb +0 -45
  561. data/generated/google/apis/androidpublisher_v1_1/service.rb +0 -104
  562. data/generated/google/apis/androidpublisher_v2/classes.rb +0 -223
  563. data/generated/google/apis/androidpublisher_v2/service.rb +0 -160
  564. data/generated/google/apis/cloudfunctions_v1beta2/classes.rb +0 -841
  565. data/generated/google/apis/fitness_v1.rb +0 -85
  566. data/generated/google/apis/fitness_v1/classes.rb +0 -1020
  567. data/generated/google/apis/fitness_v1/representations.rb +0 -398
  568. data/generated/google/apis/fitness_v1/service.rb +0 -647
  569. data/generated/google/apis/groupsmigration_v1/classes.rb +0 -51
  570. data/generated/google/apis/groupsmigration_v1/representations.rb +0 -40
  571. data/generated/google/apis/groupsmigration_v1/service.rb +0 -100
@@ -27,7 +27,7 @@ module Google
27
27
  # @see https://cloud.google.com/service-management/
28
28
  module ServicemanagementV1
29
29
  VERSION = 'V1'
30
- REVISION = '20200619'
30
+ REVISION = '20200727'
31
31
 
32
32
  # View and manage your data across Google Cloud Platform services
33
33
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -2566,8 +2566,8 @@ module Google
2566
2566
  # existing data unusable.
2567
2567
  # The following are specific rules for service defined Monitoring metric
2568
2568
  # descriptors:
2569
- # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
2570
- # `launch_stage` fields are all required. The `unit` field must be specified
2569
+ # * `type`, `metric_kind`, `value_type` and `description`
2570
+ # fields are all required. The `unit` field must be specified
2571
2571
  # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
2572
2572
  # * Maximum of default 500 metric descriptors per service is allowed.
2573
2573
  # * Maximum of default 10 labels per metric descriptor is allowed.
@@ -3652,6 +3652,54 @@ module Google
3652
3652
  end
3653
3653
  end
3654
3654
 
3655
+ # Defines a proto annotation that describes a string field that refers to
3656
+ # an API resource.
3657
+ class ResourceReference
3658
+ include Google::Apis::Core::Hashable
3659
+
3660
+ # The resource type of a child collection that the annotated field
3661
+ # references. This is useful for annotating the `parent` field that
3662
+ # doesn't have a fixed resource type.
3663
+ # Example:
3664
+ # message ListLogEntriesRequest `
3665
+ # string parent = 1 [(google.api.resource_reference) = `
3666
+ # child_type: "logging.googleapis.com/LogEntry"
3667
+ # `;
3668
+ # `
3669
+ # Corresponds to the JSON property `childType`
3670
+ # @return [String]
3671
+ attr_accessor :child_type
3672
+
3673
+ # The resource type that the annotated field references.
3674
+ # Example:
3675
+ # message Subscription `
3676
+ # string topic = 2 [(google.api.resource_reference) = `
3677
+ # type: "pubsub.googleapis.com/Topic"
3678
+ # `];
3679
+ # `
3680
+ # Occasionally, a field may reference an arbitrary resource. In this case,
3681
+ # APIs use the special value * in their resource reference.
3682
+ # Example:
3683
+ # message GetIamPolicyRequest `
3684
+ # string resource = 2 [(google.api.resource_reference) = `
3685
+ # type: "*"
3686
+ # `];
3687
+ # `
3688
+ # Corresponds to the JSON property `type`
3689
+ # @return [String]
3690
+ attr_accessor :type
3691
+
3692
+ def initialize(**args)
3693
+ update!(**args)
3694
+ end
3695
+
3696
+ # Update properties of this object
3697
+ def update!(**args)
3698
+ @child_type = args[:child_type] if args.key?(:child_type)
3699
+ @type = args[:type] if args.key?(:type)
3700
+ end
3701
+ end
3702
+
3655
3703
  # A rollout resource that defines how service configuration versions are pushed
3656
3704
  # to control plane systems. Typically, you create a new version of the
3657
3705
  # service config, and then create a Rollout to push the service config.
@@ -442,6 +442,12 @@ module Google
442
442
  include Google::Apis::Core::JsonObjectSupport
443
443
  end
444
444
 
445
+ class ResourceReference
446
+ class Representation < Google::Apis::Core::JsonRepresentation; end
447
+
448
+ include Google::Apis::Core::JsonObjectSupport
449
+ end
450
+
445
451
  class Rollout
446
452
  class Representation < Google::Apis::Core::JsonRepresentation; end
447
453
 
@@ -1253,6 +1259,14 @@ module Google
1253
1259
  end
1254
1260
  end
1255
1261
 
1262
+ class ResourceReference
1263
+ # @private
1264
+ class Representation < Google::Apis::Core::JsonRepresentation
1265
+ property :child_type, as: 'childType'
1266
+ property :type, as: 'type'
1267
+ end
1268
+ end
1269
+
1256
1270
  class Rollout
1257
1271
  # @private
1258
1272
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
27
27
  module ServicenetworkingV1
28
28
  VERSION = 'V1'
29
- REVISION = '20200615'
29
+ REVISION = '20200801'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -42,9 +42,8 @@ module Google
42
42
  include Google::Apis::Core::Hashable
43
43
 
44
44
  # Required. The network that the consumer is using to connect with services.
45
- # Must be in the form of projects/`project`/global/networks/`network`
46
- # `project` is the project number, as in '12345'
47
- # `network` is the network name.
45
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
46
+ # is the project number, as in '12345' `network` is the network name.
48
47
  # Corresponds to the JSON property `consumerNetwork`
49
48
  # @return [String]
50
49
  attr_accessor :consumer_network
@@ -55,8 +54,7 @@ module Google
55
54
  attr_accessor :dns_record_set
56
55
 
57
56
  # Required. The name of the private DNS zone in the shared producer host project
58
- # to
59
- # which the record set will be added.
57
+ # to which the record set will be added.
60
58
  # Corresponds to the JSON property `zone`
61
59
  # @return [String]
62
60
  attr_accessor :zone
@@ -93,9 +91,8 @@ module Google
93
91
  include Google::Apis::Core::Hashable
94
92
 
95
93
  # Required. The network that the consumer is using to connect with services.
96
- # Must be in the form of projects/`project`/global/networks/`network`
97
- # `project` is the project number, as in '12345'
98
- # `network` is the network name.
94
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
95
+ # is the project number, as in '12345' `network` is the network name.
99
96
  # Corresponds to the JSON property `consumerNetwork`
100
97
  # @return [String]
101
98
  attr_accessor :consumer_network
@@ -106,9 +103,8 @@ module Google
106
103
  attr_accessor :dns_suffix
107
104
 
108
105
  # Required. The name for both the private zone in the shared producer host
109
- # project and
110
- # the peering zone in the consumer project. Must be unique within both
111
- # projects. The name must be 1-63 characters long, must begin with a letter,
106
+ # project and the peering zone in the consumer project. Must be unique within
107
+ # both projects. The name must be 1-63 characters long, must begin with a letter,
112
108
  # end with a letter or digit, and only contain lowercase letters, digits or
113
109
  # dashes.
114
110
  # Corresponds to the JSON property `name`
@@ -167,16 +163,14 @@ module Google
167
163
  end
168
164
  end
169
165
 
170
- # Request for AddRoles to allow Service Producers to add roles in the shared
171
- # VPC host project for them to use.
166
+ # Request for AddRoles to allow Service Producers to add roles in the shared VPC
167
+ # host project for them to use.
172
168
  class AddRolesRequest
173
169
  include Google::Apis::Core::Hashable
174
170
 
175
171
  # Required. The network that the consumer is using to connect with services.
176
- # Must be in
177
- # the form of projects/`project`/global/networks/`network`
178
- # `project` is a project number, as in '12345'
179
- # `network` is a network name.
172
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
173
+ # is a project number, as in '12345' `network` is a network name.
180
174
  # Corresponds to the JSON property `consumerNetwork`
181
175
  # @return [String]
182
176
  attr_accessor :consumer_network
@@ -221,21 +215,20 @@ module Google
221
215
  class AddSubnetworkRequest
222
216
  include Google::Apis::Core::Hashable
223
217
 
224
- # Required. A resource that represents the service consumer, such as
225
- # `projects/123456`. The project number can be different from the
226
- # value in the consumer network parameter. For example, the network might be
227
- # part of a Shared VPC network. In those cases, Service Networking validates
228
- # that this resource belongs to that Shared VPC.
218
+ # Required. A resource that represents the service consumer, such as `projects/
219
+ # 123456`. The project number can be different from the value in the consumer
220
+ # network parameter. For example, the network might be part of a Shared VPC
221
+ # network. In those cases, Service Networking validates that this resource
222
+ # belongs to that Shared VPC.
229
223
  # Corresponds to the JSON property `consumer`
230
224
  # @return [String]
231
225
  attr_accessor :consumer
232
226
 
233
- # Required. The name of the service consumer's VPC network. The network
234
- # must have an existing private connection that was provisioned through the
235
- # connections.create method. The name must be in the following format:
236
- # `projects/`project`/global/networks/`network``, where `project`
237
- # is a project number, such as `12345`. `network` is the name of a
238
- # VPC network in the project.
227
+ # Required. The name of the service consumer's VPC network. The network must
228
+ # have an existing private connection that was provisioned through the
229
+ # connections.create method. The name must be in the following format: `projects/
230
+ # `project`/global/networks/`network``, where `project` is a project number,
231
+ # such as `12345`. `network` is the name of a VPC network in the project.
239
232
  # Corresponds to the JSON property `consumerNetwork`
240
233
  # @return [String]
241
234
  attr_accessor :consumer_network
@@ -245,46 +238,46 @@ module Google
245
238
  # @return [String]
246
239
  attr_accessor :description
247
240
 
248
- # Required. The prefix length of the subnet's IP address range. Use CIDR
249
- # range notation, such as `30` to provision a subnet with an
250
- # `x.x.x.x/30` CIDR range. The IP address range is drawn from a
251
- # pool of available ranges in the service consumer's allocated range.
241
+ # Required. The prefix length of the subnet's IP address range. Use CIDR range
242
+ # notation, such as `30` to provision a subnet with an `x.x.x.x/30` CIDR range.
243
+ # The IP address range is drawn from a pool of available ranges in the service
244
+ # consumer's allocated range.
252
245
  # Corresponds to the JSON property `ipPrefixLength`
253
246
  # @return [Fixnum]
254
247
  attr_accessor :ip_prefix_length
255
248
 
256
- # Optional. The private IPv6 google access type for the VMs in this subnet.
257
- # For information about the access types that can be set using this field,
258
- # see [subnetwork](/compute/docs/reference/rest/v1/subnetworks)
259
- # in the Compute API documentation.
249
+ # Optional. The private IPv6 google access type for the VMs in this subnet. For
250
+ # information about the access types that can be set using this field, see [
251
+ # subnetwork](/compute/docs/reference/rest/v1/subnetworks) in the Compute API
252
+ # documentation.
260
253
  # Corresponds to the JSON property `privateIpv6GoogleAccess`
261
254
  # @return [String]
262
255
  attr_accessor :private_ipv6_google_access
263
256
 
264
- # Required. The name of a [region](/compute/docs/regions-zones)
265
- # for the subnet, such `europe-west1`.
257
+ # Required. The name of a [region](/compute/docs/regions-zones) for the subnet,
258
+ # such `europe-west1`.
266
259
  # Corresponds to the JSON property `region`
267
260
  # @return [String]
268
261
  attr_accessor :region
269
262
 
270
- # Optional. The starting address of a range. The address must be a valid
271
- # IPv4 address in the x.x.x.x format. This value combined with the IP prefix
272
- # range is the CIDR range for the subnet. The range must be within the
273
- # allocated range that is assigned to the private connection. If the CIDR
274
- # range isn't available, the call fails.
263
+ # Optional. The starting address of a range. The address must be a valid IPv4
264
+ # address in the x.x.x.x format. This value combined with the IP prefix range is
265
+ # the CIDR range for the subnet. The range must be within the allocated range
266
+ # that is assigned to the private connection. If the CIDR range isn't available,
267
+ # the call fails.
275
268
  # Corresponds to the JSON property `requestedAddress`
276
269
  # @return [String]
277
270
  attr_accessor :requested_address
278
271
 
279
272
  # Required. A name for the new subnet. For information about the naming
280
- # requirements, see [subnetwork](/compute/docs/reference/rest/v1/subnetworks)
281
- # in the Compute API documentation.
273
+ # requirements, see [subnetwork](/compute/docs/reference/rest/v1/subnetworks) in
274
+ # the Compute API documentation.
282
275
  # Corresponds to the JSON property `subnetwork`
283
276
  # @return [String]
284
277
  attr_accessor :subnetwork
285
278
 
286
- # A list of members that are granted the `compute.networkUser`
287
- # role on the subnet.
279
+ # A list of members that are granted the `compute.networkUser` role on the
280
+ # subnet.
288
281
  # Corresponds to the JSON property `subnetworkUsers`
289
282
  # @return [Array<String>]
290
283
  attr_accessor :subnetwork_users
@@ -307,14 +300,13 @@ module Google
307
300
  end
308
301
  end
309
302
 
310
- # Api is a light-weight descriptor for an API Interface.
311
- # Interfaces are also described as "protocol buffer services" in some contexts,
312
- # such as by the "service" keyword in a .proto file, but they are different
313
- # from API Services, which represent a concrete implementation of an interface
314
- # as opposed to simply a description of methods and bindings. They are also
315
- # sometimes simply referred to as "APIs" in other contexts, such as the name of
316
- # this message itself. See https://cloud.google.com/apis/design/glossary for
317
- # detailed terminology.
303
+ # Api is a light-weight descriptor for an API Interface. Interfaces are also
304
+ # described as "protocol buffer services" in some contexts, such as by the "
305
+ # service" keyword in a .proto file, but they are different from API Services,
306
+ # which represent a concrete implementation of an interface as opposed to simply
307
+ # a description of methods and bindings. They are also sometimes simply referred
308
+ # to as "APIs" in other contexts, such as the name of this message itself. See
309
+ # https://cloud.google.com/apis/design/glossary for detailed terminology.
318
310
  class Api
319
311
  include Google::Apis::Core::Hashable
320
312
 
@@ -328,8 +320,8 @@ module Google
328
320
  # @return [Array<Google::Apis::ServicenetworkingV1::Mixin>]
329
321
  attr_accessor :mixins
330
322
 
331
- # The fully qualified name of this interface, including package name
332
- # followed by the interface's simple name.
323
+ # The fully qualified name of this interface, including package name followed by
324
+ # the interface's simple name.
333
325
  # Corresponds to the JSON property `name`
334
326
  # @return [String]
335
327
  attr_accessor :name
@@ -339,8 +331,8 @@ module Google
339
331
  # @return [Array<Google::Apis::ServicenetworkingV1::Option>]
340
332
  attr_accessor :options
341
333
 
342
- # `SourceContext` represents information about the source of a
343
- # protobuf element, like the file in which it is defined.
334
+ # `SourceContext` represents information about the source of a protobuf element,
335
+ # like the file in which it is defined.
344
336
  # Corresponds to the JSON property `sourceContext`
345
337
  # @return [Google::Apis::ServicenetworkingV1::SourceContext]
346
338
  attr_accessor :source_context
@@ -350,23 +342,19 @@ module Google
350
342
  # @return [String]
351
343
  attr_accessor :syntax
352
344
 
353
- # A version string for this interface. If specified, must have the form
354
- # `major-version.minor-version`, as in `1.10`. If the minor version is
355
- # omitted, it defaults to zero. If the entire version field is empty, the
356
- # major version is derived from the package name, as outlined below. If the
357
- # field is not empty, the version in the package name will be verified to be
358
- # consistent with what is provided here.
359
- # The versioning schema uses [semantic
360
- # versioning](http://semver.org) where the major version number
361
- # indicates a breaking change and the minor version an additive,
362
- # non-breaking change. Both version numbers are signals to users
363
- # what to expect from different versions, and should be carefully
364
- # chosen based on the product plan.
365
- # The major version is also reflected in the package name of the
366
- # interface, which must end in `v<major-version>`, as in
367
- # `google.feature.v1`. For major versions 0 and 1, the suffix can
368
- # be omitted. Zero major versions must only be used for
369
- # experimental, non-GA interfaces.
345
+ # A version string for this interface. If specified, must have the form `major-
346
+ # version.minor-version`, as in `1.10`. If the minor version is omitted, it
347
+ # defaults to zero. If the entire version field is empty, the major version is
348
+ # derived from the package name, as outlined below. If the field is not empty,
349
+ # the version in the package name will be verified to be consistent with what is
350
+ # provided here. The versioning schema uses [semantic versioning](http://semver.
351
+ # org) where the major version number indicates a breaking change and the minor
352
+ # version an additive, non-breaking change. Both version numbers are signals to
353
+ # users what to expect from different versions, and should be carefully chosen
354
+ # based on the product plan. The major version is also reflected in the package
355
+ # name of the interface, which must end in `v`, as in `google.feature.v1`. For
356
+ # major versions 0 and 1, the suffix can be omitted. Zero major versions must
357
+ # only be used for experimental, non-GA interfaces.
370
358
  # Corresponds to the JSON property `version`
371
359
  # @return [String]
372
360
  attr_accessor :version
@@ -387,85 +375,63 @@ module Google
387
375
  end
388
376
  end
389
377
 
390
- # Configuration for an authentication provider, including support for
391
- # [JSON Web Token
392
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
378
+ # Configuration for an authentication provider, including support for [JSON Web
379
+ # Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
393
380
  class AuthProvider
394
381
  include Google::Apis::Core::Hashable
395
382
 
396
- # The list of JWT
397
- # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#
398
- # section-4.1.3).
399
- # that are allowed to access. A JWT containing any of these audiences will
400
- # be accepted. When this setting is absent, JWTs with audiences:
401
- # - "https://[service.name]/[google.protobuf.Api.name]"
402
- # - "https://[service.name]/"
403
- # will be accepted.
404
- # For example, if no audiences are in the setting, LibraryService API will
405
- # accept JWTs with the following audiences:
406
- # -
383
+ # The list of JWT [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-
384
+ # web-token-32#section-4.1.3). that are allowed to access. A JWT containing any
385
+ # of these audiences will be accepted. When this setting is absent, JWTs with
386
+ # audiences: - "https://[service.name]/[google.protobuf.Api.name]" - "https://[
387
+ # service.name]/" will be accepted. For example, if no audiences are in the
388
+ # setting, LibraryService API will accept JWTs with the following audiences: -
407
389
  # https://library-example.googleapis.com/google.example.library.v1.
408
- # LibraryService
409
- # - https://library-example.googleapis.com/
410
- # Example:
411
- # audiences: bookstore_android.apps.googleusercontent.com,
412
- # bookstore_web.apps.googleusercontent.com
390
+ # LibraryService - https://library-example.googleapis.com/ Example: audiences:
391
+ # bookstore_android.apps.googleusercontent.com, bookstore_web.apps.
392
+ # googleusercontent.com
413
393
  # Corresponds to the JSON property `audiences`
414
394
  # @return [String]
415
395
  attr_accessor :audiences
416
396
 
417
- # Redirect URL if JWT token is required but not present or is expired.
418
- # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
397
+ # Redirect URL if JWT token is required but not present or is expired. Implement
398
+ # authorizationUrl of securityDefinitions in OpenAPI spec.
419
399
  # Corresponds to the JSON property `authorizationUrl`
420
400
  # @return [String]
421
401
  attr_accessor :authorization_url
422
402
 
423
- # The unique identifier of the auth provider. It will be referred to by
424
- # `AuthRequirement.provider_id`.
425
- # Example: "bookstore_auth".
403
+ # The unique identifier of the auth provider. It will be referred to by `
404
+ # AuthRequirement.provider_id`. Example: "bookstore_auth".
426
405
  # Corresponds to the JSON property `id`
427
406
  # @return [String]
428
407
  attr_accessor :id
429
408
 
430
- # Identifies the principal that issued the JWT. See
431
- # https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1
432
- # Usually a URL or an email address.
433
- # Example: https://securetoken.google.com
434
- # Example: 1234567-compute@developer.gserviceaccount.com
409
+ # Identifies the principal that issued the JWT. See https://tools.ietf.org/html/
410
+ # draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email
411
+ # address. Example: https://securetoken.google.com Example: 1234567-compute@
412
+ # developer.gserviceaccount.com
435
413
  # Corresponds to the JSON property `issuer`
436
414
  # @return [String]
437
415
  attr_accessor :issuer
438
416
 
439
- # URL of the provider's public key set to validate signature of the JWT. See
440
- # [OpenID
441
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
442
- # ProviderMetadata).
443
- # Optional if the key set document:
444
- # - can be retrieved from
445
- # [OpenID
446
- # Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
447
- # the issuer.
448
- # - can be inferred from the email domain of the issuer (e.g. a Google
449
- # service account).
450
- # Example: https://www.googleapis.com/oauth2/v1/certs
417
+ # URL of the provider's public key set to validate signature of the JWT. See [
418
+ # OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#
419
+ # ProviderMetadata). Optional if the key set document: - can be retrieved from [
420
+ # OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html
421
+ # of the issuer. - can be inferred from the email domain of the issuer (e.g. a
422
+ # Google service account). Example: https://www.googleapis.com/oauth2/v1/certs
451
423
  # Corresponds to the JSON property `jwksUri`
452
424
  # @return [String]
453
425
  attr_accessor :jwks_uri
454
426
 
455
- # Defines the locations to extract the JWT.
456
- # JWT locations can be either from HTTP headers or URL query parameters.
457
- # The rule is that the first match wins. The checking order is: checking
458
- # all headers first, then URL query parameters.
459
- # If not specified, default to use following 3 locations:
460
- # 1) Authorization: Bearer
461
- # 2) x-goog-iap-jwt-assertion
462
- # 3) access_token query parameter
463
- # Default locations can be specified as followings:
464
- # jwt_locations:
465
- # - header: Authorization
466
- # value_prefix: "Bearer "
467
- # - header: x-goog-iap-jwt-assertion
468
- # - query: access_token
427
+ # Defines the locations to extract the JWT. JWT locations can be either from
428
+ # HTTP headers or URL query parameters. The rule is that the first match wins.
429
+ # The checking order is: checking all headers first, then URL query parameters.
430
+ # If not specified, default to use following 3 locations: 1) Authorization:
431
+ # Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default
432
+ # locations can be specified as followings: jwt_locations: - header:
433
+ # Authorization value_prefix: "Bearer " - header: x-goog-iap-jwt-assertion -
434
+ # query: access_token
469
435
  # Corresponds to the JSON property `jwtLocations`
470
436
  # @return [Array<Google::Apis::ServicenetworkingV1::JwtLocation>]
471
437
  attr_accessor :jwt_locations
@@ -485,34 +451,26 @@ module Google
485
451
  end
486
452
  end
487
453
 
488
- # User-defined authentication requirements, including support for
489
- # [JSON Web Token
490
- # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
454
+ # User-defined authentication requirements, including support for [JSON Web
455
+ # Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
491
456
  class AuthRequirement
492
457
  include Google::Apis::Core::Hashable
493
458
 
494
- # NOTE: This will be deprecated soon, once AuthProvider.audiences is
495
- # implemented and accepted in all the runtime components.
496
- # The list of JWT
497
- # [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#
498
- # section-4.1.3).
499
- # that are allowed to access. A JWT containing any of these audiences will
500
- # be accepted. When this setting is absent, only JWTs with audience
501
- # "https://Service_name/API_name"
502
- # will be accepted. For example, if no audiences are in the setting,
503
- # LibraryService API will only accept JWTs with the following audience
504
- # "https://library-example.googleapis.com/google.example.library.v1.
505
- # LibraryService".
506
- # Example:
507
- # audiences: bookstore_android.apps.googleusercontent.com,
508
- # bookstore_web.apps.googleusercontent.com
459
+ # NOTE: This will be deprecated soon, once AuthProvider.audiences is implemented
460
+ # and accepted in all the runtime components. The list of JWT [audiences](https:/
461
+ # /tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). that
462
+ # are allowed to access. A JWT containing any of these audiences will be
463
+ # accepted. When this setting is absent, only JWTs with audience "https://
464
+ # Service_name/API_name" will be accepted. For example, if no audiences are in
465
+ # the setting, LibraryService API will only accept JWTs with the following
466
+ # audience "https://library-example.googleapis.com/google.example.library.v1.
467
+ # LibraryService". Example: audiences: bookstore_android.apps.googleusercontent.
468
+ # com, bookstore_web.apps.googleusercontent.com
509
469
  # Corresponds to the JSON property `audiences`
510
470
  # @return [String]
511
471
  attr_accessor :audiences
512
472
 
513
- # id from authentication provider.
514
- # Example:
515
- # provider_id: bookstore_auth
473
+ # id from authentication provider. Example: provider_id: bookstore_auth
516
474
  # Corresponds to the JSON property `providerId`
517
475
  # @return [String]
518
476
  attr_accessor :provider_id
@@ -528,18 +486,11 @@ module Google
528
486
  end
529
487
  end
530
488
 
531
- # `Authentication` defines the authentication configuration for an API.
532
- # Example for an API targeted for external use:
533
- # name: calendar.googleapis.com
534
- # authentication:
535
- # providers:
536
- # - id: google_calendar_auth
537
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
538
- # issuer: https://securetoken.google.com
539
- # rules:
540
- # - selector: "*"
541
- # requirements:
542
- # provider_id: google_calendar_auth
489
+ # `Authentication` defines the authentication configuration for an API. Example
490
+ # for an API targeted for external use: name: calendar.googleapis.com
491
+ # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
492
+ # googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: -
493
+ # selector: "*" requirements: provider_id: google_calendar_auth
543
494
  class Authentication
544
495
  include Google::Apis::Core::Hashable
545
496
 
@@ -548,8 +499,8 @@ module Google
548
499
  # @return [Array<Google::Apis::ServicenetworkingV1::AuthProvider>]
549
500
  attr_accessor :providers
550
501
 
551
- # A list of authentication rules that apply to individual API methods.
552
- # **NOTE:** All service configuration rules follow "last one wins" order.
502
+ # A list of authentication rules that apply to individual API methods. **NOTE:**
503
+ # All service configuration rules follow "last one wins" order.
553
504
  # Corresponds to the JSON property `rules`
554
505
  # @return [Array<Google::Apis::ServicenetworkingV1::AuthenticationRule>]
555
506
  attr_accessor :rules
@@ -565,13 +516,11 @@ module Google
565
516
  end
566
517
  end
567
518
 
568
- # Authentication rules for the service.
569
- # By default, if a method has any authentication requirements, every request
570
- # must include a valid credential matching one of the requirements.
571
- # It's an error to include more than one kind of credential in a single
572
- # request.
573
- # If a method doesn't have any auth requirements, request credentials will be
574
- # ignored.
519
+ # Authentication rules for the service. By default, if a method has any
520
+ # authentication requirements, every request must include a valid credential
521
+ # matching one of the requirements. It's an error to include more than one kind
522
+ # of credential in a single request. If a method doesn't have any auth
523
+ # requirements, request credentials will be ignored.
575
524
  class AuthenticationRule
576
525
  include Google::Apis::Core::Hashable
577
526
 
@@ -582,19 +531,18 @@ module Google
582
531
  alias_method :allow_without_credential?, :allow_without_credential
583
532
 
584
533
  # OAuth scopes are a way to define data and permissions on data. For example,
585
- # there are scopes defined for "Read-only access to Google Calendar" and
586
- # "Access to Cloud Platform". Users can consent to a scope for an application,
587
- # giving it permission to access that data on their behalf.
588
- # OAuth scope specifications should be fairly coarse grained; a user will need
589
- # to see and understand the text description of what your scope means.
590
- # In most cases: use one or at most two OAuth scopes for an entire family of
591
- # products. If your product has multiple APIs, you should probably be sharing
592
- # the OAuth scope across all of those APIs.
593
- # When you need finer grained OAuth consent screens: talk with your product
594
- # management about how developers will use them in practice.
595
- # Please note that even though each of the canonical scopes is enough for a
596
- # request to be accepted and passed to the backend, a request can still fail
597
- # due to the backend requiring additional scopes or permissions.
534
+ # there are scopes defined for "Read-only access to Google Calendar" and "Access
535
+ # to Cloud Platform". Users can consent to a scope for an application, giving it
536
+ # permission to access that data on their behalf. OAuth scope specifications
537
+ # should be fairly coarse grained; a user will need to see and understand the
538
+ # text description of what your scope means. In most cases: use one or at most
539
+ # two OAuth scopes for an entire family of products. If your product has
540
+ # multiple APIs, you should probably be sharing the OAuth scope across all of
541
+ # those APIs. When you need finer grained OAuth consent screens: talk with your
542
+ # product management about how developers will use them in practice. Please note
543
+ # that even though each of the canonical scopes is enough for a request to be
544
+ # accepted and passed to the backend, a request can still fail due to the
545
+ # backend requiring additional scopes or permissions.
598
546
  # Corresponds to the JSON property `oauth`
599
547
  # @return [Google::Apis::ServicenetworkingV1::OAuthRequirements]
600
548
  attr_accessor :oauth
@@ -604,8 +552,8 @@ module Google
604
552
  # @return [Array<Google::Apis::ServicenetworkingV1::AuthRequirement>]
605
553
  attr_accessor :requirements
606
554
 
607
- # Selects the methods to which this rule applies.
608
- # Refer to selector for syntax details.
555
+ # Selects the methods to which this rule applies. Refer to selector for syntax
556
+ # details.
609
557
  # Corresponds to the JSON property `selector`
610
558
  # @return [String]
611
559
  attr_accessor :selector
@@ -627,8 +575,8 @@ module Google
627
575
  class Backend
628
576
  include Google::Apis::Core::Hashable
629
577
 
630
- # A list of API backend rules that apply to individual API methods.
631
- # **NOTE:** All service configuration rules follow "last one wins" order.
578
+ # A list of API backend rules that apply to individual API methods. **NOTE:**
579
+ # All service configuration rules follow "last one wins" order.
632
580
  # Corresponds to the JSON property `rules`
633
581
  # @return [Array<Google::Apis::ServicenetworkingV1::BackendRule>]
634
582
  attr_accessor :rules
@@ -647,21 +595,13 @@ module Google
647
595
  class BackendRule
648
596
  include Google::Apis::Core::Hashable
649
597
 
650
- # The address of the API backend.
651
- # The scheme is used to determine the backend protocol and security.
652
- # The following schemes are accepted:
653
- # SCHEME PROTOCOL SECURITY
654
- # http:// HTTP None
655
- # https:// HTTP TLS
656
- # grpc:// gRPC None
657
- # grpcs:// gRPC TLS
658
- # It is recommended to explicitly include a scheme. Leaving out the scheme
659
- # may cause constrasting behaviors across platforms.
660
- # If the port is unspecified, the default is:
661
- # - 80 for schemes without TLS
662
- # - 443 for schemes with TLS
663
- # For HTTP backends, use protocol
664
- # to specify the protocol version.
598
+ # The address of the API backend. The scheme is used to determine the backend
599
+ # protocol and security. The following schemes are accepted: SCHEME PROTOCOL
600
+ # SECURITY http:// HTTP None https:// HTTP TLS grpc:// gRPC None grpcs:// gRPC
601
+ # TLS It is recommended to explicitly include a scheme. Leaving out the scheme
602
+ # may cause constrasting behaviors across platforms. If the port is unspecified,
603
+ # the default is: - 80 for schemes without TLS - 443 for schemes with TLS For
604
+ # HTTP backends, use protocol to specify the protocol version.
665
605
  # Corresponds to the JSON property `address`
666
606
  # @return [String]
667
607
  attr_accessor :address
@@ -672,18 +612,18 @@ module Google
672
612
  # @return [Float]
673
613
  attr_accessor :deadline
674
614
 
675
- # When disable_auth is true, a JWT ID token won't be generated and the
676
- # original "Authorization" HTTP header will be preserved. If the header is
677
- # used to carry the original token and is expected by the backend, this
678
- # field must be set to true to preserve the header.
615
+ # When disable_auth is true, a JWT ID token won't be generated and the original "
616
+ # Authorization" HTTP header will be preserved. If the header is used to carry
617
+ # the original token and is expected by the backend, this field must be set to
618
+ # true to preserve the header.
679
619
  # Corresponds to the JSON property `disableAuth`
680
620
  # @return [Boolean]
681
621
  attr_accessor :disable_auth
682
622
  alias_method :disable_auth?, :disable_auth
683
623
 
684
- # The JWT audience is used when generating a JWT ID token for the backend.
685
- # This ID token will be added in the HTTP "authorization" header, and sent
686
- # to the backend.
624
+ # The JWT audience is used when generating a JWT ID token for the backend. This
625
+ # ID token will be added in the HTTP "authorization" header, and sent to the
626
+ # backend.
687
627
  # Corresponds to the JSON property `jwtAudience`
688
628
  # @return [String]
689
629
  attr_accessor :jwt_audience
@@ -694,8 +634,8 @@ module Google
694
634
  # @return [Float]
695
635
  attr_accessor :min_deadline
696
636
 
697
- # The number of seconds to wait for the completion of a long running
698
- # operation. The default is no deadline.
637
+ # The number of seconds to wait for the completion of a long running operation.
638
+ # The default is no deadline.
699
639
  # Corresponds to the JSON property `operationDeadline`
700
640
  # @return [Float]
701
641
  attr_accessor :operation_deadline
@@ -705,29 +645,21 @@ module Google
705
645
  # @return [String]
706
646
  attr_accessor :path_translation
707
647
 
708
- # The protocol used for sending a request to the backend.
709
- # The supported values are "http/1.1" and "h2".
710
- # The default value is inferred from the scheme in the
711
- # address field:
712
- # SCHEME PROTOCOL
713
- # http:// http/1.1
714
- # https:// http/1.1
715
- # grpc:// h2
716
- # grpcs:// h2
717
- # For secure HTTP backends (https://) that support HTTP/2, set this field
718
- # to "h2" for improved performance.
719
- # Configuring this field to non-default values is only supported for secure
720
- # HTTP backends. This field will be ignored for all other backends.
721
- # See
722
- # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-
723
- # values.xhtml#alpn-protocol-ids
724
- # for more details on the supported values.
648
+ # The protocol used for sending a request to the backend. The supported values
649
+ # are "http/1.1" and "h2". The default value is inferred from the scheme in the
650
+ # address field: SCHEME PROTOCOL http:// http/1.1 https:// http/1.1 grpc:// h2
651
+ # grpcs:// h2 For secure HTTP backends (https://) that support HTTP/2, set this
652
+ # field to "h2" for improved performance. Configuring this field to non-default
653
+ # values is only supported for secure HTTP backends. This field will be ignored
654
+ # for all other backends. See https://www.iana.org/assignments/tls-extensiontype-
655
+ # values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on
656
+ # the supported values.
725
657
  # Corresponds to the JSON property `protocol`
726
658
  # @return [String]
727
659
  attr_accessor :protocol
728
660
 
729
- # Selects the methods to which this rule applies.
730
- # Refer to selector for syntax details.
661
+ # Selects the methods to which this rule applies. Refer to selector for syntax
662
+ # details.
731
663
  # Corresponds to the JSON property `selector`
732
664
  # @return [String]
733
665
  attr_accessor :selector
@@ -750,42 +682,28 @@ module Google
750
682
  end
751
683
  end
752
684
 
753
- # Billing related configuration of the service.
754
- # The following example shows how to configure monitored resources and metrics
755
- # for billing, `consumer_destinations` is the only supported destination and
756
- # the monitored resources need at least one label key
757
- # `cloud.googleapis.com/location` to indicate the location of the billing
758
- # usage, using different monitored resources between monitoring and billing is
759
- # recommended so they can be evolved independently:
760
- # monitored_resources:
761
- # - type: library.googleapis.com/billing_branch
762
- # labels:
763
- # - key: cloud.googleapis.com/location
764
- # description: |
765
- # Predefined label to support billing location restriction.
766
- # - key: city
767
- # description: |
768
- # Custom label to define the city where the library branch is located
769
- # in.
770
- # - key: name
771
- # description: Custom label to define the name of the library branch.
772
- # metrics:
773
- # - name: library.googleapis.com/book/borrowed_count
774
- # metric_kind: DELTA
775
- # value_type: INT64
776
- # unit: "1"
777
- # billing:
778
- # consumer_destinations:
779
- # - monitored_resource: library.googleapis.com/billing_branch
780
- # metrics:
781
- # - library.googleapis.com/book/borrowed_count
685
+ # Billing related configuration of the service. The following example shows how
686
+ # to configure monitored resources and metrics for billing, `
687
+ # consumer_destinations` is the only supported destination and the monitored
688
+ # resources need at least one label key `cloud.googleapis.com/location` to
689
+ # indicate the location of the billing usage, using different monitored
690
+ # resources between monitoring and billing is recommended so they can be evolved
691
+ # independently: monitored_resources: - type: library.googleapis.com/
692
+ # billing_branch labels: - key: cloud.googleapis.com/location description: |
693
+ # Predefined label to support billing location restriction. - key: city
694
+ # description: | Custom label to define the city where the library branch is
695
+ # located in. - key: name description: Custom label to define the name of the
696
+ # library branch. metrics: - name: library.googleapis.com/book/borrowed_count
697
+ # metric_kind: DELTA value_type: INT64 unit: "1" billing: consumer_destinations:
698
+ # - monitored_resource: library.googleapis.com/billing_branch metrics: - library.
699
+ # googleapis.com/book/borrowed_count
782
700
  class Billing
783
701
  include Google::Apis::Core::Hashable
784
702
 
785
- # Billing configurations for sending metrics to the consumer project.
786
- # There can be multiple consumer destinations per service, each one must have
787
- # a different monitored resource type. A metric can be used in at most
788
- # one consumer destination.
703
+ # Billing configurations for sending metrics to the consumer project. There can
704
+ # be multiple consumer destinations per service, each one must have a different
705
+ # monitored resource type. A metric can be used in at most one consumer
706
+ # destination.
789
707
  # Corresponds to the JSON property `consumerDestinations`
790
708
  # @return [Array<Google::Apis::ServicenetworkingV1::BillingDestination>]
791
709
  attr_accessor :consumer_destinations
@@ -800,19 +718,19 @@ module Google
800
718
  end
801
719
  end
802
720
 
803
- # Configuration of a specific billing destination (Currently only support
804
- # bill against consumer project).
721
+ # Configuration of a specific billing destination (Currently only support bill
722
+ # against consumer project).
805
723
  class BillingDestination
806
724
  include Google::Apis::Core::Hashable
807
725
 
808
- # Names of the metrics to report to this billing destination.
809
- # Each name must be defined in Service.metrics section.
726
+ # Names of the metrics to report to this billing destination. Each name must be
727
+ # defined in Service.metrics section.
810
728
  # Corresponds to the JSON property `metrics`
811
729
  # @return [Array<String>]
812
730
  attr_accessor :metrics
813
731
 
814
- # The monitored resource type. The type must be defined in
815
- # Service.monitored_resources section.
732
+ # The monitored resource type. The type must be defined in Service.
733
+ # monitored_resources section.
816
734
  # Corresponds to the JSON property `monitoredResource`
817
735
  # @return [String]
818
736
  attr_accessor :monitored_resource
@@ -848,37 +766,33 @@ module Google
848
766
  include Google::Apis::Core::Hashable
849
767
 
850
768
  # The name of service consumer's VPC network that's connected with service
851
- # producer network, in the following format:
852
- # `projects/`project`/global/networks/`network``.
853
- # ``project`` is a project number, such as in `12345` that includes
854
- # the VPC service consumer's VPC network. ``network`` is the name of the
855
- # service consumer's VPC network.
769
+ # producer network, in the following format: `projects/`project`/global/networks/
770
+ # `network``. ``project`` is a project number, such as in `12345` that includes
771
+ # the VPC service consumer's VPC network. ``network`` is the name of the service
772
+ # consumer's VPC network.
856
773
  # Corresponds to the JSON property `network`
857
774
  # @return [String]
858
775
  attr_accessor :network
859
776
 
860
777
  # Output only. The name of the VPC Network Peering connection that was created
861
- # by the
862
- # service producer.
778
+ # by the service producer.
863
779
  # Corresponds to the JSON property `peering`
864
780
  # @return [String]
865
781
  attr_accessor :peering
866
782
 
867
- # The name of one or more allocated IP address ranges for this service
868
- # producer of type `PEERING`.
869
- # Note that invoking CreateConnection method with a different range when
870
- # connection is already established will not modify already provisioned
871
- # service producer subnetworks.
872
- # If CreateConnection method is invoked repeatedly to reconnect when peering
873
- # connection had been disconnected on the consumer side, leaving this field
874
- # empty will restore previously allocated IP ranges.
783
+ # The name of one or more allocated IP address ranges for this service producer
784
+ # of type `PEERING`. Note that invoking CreateConnection method with a different
785
+ # range when connection is already established will not modify already
786
+ # provisioned service producer subnetworks. If CreateConnection method is
787
+ # invoked repeatedly to reconnect when peering connection had been disconnected
788
+ # on the consumer side, leaving this field empty will restore previously
789
+ # allocated IP ranges.
875
790
  # Corresponds to the JSON property `reservedPeeringRanges`
876
791
  # @return [Array<String>]
877
792
  attr_accessor :reserved_peering_ranges
878
793
 
879
794
  # Output only. The name of the peering service that's associated with this
880
- # connection, in
881
- # the following format: `services/`service name``.
795
+ # connection, in the following format: `services/`service name``.
882
796
  # Corresponds to the JSON property `service`
883
797
  # @return [String]
884
798
  attr_accessor :service
@@ -901,9 +815,8 @@ module Google
901
815
  include Google::Apis::Core::Hashable
902
816
 
903
817
  # Required. Project number of the consumer that is launching the service
904
- # instance. It
905
- # can own the network that is peered with Google or, be a service project in
906
- # an XPN where the host project has the network.
818
+ # instance. It can own the network that is peered with Google or, be a service
819
+ # project in an XPN where the host project has the network.
907
820
  # Corresponds to the JSON property `projectNum`
908
821
  # @return [Fixnum]
909
822
  attr_accessor :project_num
@@ -918,39 +831,24 @@ module Google
918
831
  end
919
832
  end
920
833
 
921
- # `Context` defines which contexts an API requests.
922
- # Example:
923
- # context:
924
- # rules:
925
- # - selector: "*"
926
- # requested:
927
- # - google.rpc.context.ProjectContext
928
- # - google.rpc.context.OriginContext
929
- # The above specifies that all methods in the API request
930
- # `google.rpc.context.ProjectContext` and
931
- # `google.rpc.context.OriginContext`.
932
- # Available context types are defined in package
933
- # `google.rpc.context`.
934
- # This also provides mechanism to whitelist any protobuf message extension that
935
- # can be sent in grpc metadata using “x-goog-ext-<extension_id>-bin” and
936
- # “x-goog-ext-<extension_id>-jspb” format. For example, list any service
937
- # specific protobuf types that can appear in grpc metadata as follows in your
938
- # yaml file:
939
- # Example:
940
- # context:
941
- # rules:
942
- # - selector: "google.example.library.v1.LibraryService.CreateBook"
943
- # allowed_request_extensions:
944
- # - google.foo.v1.NewExtension
945
- # allowed_response_extensions:
946
- # - google.foo.v1.NewExtension
947
- # You can also specify extension ID instead of fully qualified extension name
948
- # here.
834
+ # `Context` defines which contexts an API requests. Example: context: rules: -
835
+ # selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.
836
+ # context.OriginContext The above specifies that all methods in the API request `
837
+ # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
838
+ # Available context types are defined in package `google.rpc.context`. This also
839
+ # provides mechanism to whitelist any protobuf message extension that can be
840
+ # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
841
+ # For example, list any service specific protobuf types that can appear in grpc
842
+ # metadata as follows in your yaml file: Example: context: rules: - selector: "
843
+ # google.example.library.v1.LibraryService.CreateBook"
844
+ # allowed_request_extensions: - google.foo.v1.NewExtension
845
+ # allowed_response_extensions: - google.foo.v1.NewExtension You can also specify
846
+ # extension ID instead of fully qualified extension name here.
949
847
  class Context
950
848
  include Google::Apis::Core::Hashable
951
849
 
952
- # A list of RPC context rules that apply to individual API methods.
953
- # **NOTE:** All service configuration rules follow "last one wins" order.
850
+ # A list of RPC context rules that apply to individual API methods. **NOTE:**
851
+ # All service configuration rules follow "last one wins" order.
954
852
  # Corresponds to the JSON property `rules`
955
853
  # @return [Array<Google::Apis::ServicenetworkingV1::ContextRule>]
956
854
  attr_accessor :rules
@@ -970,14 +868,14 @@ module Google
970
868
  class ContextRule
971
869
  include Google::Apis::Core::Hashable
972
870
 
973
- # A list of full type names or extension IDs of extensions allowed in grpc
974
- # side channel from client to backend.
871
+ # A list of full type names or extension IDs of extensions allowed in grpc side
872
+ # channel from client to backend.
975
873
  # Corresponds to the JSON property `allowedRequestExtensions`
976
874
  # @return [Array<String>]
977
875
  attr_accessor :allowed_request_extensions
978
876
 
979
- # A list of full type names or extension IDs of extensions allowed in grpc
980
- # side channel from backend to client.
877
+ # A list of full type names or extension IDs of extensions allowed in grpc side
878
+ # channel from backend to client.
981
879
  # Corresponds to the JSON property `allowedResponseExtensions`
982
880
  # @return [Array<String>]
983
881
  attr_accessor :allowed_response_extensions
@@ -992,8 +890,8 @@ module Google
992
890
  # @return [Array<String>]
993
891
  attr_accessor :requested
994
892
 
995
- # Selects the methods to which this rule applies.
996
- # Refer to selector for syntax details.
893
+ # Selects the methods to which this rule applies. Refer to selector for syntax
894
+ # details.
997
895
  # Corresponds to the JSON property `selector`
998
896
  # @return [String]
999
897
  attr_accessor :selector
@@ -1012,14 +910,14 @@ module Google
1012
910
  end
1013
911
  end
1014
912
 
1015
- # Selects and configures the service controller used by the service. The
1016
- # service controller handles features like abuse, quota, billing, logging,
1017
- # monitoring, etc.
913
+ # Selects and configures the service controller used by the service. The service
914
+ # controller handles features like abuse, quota, billing, logging, monitoring,
915
+ # etc.
1018
916
  class Control
1019
917
  include Google::Apis::Core::Hashable
1020
918
 
1021
- # The service control environment to use. If empty, no control plane
1022
- # feature (like quota and billing) will be enabled.
919
+ # The service control environment to use. If empty, no control plane feature (
920
+ # like quota and billing) will be enabled.
1023
921
  # Corresponds to the JSON property `environment`
1024
922
  # @return [String]
1025
923
  attr_accessor :environment
@@ -1034,19 +932,15 @@ module Google
1034
932
  end
1035
933
  end
1036
934
 
1037
- # Customize service error responses. For example, list any service
1038
- # specific protobuf types that can appear in error detail lists of
1039
- # error responses.
1040
- # Example:
1041
- # custom_error:
1042
- # types:
1043
- # - google.foo.v1.CustomError
1044
- # - google.foo.v1.AnotherError
935
+ # Customize service error responses. For example, list any service specific
936
+ # protobuf types that can appear in error detail lists of error responses.
937
+ # Example: custom_error: types: - google.foo.v1.CustomError - google.foo.v1.
938
+ # AnotherError
1045
939
  class CustomError
1046
940
  include Google::Apis::Core::Hashable
1047
941
 
1048
- # The list of custom error rules that apply to individual API messages.
1049
- # **NOTE:** All service configuration rules follow "last one wins" order.
942
+ # The list of custom error rules that apply to individual API messages. **NOTE:**
943
+ # All service configuration rules follow "last one wins" order.
1050
944
  # Corresponds to the JSON property `rules`
1051
945
  # @return [Array<Google::Apis::ServicenetworkingV1::CustomErrorRule>]
1052
946
  attr_accessor :rules
@@ -1071,15 +965,15 @@ module Google
1071
965
  class CustomErrorRule
1072
966
  include Google::Apis::Core::Hashable
1073
967
 
1074
- # Mark this message as possible payload in error response. Otherwise,
1075
- # objects of this type will be filtered when they appear in error payload.
968
+ # Mark this message as possible payload in error response. Otherwise, objects of
969
+ # this type will be filtered when they appear in error payload.
1076
970
  # Corresponds to the JSON property `isErrorType`
1077
971
  # @return [Boolean]
1078
972
  attr_accessor :is_error_type
1079
973
  alias_method :is_error_type?, :is_error_type
1080
974
 
1081
- # Selects messages to which this rule applies.
1082
- # Refer to selector for syntax details.
975
+ # Selects messages to which this rule applies. Refer to selector for syntax
976
+ # details.
1083
977
  # Corresponds to the JSON property `selector`
1084
978
  # @return [String]
1085
979
  attr_accessor :selector
@@ -1125,9 +1019,8 @@ module Google
1125
1019
  include Google::Apis::Core::Hashable
1126
1020
 
1127
1021
  # Required. The network that the consumer is using to connect with services.
1128
- # Must be in the form of projects/`project`/global/networks/`network`
1129
- # `project` is a project number, as in '12345'
1130
- # `network` is network name.
1022
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
1023
+ # is a project number, as in '12345' `network` is network name.
1131
1024
  # Corresponds to the JSON property `consumerNetwork`
1132
1025
  # @return [String]
1133
1026
  attr_accessor :consumer_network
@@ -1190,9 +1083,9 @@ module Google
1190
1083
  # @return [String]
1191
1084
  attr_accessor :dns_suffix
1192
1085
 
1193
- # User assigned name for this resource. Must be unique within the project.
1194
- # The name must be 1-63 characters long, must begin with a letter, end with
1195
- # a letter or digit, and only contain lowercase letters, digits or dashes.
1086
+ # User assigned name for this resource. Must be unique within the project. The
1087
+ # name must be 1-63 characters long, must begin with a letter, end with a letter
1088
+ # or digit, and only contain lowercase letters, digits or dashes.
1196
1089
  # Corresponds to the JSON property `name`
1197
1090
  # @return [String]
1198
1091
  attr_accessor :name
@@ -1208,56 +1101,32 @@ module Google
1208
1101
  end
1209
1102
  end
1210
1103
 
1211
- # `Documentation` provides the information for describing a service.
1212
- # Example:
1213
- # <pre><code>documentation:
1214
- # summary: >
1215
- # The Google Calendar API gives access
1216
- # to most calendar features.
1217
- # pages:
1218
- # - name: Overview
1219
- # content: &#40;== include google/foo/overview.md ==&#41;
1220
- # - name: Tutorial
1221
- # content: &#40;== include google/foo/tutorial.md ==&#41;
1222
- # subpages;
1223
- # - name: Java
1224
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
1225
- # rules:
1226
- # - selector: google.calendar.Calendar.Get
1227
- # description: >
1228
- # ...
1229
- # - selector: google.calendar.Calendar.Put
1230
- # description: >
1231
- # ...
1232
- # </code></pre>
1233
- # Documentation is provided in markdown syntax. In addition to
1234
- # standard markdown features, definition lists, tables and fenced
1235
- # code blocks are supported. Section headers can be provided and are
1236
- # interpreted relative to the section nesting of the context where
1237
- # a documentation fragment is embedded.
1238
- # Documentation from the IDL is merged with documentation defined
1239
- # via the config at normalization time, where documentation provided
1240
- # by config rules overrides IDL provided.
1241
- # A number of constructs specific to the API platform are supported
1242
- # in documentation text.
1243
- # In order to reference a proto element, the following
1244
- # notation can be used:
1245
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
1246
- # To override the display text used for the link, this can be used:
1247
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
1248
- # Text can be excluded from doc using the following notation:
1249
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
1250
- # A few directives are available in documentation. Note that
1251
- # directives must appear on a single line to be properly
1252
- # identified. The `include` directive includes a markdown file from
1253
- # an external source:
1254
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
1255
- # The `resource_for` directive marks a message to be the resource of
1256
- # a collection in REST view. If it is not specified, tools attempt
1257
- # to infer the resource from the operations in a collection:
1258
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
1259
- # The directive `suppress_warning` does not directly affect documentation
1260
- # and is documented together with service config validation.
1104
+ # `Documentation` provides the information for describing a service. Example:
1105
+ # documentation: summary: > The Google Calendar API gives access to most
1106
+ # calendar features. pages: - name: Overview content: (== include google/foo/
1107
+ # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
1108
+ # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
1109
+ # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
1110
+ # google.calendar.Calendar.Put description: > ... Documentation is provided in
1111
+ # markdown syntax. In addition to standard markdown features, definition lists,
1112
+ # tables and fenced code blocks are supported. Section headers can be provided
1113
+ # and are interpreted relative to the section nesting of the context where a
1114
+ # documentation fragment is embedded. Documentation from the IDL is merged with
1115
+ # documentation defined via the config at normalization time, where
1116
+ # documentation provided by config rules overrides IDL provided. A number of
1117
+ # constructs specific to the API platform are supported in documentation text.
1118
+ # In order to reference a proto element, the following notation can be used: [
1119
+ # fully.qualified.proto.name][] To override the display text used for the link,
1120
+ # this can be used: [display text][fully.qualified.proto.name] Text can be
1121
+ # excluded from doc using the following notation: (-- internal comment --) A few
1122
+ # directives are available in documentation. Note that directives must appear on
1123
+ # a single line to be properly identified. The `include` directive includes a
1124
+ # markdown file from an external source: (== include path/to/file ==) The `
1125
+ # resource_for` directive marks a message to be the resource of a collection in
1126
+ # REST view. If it is not specified, tools attempt to infer the resource from
1127
+ # the operations in a collection: (== resource_for v1.shelves.books ==) The
1128
+ # directive `suppress_warning` does not directly affect documentation and is
1129
+ # documented together with service config validation.
1261
1130
  class Documentation
1262
1131
  include Google::Apis::Core::Hashable
1263
1132
 
@@ -1266,19 +1135,11 @@ module Google
1266
1135
  # @return [String]
1267
1136
  attr_accessor :documentation_root_url
1268
1137
 
1269
- # Declares a single overview page. For example:
1270
- # <pre><code>documentation:
1271
- # summary: ...
1272
- # overview: &#40;== include overview.md ==&#41;
1273
- # </code></pre>
1274
- # This is a shortcut for the following declaration (using pages style):
1275
- # <pre><code>documentation:
1276
- # summary: ...
1277
- # pages:
1278
- # - name: Overview
1279
- # content: &#40;== include overview.md ==&#41;
1280
- # </code></pre>
1281
- # Note: you cannot specify both `overview` field and `pages` field.
1138
+ # Declares a single overview page. For example: documentation: summary: ...
1139
+ # overview: (== include overview.md ==) This is a shortcut for the following
1140
+ # declaration (using pages style): documentation: summary: ... pages: - name:
1141
+ # Overview content: (== include overview.md ==) Note: you cannot specify both `
1142
+ # overview` field and `pages` field.
1282
1143
  # Corresponds to the JSON property `overview`
1283
1144
  # @return [String]
1284
1145
  attr_accessor :overview
@@ -1288,22 +1149,20 @@ module Google
1288
1149
  # @return [Array<Google::Apis::ServicenetworkingV1::Page>]
1289
1150
  attr_accessor :pages
1290
1151
 
1291
- # A list of documentation rules that apply to individual API elements.
1292
- # **NOTE:** All service configuration rules follow "last one wins" order.
1152
+ # A list of documentation rules that apply to individual API elements. **NOTE:**
1153
+ # All service configuration rules follow "last one wins" order.
1293
1154
  # Corresponds to the JSON property `rules`
1294
1155
  # @return [Array<Google::Apis::ServicenetworkingV1::DocumentationRule>]
1295
1156
  attr_accessor :rules
1296
1157
 
1297
- # Specifies the service root url if the default one (the service name
1298
- # from the yaml file) is not suitable. This can be seen in any fully
1299
- # specified service urls as well as sections that show a base that other
1300
- # urls are relative to.
1158
+ # Specifies the service root url if the default one (the service name from the
1159
+ # yaml file) is not suitable. This can be seen in any fully specified service
1160
+ # urls as well as sections that show a base that other urls are relative to.
1301
1161
  # Corresponds to the JSON property `serviceRootUrl`
1302
1162
  # @return [String]
1303
1163
  attr_accessor :service_root_url
1304
1164
 
1305
- # A short summary of what the service does. Can only be provided by
1306
- # plain text.
1165
+ # A short summary of what the service does. Can only be provided by plain text.
1307
1166
  # Corresponds to the JSON property `summary`
1308
1167
  # @return [String]
1309
1168
  attr_accessor :summary
@@ -1327,8 +1186,8 @@ module Google
1327
1186
  class DocumentationRule
1328
1187
  include Google::Apis::Core::Hashable
1329
1188
 
1330
- # Deprecation description of the selected element(s). It can be provided if
1331
- # an element is marked as `deprecated`.
1189
+ # Deprecation description of the selected element(s). It can be provided if an
1190
+ # element is marked as `deprecated`.
1332
1191
  # Corresponds to the JSON property `deprecationDescription`
1333
1192
  # @return [String]
1334
1193
  attr_accessor :deprecation_description
@@ -1360,13 +1219,11 @@ module Google
1360
1219
  end
1361
1220
  end
1362
1221
 
1363
- # A generic empty message that you can re-use to avoid defining duplicated
1364
- # empty messages in your APIs. A typical example is to use it as the request
1365
- # or the response type of an API method. For instance:
1366
- # service Foo `
1367
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
1368
- # `
1369
- # The JSON representation for `Empty` is empty JSON object ````.
1222
+ # A generic empty message that you can re-use to avoid defining duplicated empty
1223
+ # messages in your APIs. A typical example is to use it as the request or the
1224
+ # response type of an API method. For instance: service Foo ` rpc Bar(google.
1225
+ # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
1226
+ # `Empty` is empty JSON object ````.
1370
1227
  class Empty
1371
1228
  include Google::Apis::Core::Hashable
1372
1229
 
@@ -1384,9 +1241,8 @@ module Google
1384
1241
  include Google::Apis::Core::Hashable
1385
1242
 
1386
1243
  # Required. The network that the consumer is using to connect with services.
1387
- # Must be in the form of projects/`project`/global/networks/`network`
1388
- # `project` is a project number, as in '12345'
1389
- # `network` is network name.
1244
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
1245
+ # is a project number, as in '12345' `network` is network name.
1390
1246
  # Corresponds to the JSON property `consumerNetwork`
1391
1247
  # @return [String]
1392
1248
  attr_accessor :consumer_network
@@ -1401,35 +1257,28 @@ module Google
1401
1257
  end
1402
1258
  end
1403
1259
 
1404
- # `Endpoint` describes a network endpoint that serves a set of APIs.
1405
- # A service may expose any number of endpoints, and all endpoints share the
1406
- # same service configuration, such as quota configuration and monitoring
1407
- # configuration.
1408
- # Example service configuration:
1409
- # name: library-example.googleapis.com
1410
- # endpoints:
1411
- # # Below entry makes 'google.example.library.v1.Library'
1412
- # # API be served from endpoint address library-example.googleapis.com.
1413
- # # It also allows HTTP OPTIONS calls to be passed to the backend, for
1414
- # # it to decide whether the subsequent cross-origin request is
1415
- # # allowed to proceed.
1416
- # - name: library-example.googleapis.com
1417
- # allow_cors: true
1260
+ # `Endpoint` describes a network endpoint that serves a set of APIs. A service
1261
+ # may expose any number of endpoints, and all endpoints share the same service
1262
+ # configuration, such as quota configuration and monitoring configuration.
1263
+ # Example service configuration: name: library-example.googleapis.com endpoints:
1264
+ # # Below entry makes 'google.example.library.v1.Library' # API be served from
1265
+ # endpoint address library-example.googleapis.com. # It also allows HTTP OPTIONS
1266
+ # calls to be passed to the backend, for # it to decide whether the subsequent
1267
+ # cross-origin request is # allowed to proceed. - name: library-example.
1268
+ # googleapis.com allow_cors: true
1418
1269
  class Endpoint
1419
1270
  include Google::Apis::Core::Hashable
1420
1271
 
1421
1272
  # DEPRECATED: This field is no longer supported. Instead of using aliases,
1422
- # please specify multiple google.api.Endpoint for each of the intended
1423
- # aliases.
1273
+ # please specify multiple google.api.Endpoint for each of the intended aliases.
1424
1274
  # Additional names that this endpoint will be hosted on.
1425
1275
  # Corresponds to the JSON property `aliases`
1426
1276
  # @return [Array<String>]
1427
1277
  attr_accessor :aliases
1428
1278
 
1429
- # Allowing
1430
- # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
1431
- # cross-domain traffic, would allow the backends served from this endpoint to
1432
- # receive and respond to HTTP OPTIONS requests. The response will be used by
1279
+ # Allowing [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing),
1280
+ # aka cross-domain traffic, would allow the backends served from this endpoint
1281
+ # to receive and respond to HTTP OPTIONS requests. The response will be used by
1433
1282
  # the browser to determine whether the subsequent cross-origin request is
1434
1283
  # allowed to proceed.
1435
1284
  # Corresponds to the JSON property `allowCors`
@@ -1443,10 +1292,9 @@ module Google
1443
1292
  attr_accessor :name
1444
1293
 
1445
1294
  # The specification of an Internet routable address of API frontend that will
1446
- # handle requests to this [API
1447
- # Endpoint](https://cloud.google.com/apis/design/glossary). It should be
1448
- # either a valid IPv4 address or a fully-qualified domain name. For example,
1449
- # "8.8.8.8" or "myservice.appspot.com".
1295
+ # handle requests to this [API Endpoint](https://cloud.google.com/apis/design/
1296
+ # glossary). It should be either a valid IPv4 address or a fully-qualified
1297
+ # domain name. For example, "8.8.8.8" or "myservice.appspot.com".
1450
1298
  # Corresponds to the JSON property `target`
1451
1299
  # @return [String]
1452
1300
  attr_accessor :target
@@ -1483,8 +1331,8 @@ module Google
1483
1331
  # @return [Array<Google::Apis::ServicenetworkingV1::Option>]
1484
1332
  attr_accessor :options
1485
1333
 
1486
- # `SourceContext` represents information about the source of a
1487
- # protobuf element, like the file in which it is defined.
1334
+ # `SourceContext` represents information about the source of a protobuf element,
1335
+ # like the file in which it is defined.
1488
1336
  # Corresponds to the JSON property `sourceContext`
1489
1337
  # @return [Google::Apis::ServicenetworkingV1::SourceContext]
1490
1338
  attr_accessor :source_context
@@ -1573,8 +1421,8 @@ module Google
1573
1421
  # @return [Fixnum]
1574
1422
  attr_accessor :number
1575
1423
 
1576
- # The index of the field type in `Type.oneofs`, for message or enumeration
1577
- # types. The first type has index 1; zero means the type is not in the list.
1424
+ # The index of the field type in `Type.oneofs`, for message or enumeration types.
1425
+ # The first type has index 1; zero means the type is not in the list.
1578
1426
  # Corresponds to the JSON property `oneofIndex`
1579
1427
  # @return [Fixnum]
1580
1428
  attr_accessor :oneof_index
@@ -1590,8 +1438,8 @@ module Google
1590
1438
  attr_accessor :packed
1591
1439
  alias_method :packed?, :packed
1592
1440
 
1593
- # The field type URL, without the scheme, for message or enumeration
1594
- # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
1441
+ # The field type URL, without the scheme, for message or enumeration types.
1442
+ # Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
1595
1443
  # Corresponds to the JSON property `typeUrl`
1596
1444
  # @return [String]
1597
1445
  attr_accessor :type_url
@@ -1625,21 +1473,19 @@ module Google
1625
1473
  # @return [String]
1626
1474
  attr_accessor :ip_cidr_range
1627
1475
 
1628
- # Subnetwork name.
1629
- # See https://cloud.google.com/compute/docs/vpc/
1476
+ # Subnetwork name. See https://cloud.google.com/compute/docs/vpc/
1630
1477
  # Corresponds to the JSON property `name`
1631
1478
  # @return [String]
1632
1479
  attr_accessor :name
1633
1480
 
1634
1481
  # In the Shared VPC host project, the VPC network that's peered with the
1635
- # consumer network. For example:
1636
- # `projects/1234321/global/networks/host-network`
1482
+ # consumer network. For example: `projects/1234321/global/networks/host-network`
1637
1483
  # Corresponds to the JSON property `network`
1638
1484
  # @return [String]
1639
1485
  attr_accessor :network
1640
1486
 
1641
- # This is a discovered subnet that is not within the current consumer
1642
- # allocated ranges.
1487
+ # This is a discovered subnet that is not within the current consumer allocated
1488
+ # ranges.
1643
1489
  # Corresponds to the JSON property `outsideAllocation`
1644
1490
  # @return [Boolean]
1645
1491
  attr_accessor :outside_allocation
@@ -1659,23 +1505,22 @@ module Google
1659
1505
  end
1660
1506
 
1661
1507
  # Defines the HTTP configuration for an API service. It contains a list of
1662
- # HttpRule, each specifying the mapping of an RPC method
1663
- # to one or more HTTP REST API methods.
1508
+ # HttpRule, each specifying the mapping of an RPC method to one or more HTTP
1509
+ # REST API methods.
1664
1510
  class Http
1665
1511
  include Google::Apis::Core::Hashable
1666
1512
 
1667
1513
  # When set to true, URL path parameters will be fully URI-decoded except in
1668
1514
  # cases of single segment matches in reserved expansion, where "%2F" will be
1669
- # left encoded.
1670
- # The default behavior is to not decode RFC 6570 reserved characters in multi
1671
- # segment matches.
1515
+ # left encoded. The default behavior is to not decode RFC 6570 reserved
1516
+ # characters in multi segment matches.
1672
1517
  # Corresponds to the JSON property `fullyDecodeReservedExpansion`
1673
1518
  # @return [Boolean]
1674
1519
  attr_accessor :fully_decode_reserved_expansion
1675
1520
  alias_method :fully_decode_reserved_expansion?, :fully_decode_reserved_expansion
1676
1521
 
1677
- # A list of HTTP configuration rules that apply to individual API methods.
1678
- # **NOTE:** All service configuration rules follow "last one wins" order.
1522
+ # A list of HTTP configuration rules that apply to individual API methods. **
1523
+ # NOTE:** All service configuration rules follow "last one wins" order.
1679
1524
  # Corresponds to the JSON property `rules`
1680
1525
  # @return [Array<Google::Apis::ServicenetworkingV1::HttpRule>]
1681
1526
  attr_accessor :rules
@@ -1691,251 +1536,156 @@ module Google
1691
1536
  end
1692
1537
  end
1693
1538
 
1694
- # # gRPC Transcoding
1695
- # gRPC Transcoding is a feature for mapping between a gRPC method and one or
1696
- # more HTTP REST endpoints. It allows developers to build a single API service
1697
- # that supports both gRPC APIs and REST APIs. Many systems, including [Google
1698
- # APIs](https://github.com/googleapis/googleapis),
1699
- # [Cloud Endpoints](https://cloud.google.com/endpoints), [gRPC
1700
- # Gateway](https://github.com/grpc-ecosystem/grpc-gateway),
1701
- # and [Envoy](https://github.com/envoyproxy/envoy) proxy support this feature
1702
- # and use it for large scale production services.
1703
- # `HttpRule` defines the schema of the gRPC/REST mapping. The mapping specifies
1704
- # how different portions of the gRPC request message are mapped to the URL
1705
- # path, URL query parameters, and HTTP request body. It also controls how the
1706
- # gRPC response message is mapped to the HTTP response body. `HttpRule` is
1539
+ # # gRPC Transcoding gRPC Transcoding is a feature for mapping between a gRPC
1540
+ # method and one or more HTTP REST endpoints. It allows developers to build a
1541
+ # single API service that supports both gRPC APIs and REST APIs. Many systems,
1542
+ # including [Google APIs](https://github.com/googleapis/googleapis), [Cloud
1543
+ # Endpoints](https://cloud.google.com/endpoints), [gRPC Gateway](https://github.
1544
+ # com/grpc-ecosystem/grpc-gateway), and [Envoy](https://github.com/envoyproxy/
1545
+ # envoy) proxy support this feature and use it for large scale production
1546
+ # services. `HttpRule` defines the schema of the gRPC/REST mapping. The mapping
1547
+ # specifies how different portions of the gRPC request message are mapped to the
1548
+ # URL path, URL query parameters, and HTTP request body. It also controls how
1549
+ # the gRPC response message is mapped to the HTTP response body. `HttpRule` is
1707
1550
  # typically specified as an `google.api.http` annotation on the gRPC method.
1708
1551
  # Each mapping specifies a URL path template and an HTTP method. The path
1709
1552
  # template may refer to one or more fields in the gRPC request message, as long
1710
- # as each field is a non-repeated field with a primitive (non-message) type.
1711
- # The path template controls how fields of the request message are mapped to
1712
- # the URL path.
1713
- # Example:
1714
- # service Messaging `
1715
- # rpc GetMessage(GetMessageRequest) returns (Message) `
1716
- # option (google.api.http) = `
1717
- # get: "/v1/`name=messages/*`"
1718
- # `;
1719
- # `
1720
- # `
1721
- # message GetMessageRequest `
1722
- # string name = 1; // Mapped to URL path.
1723
- # `
1724
- # message Message `
1725
- # string text = 1; // The resource content.
1726
- # `
1727
- # This enables an HTTP REST to gRPC mapping as below:
1728
- # HTTP | gRPC
1729
- # -----|-----
1730
- # `GET /v1/messages/123456` | `GetMessage(name: "messages/123456")`
1731
- # Any fields in the request message which are not bound by the path template
1732
- # automatically become HTTP query parameters if there is no HTTP request body.
1733
- # For example:
1734
- # service Messaging `
1735
- # rpc GetMessage(GetMessageRequest) returns (Message) `
1736
- # option (google.api.http) = `
1737
- # get:"/v1/messages/`message_id`"
1738
- # `;
1739
- # `
1740
- # `
1741
- # message GetMessageRequest `
1742
- # message SubMessage `
1743
- # string subfield = 1;
1744
- # `
1745
- # string message_id = 1; // Mapped to URL path.
1746
- # int64 revision = 2; // Mapped to URL query parameter `revision`.
1747
- # SubMessage sub = 3; // Mapped to URL query parameter `sub.subfield`.
1748
- # `
1749
- # This enables a HTTP JSON to RPC mapping as below:
1750
- # HTTP | gRPC
1751
- # -----|-----
1752
- # `GET /v1/messages/123456?revision=2&sub.subfield=foo` |
1753
- # `GetMessage(message_id: "123456" revision: 2 sub: SubMessage(subfield:
1754
- # "foo"))`
1755
- # Note that fields which are mapped to URL query parameters must have a
1756
- # primitive type or a repeated primitive type or a non-repeated message type.
1757
- # In the case of a repeated type, the parameter can be repeated in the URL
1758
- # as `...?param=A&param=B`. In the case of a message type, each field of the
1759
- # message is mapped to a separate parameter, such as
1760
- # `...?foo.a=A&foo.b=B&foo.c=C`.
1761
- # For HTTP methods that allow a request body, the `body` field
1762
- # specifies the mapping. Consider a REST update method on the
1763
- # message resource collection:
1764
- # service Messaging `
1765
- # rpc UpdateMessage(UpdateMessageRequest) returns (Message) `
1766
- # option (google.api.http) = `
1767
- # patch: "/v1/messages/`message_id`"
1768
- # body: "message"
1769
- # `;
1770
- # `
1771
- # `
1772
- # message UpdateMessageRequest `
1773
- # string message_id = 1; // mapped to the URL
1774
- # Message message = 2; // mapped to the body
1775
- # `
1776
- # The following HTTP JSON to RPC mapping is enabled, where the
1777
- # representation of the JSON in the request body is determined by
1778
- # protos JSON encoding:
1779
- # HTTP | gRPC
1780
- # -----|-----
1781
- # `PATCH /v1/messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id:
1782
- # "123456" message ` text: "Hi!" `)`
1783
- # The special name `*` can be used in the body mapping to define that
1784
- # every field not bound by the path template should be mapped to the
1785
- # request body. This enables the following alternative definition of
1786
- # the update method:
1787
- # service Messaging `
1788
- # rpc UpdateMessage(Message) returns (Message) `
1789
- # option (google.api.http) = `
1790
- # patch: "/v1/messages/`message_id`"
1791
- # body: "*"
1792
- # `;
1793
- # `
1794
- # `
1795
- # message Message `
1796
- # string message_id = 1;
1797
- # string text = 2;
1798
- # `
1799
- # The following HTTP JSON to RPC mapping is enabled:
1800
- # HTTP | gRPC
1801
- # -----|-----
1802
- # `PATCH /v1/messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id:
1803
- # "123456" text: "Hi!")`
1804
- # Note that when using `*` in the body mapping, it is not possible to
1805
- # have HTTP parameters, as all fields not bound by the path end in
1806
- # the body. This makes this option more rarely used in practice when
1807
- # defining REST APIs. The common usage of `*` is in custom methods
1808
- # which don't use the URL at all for transferring data.
1809
- # It is possible to define multiple HTTP methods for one RPC by using
1810
- # the `additional_bindings` option. Example:
1811
- # service Messaging `
1812
- # rpc GetMessage(GetMessageRequest) returns (Message) `
1813
- # option (google.api.http) = `
1814
- # get: "/v1/messages/`message_id`"
1815
- # additional_bindings `
1816
- # get: "/v1/users/`user_id`/messages/`message_id`"
1817
- # `
1818
- # `;
1819
- # `
1820
- # `
1821
- # message GetMessageRequest `
1822
- # string message_id = 1;
1823
- # string user_id = 2;
1824
- # `
1825
- # This enables the following two alternative HTTP JSON to RPC mappings:
1826
- # HTTP | gRPC
1827
- # -----|-----
1828
- # `GET /v1/messages/123456` | `GetMessage(message_id: "123456")`
1829
- # `GET /v1/users/me/messages/123456` | `GetMessage(user_id: "me" message_id:
1830
- # "123456")`
1831
- # ## Rules for HTTP mapping
1832
- # 1. Leaf request fields (recursive expansion nested messages in the request
1833
- # message) are classified into three categories:
1834
- # - Fields referred by the path template. They are passed via the URL path.
1835
- # - Fields referred by the HttpRule.body. They are passed via the HTTP
1836
- # request body.
1837
- # - All other fields are passed via the URL query parameters, and the
1838
- # parameter name is the field path in the request message. A repeated
1839
- # field can be represented as multiple query parameters under the same
1840
- # name.
1841
- # 2. If HttpRule.body is "*", there is no URL query parameter, all fields
1842
- # are passed via URL path and HTTP request body.
1843
- # 3. If HttpRule.body is omitted, there is no HTTP request body, all
1844
- # fields are passed via URL path and URL query parameters.
1845
- # ### Path template syntax
1846
- # Template = "/" Segments [ Verb ] ;
1847
- # Segments = Segment ` "/" Segment ` ;
1848
- # Segment = "*" | "**" | LITERAL | Variable ;
1849
- # Variable = "`" FieldPath [ "=" Segments ] "`" ;
1850
- # FieldPath = IDENT ` "." IDENT ` ;
1851
- # Verb = ":" LITERAL ;
1852
- # The syntax `*` matches a single URL path segment. The syntax `**` matches
1853
- # zero or more URL path segments, which must be the last part of the URL path
1854
- # except the `Verb`.
1855
- # The syntax `Variable` matches part of the URL path as specified by its
1856
- # template. A variable template must not contain other variables. If a variable
1857
- # matches a single path segment, its template may be omitted, e.g. ``var``
1858
- # is equivalent to ``var=*``.
1859
- # The syntax `LITERAL` matches literal text in the URL path. If the `LITERAL`
1860
- # contains any reserved character, such characters should be percent-encoded
1861
- # before the matching.
1862
- # If a variable contains exactly one path segment, such as `"`var`"` or
1863
- # `"`var=*`"`, when such a variable is expanded into a URL path on the client
1864
- # side, all characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The
1865
- # server side does the reverse decoding. Such variables show up in the
1866
- # [Discovery
1867
- # Document](https://developers.google.com/discovery/v1/reference/apis) as
1868
- # ``var``.
1869
- # If a variable contains multiple path segments, such as `"`var=foo/*`"`
1870
- # or `"`var=**`"`, when such a variable is expanded into a URL path on the
1871
- # client side, all characters except `[-_.~/0-9a-zA-Z]` are percent-encoded.
1872
- # The server side does the reverse decoding, except "%2F" and "%2f" are left
1873
- # unchanged. Such variables show up in the
1874
- # [Discovery
1875
- # Document](https://developers.google.com/discovery/v1/reference/apis) as
1876
- # ``+var``.
1877
- # ## Using gRPC API Service Configuration
1878
- # gRPC API Service Configuration (service config) is a configuration language
1879
- # for configuring a gRPC service to become a user-facing product. The
1880
- # service config is simply the YAML representation of the `google.api.Service`
1881
- # proto message.
1553
+ # as each field is a non-repeated field with a primitive (non-message) type. The
1554
+ # path template controls how fields of the request message are mapped to the URL
1555
+ # path. Example: service Messaging ` rpc GetMessage(GetMessageRequest) returns (
1556
+ # Message) ` option (google.api.http) = ` get: "/v1/`name=messages/*`" `; ` `
1557
+ # message GetMessageRequest ` string name = 1; // Mapped to URL path. ` message
1558
+ # Message ` string text = 1; // The resource content. ` This enables an HTTP
1559
+ # REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET /v1/messages/
1560
+ # 123456` | `GetMessage(name: "messages/123456")` Any fields in the request
1561
+ # message which are not bound by the path template automatically become HTTP
1562
+ # query parameters if there is no HTTP request body. For example: service
1563
+ # Messaging ` rpc GetMessage(GetMessageRequest) returns (Message) ` option (
1564
+ # google.api.http) = ` get:"/v1/messages/`message_id`" `; ` ` message
1565
+ # GetMessageRequest ` message SubMessage ` string subfield = 1; ` string
1566
+ # message_id = 1; // Mapped to URL path. int64 revision = 2; // Mapped to URL
1567
+ # query parameter `revision`. SubMessage sub = 3; // Mapped to URL query
1568
+ # parameter `sub.subfield`. ` This enables a HTTP JSON to RPC mapping as below:
1569
+ # HTTP | gRPC -----|----- `GET /v1/messages/123456?revision=2&sub.subfield=foo` |
1570
+ # `GetMessage(message_id: "123456" revision: 2 sub: SubMessage(subfield: "foo"))
1571
+ # ` Note that fields which are mapped to URL query parameters must have a
1572
+ # primitive type or a repeated primitive type or a non-repeated message type. In
1573
+ # the case of a repeated type, the parameter can be repeated in the URL as `...?
1574
+ # param=A&param=B`. In the case of a message type, each field of the message is
1575
+ # mapped to a separate parameter, such as `...?foo.a=A&foo.b=B&foo.c=C`. For
1576
+ # HTTP methods that allow a request body, the `body` field specifies the mapping.
1577
+ # Consider a REST update method on the message resource collection: service
1578
+ # Messaging ` rpc UpdateMessage(UpdateMessageRequest) returns (Message) ` option
1579
+ # (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "message" `; ` `
1580
+ # message UpdateMessageRequest ` string message_id = 1; // mapped to the URL
1581
+ # Message message = 2; // mapped to the body ` The following HTTP JSON to RPC
1582
+ # mapping is enabled, where the representation of the JSON in the request body
1583
+ # is determined by protos JSON encoding: HTTP | gRPC -----|----- `PATCH /v1/
1584
+ # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456"
1585
+ # message ` text: "Hi!" `)` The special name `*` can be used in the body mapping
1586
+ # to define that every field not bound by the path template should be mapped to
1587
+ # the request body. This enables the following alternative definition of the
1588
+ # update method: service Messaging ` rpc UpdateMessage(Message) returns (Message)
1589
+ # ` option (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "*" `;
1590
+ # ` ` message Message ` string message_id = 1; string text = 2; ` The following
1591
+ # HTTP JSON to RPC mapping is enabled: HTTP | gRPC -----|----- `PATCH /v1/
1592
+ # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456" text:
1593
+ # "Hi!")` Note that when using `*` in the body mapping, it is not possible to
1594
+ # have HTTP parameters, as all fields not bound by the path end in the body.
1595
+ # This makes this option more rarely used in practice when defining REST APIs.
1596
+ # The common usage of `*` is in custom methods which don't use the URL at all
1597
+ # for transferring data. It is possible to define multiple HTTP methods for one
1598
+ # RPC by using the `additional_bindings` option. Example: service Messaging `
1599
+ # rpc GetMessage(GetMessageRequest) returns (Message) ` option (google.api.http)
1600
+ # = ` get: "/v1/messages/`message_id`" additional_bindings ` get: "/v1/users/`
1601
+ # user_id`/messages/`message_id`" ` `; ` ` message GetMessageRequest ` string
1602
+ # message_id = 1; string user_id = 2; ` This enables the following two
1603
+ # alternative HTTP JSON to RPC mappings: HTTP | gRPC -----|----- `GET /v1/
1604
+ # messages/123456` | `GetMessage(message_id: "123456")` `GET /v1/users/me/
1605
+ # messages/123456` | `GetMessage(user_id: "me" message_id: "123456")` ## Rules
1606
+ # for HTTP mapping 1. Leaf request fields (recursive expansion nested messages
1607
+ # in the request message) are classified into three categories: - Fields
1608
+ # referred by the path template. They are passed via the URL path. - Fields
1609
+ # referred by the HttpRule.body. They are passed via the HTTP request body. -
1610
+ # All other fields are passed via the URL query parameters, and the parameter
1611
+ # name is the field path in the request message. A repeated field can be
1612
+ # represented as multiple query parameters under the same name. 2. If HttpRule.
1613
+ # body is "*", there is no URL query parameter, all fields are passed via URL
1614
+ # path and HTTP request body. 3. If HttpRule.body is omitted, there is no HTTP
1615
+ # request body, all fields are passed via URL path and URL query parameters. ###
1616
+ # Path template syntax Template = "/" Segments [ Verb ] ; Segments = Segment ` "/
1617
+ # " Segment ` ; Segment = "*" | "**" | LITERAL | Variable ; Variable = "`"
1618
+ # FieldPath [ "=" Segments ] "`" ; FieldPath = IDENT ` "." IDENT ` ; Verb = ":"
1619
+ # LITERAL ; The syntax `*` matches a single URL path segment. The syntax `**`
1620
+ # matches zero or more URL path segments, which must be the last part of the URL
1621
+ # path except the `Verb`. The syntax `Variable` matches part of the URL path as
1622
+ # specified by its template. A variable template must not contain other
1623
+ # variables. If a variable matches a single path segment, its template may be
1624
+ # omitted, e.g. ``var`` is equivalent to ``var=*``. The syntax `LITERAL` matches
1625
+ # literal text in the URL path. If the `LITERAL` contains any reserved character,
1626
+ # such characters should be percent-encoded before the matching. If a variable
1627
+ # contains exactly one path segment, such as `"`var`"` or `"`var=*`"`, when such
1628
+ # a variable is expanded into a URL path on the client side, all characters
1629
+ # except `[-_.~0-9a-zA-Z]` are percent-encoded. The server side does the reverse
1630
+ # decoding. Such variables show up in the [Discovery Document](https://
1631
+ # developers.google.com/discovery/v1/reference/apis) as ``var``. If a variable
1632
+ # contains multiple path segments, such as `"`var=foo/*`"` or `"`var=**`"`, when
1633
+ # such a variable is expanded into a URL path on the client side, all characters
1634
+ # except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the
1635
+ # reverse decoding, except "%2F" and "%2f" are left unchanged. Such variables
1636
+ # show up in the [Discovery Document](https://developers.google.com/discovery/v1/
1637
+ # reference/apis) as ``+var``. ## Using gRPC API Service Configuration gRPC API
1638
+ # Service Configuration (service config) is a configuration language for
1639
+ # configuring a gRPC service to become a user-facing product. The service config
1640
+ # is simply the YAML representation of the `google.api.Service` proto message.
1882
1641
  # As an alternative to annotating your proto file, you can configure gRPC
1883
- # transcoding in your service config YAML files. You do this by specifying a
1884
- # `HttpRule` that maps the gRPC method to a REST endpoint, achieving the same
1885
- # effect as the proto annotation. This can be particularly useful if you
1886
- # have a proto that is reused in multiple services. Note that any transcoding
1887
- # specified in the service config will override any matching transcoding
1888
- # configuration in the proto.
1889
- # Example:
1890
- # http:
1891
- # rules:
1892
- # # Selects a gRPC method and applies HttpRule to it.
1893
- # - selector: example.v1.Messaging.GetMessage
1894
- # get: /v1/messages/`message_id`/`sub.subfield`
1895
- # ## Special notes
1896
- # When gRPC Transcoding is used to map a gRPC to JSON REST endpoints, the
1897
- # proto to JSON conversion must follow the [proto3
1898
- # specification](https://developers.google.com/protocol-buffers/docs/proto3#json)
1899
- # .
1900
- # While the single segment variable follows the semantics of
1901
- # [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
1902
- # Expansion, the multi segment variable **does not** follow RFC 6570 Section
1903
- # 3.2.3 Reserved Expansion. The reason is that the Reserved Expansion
1904
- # does not expand special characters like `?` and `#`, which would lead
1905
- # to invalid URLs. As the result, gRPC Transcoding uses a custom encoding
1906
- # for multi segment variables.
1907
- # The path variables **must not** refer to any repeated or mapped field,
1908
- # because client libraries are not capable of handling such variable expansion.
1909
- # The path variables **must not** capture the leading "/" character. The reason
1910
- # is that the most common use case "`var`" does not capture the leading "/"
1911
- # character. For consistency, all path variables must share the same behavior.
1912
- # Repeated message fields must not be mapped to URL query parameters, because
1913
- # no client library can support such complicated mapping.
1914
- # If an API needs to use a JSON array for request or response body, it can map
1915
- # the request or response body to a repeated field. However, some gRPC
1916
- # Transcoding implementations may not support this feature.
1642
+ # transcoding in your service config YAML files. You do this by specifying a `
1643
+ # HttpRule` that maps the gRPC method to a REST endpoint, achieving the same
1644
+ # effect as the proto annotation. This can be particularly useful if you have a
1645
+ # proto that is reused in multiple services. Note that any transcoding specified
1646
+ # in the service config will override any matching transcoding configuration in
1647
+ # the proto. Example: http: rules: # Selects a gRPC method and applies HttpRule
1648
+ # to it. - selector: example.v1.Messaging.GetMessage get: /v1/messages/`
1649
+ # message_id`/`sub.subfield` ## Special notes When gRPC Transcoding is used to
1650
+ # map a gRPC to JSON REST endpoints, the proto to JSON conversion must follow
1651
+ # the [proto3 specification](https://developers.google.com/protocol-buffers/docs/
1652
+ # proto3#json). While the single segment variable follows the semantics of [RFC
1653
+ # 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
1654
+ # Expansion, the multi segment variable **does not** follow RFC 6570 Section 3.2.
1655
+ # 3 Reserved Expansion. The reason is that the Reserved Expansion does not
1656
+ # expand special characters like `?` and `#`, which would lead to invalid URLs.
1657
+ # As the result, gRPC Transcoding uses a custom encoding for multi segment
1658
+ # variables. The path variables **must not** refer to any repeated or mapped
1659
+ # field, because client libraries are not capable of handling such variable
1660
+ # expansion. The path variables **must not** capture the leading "/" character.
1661
+ # The reason is that the most common use case "`var`" does not capture the
1662
+ # leading "/" character. For consistency, all path variables must share the same
1663
+ # behavior. Repeated message fields must not be mapped to URL query parameters,
1664
+ # because no client library can support such complicated mapping. If an API
1665
+ # needs to use a JSON array for request or response body, it can map the request
1666
+ # or response body to a repeated field. However, some gRPC Transcoding
1667
+ # implementations may not support this feature.
1917
1668
  class HttpRule
1918
1669
  include Google::Apis::Core::Hashable
1919
1670
 
1920
- # Additional HTTP bindings for the selector. Nested bindings must
1921
- # not contain an `additional_bindings` field themselves (that is,
1922
- # the nesting may only be one level deep).
1671
+ # Additional HTTP bindings for the selector. Nested bindings must not contain an
1672
+ # `additional_bindings` field themselves (that is, the nesting may only be one
1673
+ # level deep).
1923
1674
  # Corresponds to the JSON property `additionalBindings`
1924
1675
  # @return [Array<Google::Apis::ServicenetworkingV1::HttpRule>]
1925
1676
  attr_accessor :additional_bindings
1926
1677
 
1927
- # When this flag is set to true, HTTP requests will be allowed to invoke a
1928
- # half-duplex streaming method.
1678
+ # When this flag is set to true, HTTP requests will be allowed to invoke a half-
1679
+ # duplex streaming method.
1929
1680
  # Corresponds to the JSON property `allowHalfDuplex`
1930
1681
  # @return [Boolean]
1931
1682
  attr_accessor :allow_half_duplex
1932
1683
  alias_method :allow_half_duplex?, :allow_half_duplex
1933
1684
 
1934
- # The name of the request field whose value is mapped to the HTTP request
1935
- # body, or `*` for mapping all request fields not captured by the path
1936
- # pattern to the HTTP body, or omitted for not having any HTTP request body.
1937
- # NOTE: the referred field must be present at the top-level of the request
1938
- # message type.
1685
+ # The name of the request field whose value is mapped to the HTTP request body,
1686
+ # or `*` for mapping all request fields not captured by the path pattern to the
1687
+ # HTTP body, or omitted for not having any HTTP request body. NOTE: the referred
1688
+ # field must be present at the top-level of the request message type.
1939
1689
  # Corresponds to the JSON property `body`
1940
1690
  # @return [String]
1941
1691
  attr_accessor :body
@@ -1950,8 +1700,7 @@ module Google
1950
1700
  # @return [String]
1951
1701
  attr_accessor :delete
1952
1702
 
1953
- # Maps to HTTP GET. Used for listing and getting information about
1954
- # resources.
1703
+ # Maps to HTTP GET. Used for listing and getting information about resources.
1955
1704
  # Corresponds to the JSON property `get`
1956
1705
  # @return [String]
1957
1706
  attr_accessor :get
@@ -1972,16 +1721,15 @@ module Google
1972
1721
  attr_accessor :put
1973
1722
 
1974
1723
  # Optional. The name of the response field whose value is mapped to the HTTP
1975
- # response body. When omitted, the entire response message will be used
1976
- # as the HTTP response body.
1977
- # NOTE: The referred field must be present at the top-level of the response
1978
- # message type.
1724
+ # response body. When omitted, the entire response message will be used as the
1725
+ # HTTP response body. NOTE: The referred field must be present at the top-level
1726
+ # of the response message type.
1979
1727
  # Corresponds to the JSON property `responseBody`
1980
1728
  # @return [String]
1981
1729
  attr_accessor :response_body
1982
1730
 
1983
- # Selects a method to which this rule applies.
1984
- # Refer to selector for syntax details.
1731
+ # Selects a method to which this rule applies. Refer to selector for syntax
1732
+ # details.
1985
1733
  # Corresponds to the JSON property `selector`
1986
1734
  # @return [String]
1987
1735
  attr_accessor :selector
@@ -2020,13 +1768,12 @@ module Google
2020
1768
  # @return [String]
2021
1769
  attr_accessor :query
2022
1770
 
2023
- # The value prefix. The value format is "value_prefix`token`"
2024
- # Only applies to "in" header type. Must be empty for "in" query type.
2025
- # If not empty, the header value has to match (case sensitive) this prefix.
2026
- # If not matched, JWT will not be extracted. If matched, JWT will be
2027
- # extracted after the prefix is removed.
2028
- # For example, for "Authorization: Bearer `JWT`",
2029
- # value_prefix="Bearer " with a space at the end.
1771
+ # The value prefix. The value format is "value_prefix`token`" Only applies to "
1772
+ # in" header type. Must be empty for "in" query type. If not empty, the header
1773
+ # value has to match (case sensitive) this prefix. If not matched, JWT will not
1774
+ # be extracted. If matched, JWT will be extracted after the prefix is removed.
1775
+ # For example, for "Authorization: Bearer `JWT`", value_prefix="Bearer " with a
1776
+ # space at the end.
2030
1777
  # Corresponds to the JSON property `valuePrefix`
2031
1778
  # @return [String]
2032
1779
  attr_accessor :value_prefix
@@ -2074,8 +1821,8 @@ module Google
2074
1821
  end
2075
1822
  end
2076
1823
 
2077
- # ListConnectionsResponse is the response to list peering states for the
2078
- # given service and consumer project.
1824
+ # ListConnectionsResponse is the response to list peering states for the given
1825
+ # service and consumer project.
2079
1826
  class ListConnectionsResponse
2080
1827
  include Google::Apis::Core::Hashable
2081
1828
 
@@ -2119,39 +1866,35 @@ module Google
2119
1866
  end
2120
1867
  end
2121
1868
 
2122
- # A description of a log type. Example in YAML format:
2123
- # - name: library.googleapis.com/activity_history
2124
- # description: The history of borrowing and returning library items.
2125
- # display_name: Activity
2126
- # labels:
2127
- # - key: /customer_id
1869
+ # A description of a log type. Example in YAML format: - name: library.
1870
+ # googleapis.com/activity_history description: The history of borrowing and
1871
+ # returning library items. display_name: Activity labels: - key: /customer_id
2128
1872
  # description: Identifier of a library customer
2129
1873
  class LogDescriptor
2130
1874
  include Google::Apis::Core::Hashable
2131
1875
 
2132
- # A human-readable description of this log. This information appears in
2133
- # the documentation and can contain details.
1876
+ # A human-readable description of this log. This information appears in the
1877
+ # documentation and can contain details.
2134
1878
  # Corresponds to the JSON property `description`
2135
1879
  # @return [String]
2136
1880
  attr_accessor :description
2137
1881
 
2138
- # The human-readable name for this log. This information appears on
2139
- # the user interface and should be concise.
1882
+ # The human-readable name for this log. This information appears on the user
1883
+ # interface and should be concise.
2140
1884
  # Corresponds to the JSON property `displayName`
2141
1885
  # @return [String]
2142
1886
  attr_accessor :display_name
2143
1887
 
2144
- # The set of labels that are available to describe a specific log entry.
2145
- # Runtime requests that contain labels not specified here are
2146
- # considered invalid.
1888
+ # The set of labels that are available to describe a specific log entry. Runtime
1889
+ # requests that contain labels not specified here are considered invalid.
2147
1890
  # Corresponds to the JSON property `labels`
2148
1891
  # @return [Array<Google::Apis::ServicenetworkingV1::LabelDescriptor>]
2149
1892
  attr_accessor :labels
2150
1893
 
2151
- # The name of the log. It must be less than 512 characters long and can
2152
- # include the following characters: upper- and lower-case alphanumeric
2153
- # characters [A-Za-z0-9], and punctuation characters including
2154
- # slash, underscore, hyphen, period [/_-.].
1894
+ # The name of the log. It must be less than 512 characters long and can include
1895
+ # the following characters: upper- and lower-case alphanumeric characters [A-Za-
1896
+ # z0-9], and punctuation characters including slash, underscore, hyphen, period [
1897
+ # /_-.].
2155
1898
  # Corresponds to the JSON property `name`
2156
1899
  # @return [String]
2157
1900
  attr_accessor :name
@@ -2169,48 +1912,30 @@ module Google
2169
1912
  end
2170
1913
  end
2171
1914
 
2172
- # Logging configuration of the service.
2173
- # The following example shows how to configure logs to be sent to the
2174
- # producer and consumer projects. In the example, the `activity_history`
2175
- # log is sent to both the producer and consumer projects, whereas the
2176
- # `purchase_history` log is only sent to the producer project.
2177
- # monitored_resources:
2178
- # - type: library.googleapis.com/branch
2179
- # labels:
2180
- # - key: /city
2181
- # description: The city where the library branch is located in.
2182
- # - key: /name
2183
- # description: The name of the branch.
2184
- # logs:
2185
- # - name: activity_history
2186
- # labels:
2187
- # - key: /customer_id
2188
- # - name: purchase_history
2189
- # logging:
2190
- # producer_destinations:
2191
- # - monitored_resource: library.googleapis.com/branch
2192
- # logs:
2193
- # - activity_history
2194
- # - purchase_history
2195
- # consumer_destinations:
2196
- # - monitored_resource: library.googleapis.com/branch
2197
- # logs:
2198
- # - activity_history
1915
+ # Logging configuration of the service. The following example shows how to
1916
+ # configure logs to be sent to the producer and consumer projects. In the
1917
+ # example, the `activity_history` log is sent to both the producer and consumer
1918
+ # projects, whereas the `purchase_history` log is only sent to the producer
1919
+ # project. monitored_resources: - type: library.googleapis.com/branch labels: -
1920
+ # key: /city description: The city where the library branch is located in. - key:
1921
+ # /name description: The name of the branch. logs: - name: activity_history
1922
+ # labels: - key: /customer_id - name: purchase_history logging:
1923
+ # producer_destinations: - monitored_resource: library.googleapis.com/branch
1924
+ # logs: - activity_history - purchase_history consumer_destinations: -
1925
+ # monitored_resource: library.googleapis.com/branch logs: - activity_history
2199
1926
  class Logging
2200
1927
  include Google::Apis::Core::Hashable
2201
1928
 
2202
- # Logging configurations for sending logs to the consumer project.
2203
- # There can be multiple consumer destinations, each one must have a
2204
- # different monitored resource type. A log can be used in at most
2205
- # one consumer destination.
1929
+ # Logging configurations for sending logs to the consumer project. There can be
1930
+ # multiple consumer destinations, each one must have a different monitored
1931
+ # resource type. A log can be used in at most one consumer destination.
2206
1932
  # Corresponds to the JSON property `consumerDestinations`
2207
1933
  # @return [Array<Google::Apis::ServicenetworkingV1::LoggingDestination>]
2208
1934
  attr_accessor :consumer_destinations
2209
1935
 
2210
- # Logging configurations for sending logs to the producer project.
2211
- # There can be multiple producer destinations, each one must have a
2212
- # different monitored resource type. A log can be used in at most
2213
- # one producer destination.
1936
+ # Logging configurations for sending logs to the producer project. There can be
1937
+ # multiple producer destinations, each one must have a different monitored
1938
+ # resource type. A log can be used in at most one producer destination.
2214
1939
  # Corresponds to the JSON property `producerDestinations`
2215
1940
  # @return [Array<Google::Apis::ServicenetworkingV1::LoggingDestination>]
2216
1941
  attr_accessor :producer_destinations
@@ -2226,21 +1951,20 @@ module Google
2226
1951
  end
2227
1952
  end
2228
1953
 
2229
- # Configuration of a specific logging destination (the producer project
2230
- # or the consumer project).
1954
+ # Configuration of a specific logging destination (the producer project or the
1955
+ # consumer project).
2231
1956
  class LoggingDestination
2232
1957
  include Google::Apis::Core::Hashable
2233
1958
 
2234
- # Names of the logs to be sent to this destination. Each name must
2235
- # be defined in the Service.logs section. If the log name is
2236
- # not a domain scoped name, it will be automatically prefixed with
2237
- # the service name followed by "/".
1959
+ # Names of the logs to be sent to this destination. Each name must be defined in
1960
+ # the Service.logs section. If the log name is not a domain scoped name, it will
1961
+ # be automatically prefixed with the service name followed by "/".
2238
1962
  # Corresponds to the JSON property `logs`
2239
1963
  # @return [Array<String>]
2240
1964
  attr_accessor :logs
2241
1965
 
2242
- # The monitored resource type. The type must be defined in the
2243
- # Service.monitored_resources section.
1966
+ # The monitored resource type. The type must be defined in the Service.
1967
+ # monitored_resources section.
2244
1968
  # Corresponds to the JSON property `monitoredResource`
2245
1969
  # @return [String]
2246
1970
  attr_accessor :monitored_resource
@@ -2315,16 +2039,13 @@ module Google
2315
2039
 
2316
2040
  # Defines a metric type and its schema. Once a metric descriptor is created,
2317
2041
  # deleting or altering it stops data collection and makes the metric type's
2318
- # existing data unusable.
2319
- # The following are specific rules for service defined Monitoring metric
2320
- # descriptors:
2321
- # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
2322
- # `launch_stage` fields are all required. The `unit` field must be specified
2323
- # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
2324
- # * Maximum of default 500 metric descriptors per service is allowed.
2325
- # * Maximum of default 10 labels per metric descriptor is allowed.
2326
- # The default maximum limit can be overridden. Please follow
2327
- # https://cloud.google.com/monitoring/quotas
2042
+ # existing data unusable. The following are specific rules for service defined
2043
+ # Monitoring metric descriptors: * `type`, `metric_kind`, `value_type` and `
2044
+ # description` fields are all required. The `unit` field must be specified if
2045
+ # the `value_type` is any of DOUBLE, INT64, DISTRIBUTION. * Maximum of default
2046
+ # 500 metric descriptors per service is allowed. * Maximum of default 10 labels
2047
+ # per metric descriptor is allowed. The default maximum limit can be overridden.
2048
+ # Please follow https://cloud.google.com/monitoring/quotas
2328
2049
  class MetricDescriptor
2329
2050
  include Google::Apis::Core::Hashable
2330
2051
 
@@ -2333,26 +2054,21 @@ module Google
2333
2054
  # @return [String]
2334
2055
  attr_accessor :description
2335
2056
 
2336
- # A concise name for the metric, which can be displayed in user interfaces.
2337
- # Use sentence case without an ending period, for example "Request count".
2338
- # This field is optional but it is recommended to be set for any metrics
2339
- # associated with user-visible concepts, such as Quota.
2057
+ # A concise name for the metric, which can be displayed in user interfaces. Use
2058
+ # sentence case without an ending period, for example "Request count". This
2059
+ # field is optional but it is recommended to be set for any metrics associated
2060
+ # with user-visible concepts, such as Quota.
2340
2061
  # Corresponds to the JSON property `displayName`
2341
2062
  # @return [String]
2342
2063
  attr_accessor :display_name
2343
2064
 
2344
- # The set of labels that can be used to describe a specific
2345
- # instance of this metric type.
2346
- # The label key name must follow:
2347
- # * Only upper and lower-case letters, digits and underscores (_) are
2348
- # allowed.
2349
- # * Label name must start with a letter or digit.
2350
- # * The maximum length of a label name is 100 characters.
2351
- # For example, the
2352
- # `appengine.googleapis.com/http/server/response_latencies` metric
2353
- # type has a label for the HTTP response code, `response_code`, so
2354
- # you can look at latencies for successful responses or just
2355
- # for responses that failed.
2065
+ # The set of labels that can be used to describe a specific instance of this
2066
+ # metric type. The label key name must follow: * Only upper and lower-case
2067
+ # letters, digits and underscores (_) are allowed. * Label name must start with
2068
+ # a letter or digit. * The maximum length of a label name is 100 characters. For
2069
+ # example, the `appengine.googleapis.com/http/server/response_latencies` metric
2070
+ # type has a label for the HTTP response code, `response_code`, so you can look
2071
+ # at latencies for successful responses or just for responses that failed.
2356
2072
  # Corresponds to the JSON property `labels`
2357
2073
  # @return [Array<Google::Apis::ServicenetworkingV1::LabelDescriptor>]
2358
2074
  attr_accessor :labels
@@ -2367,17 +2083,16 @@ module Google
2367
2083
  # @return [Google::Apis::ServicenetworkingV1::MetricDescriptorMetadata]
2368
2084
  attr_accessor :metadata
2369
2085
 
2370
- # Whether the metric records instantaneous values, changes to a value, etc.
2371
- # Some combinations of `metric_kind` and `value_type` might not be supported.
2086
+ # Whether the metric records instantaneous values, changes to a value, etc. Some
2087
+ # combinations of `metric_kind` and `value_type` might not be supported.
2372
2088
  # Corresponds to the JSON property `metricKind`
2373
2089
  # @return [String]
2374
2090
  attr_accessor :metric_kind
2375
2091
 
2376
- # Read-only. If present, then a time
2377
- # series, which is identified partially by
2378
- # a metric type and a MonitoredResourceDescriptor, that is associated
2379
- # with this metric type can only be associated with one of the monitored
2380
- # resource types listed here.
2092
+ # Read-only. If present, then a time series, which is identified partially by a
2093
+ # metric type and a MonitoredResourceDescriptor, that is associated with this
2094
+ # metric type can only be associated with one of the monitored resource types
2095
+ # listed here.
2381
2096
  # Corresponds to the JSON property `monitoredResourceTypes`
2382
2097
  # @return [Array<String>]
2383
2098
  attr_accessor :monitored_resource_types
@@ -2387,116 +2102,73 @@ module Google
2387
2102
  # @return [String]
2388
2103
  attr_accessor :name
2389
2104
 
2390
- # The metric type, including its DNS name prefix. The type is not
2391
- # URL-encoded.
2105
+ # The metric type, including its DNS name prefix. The type is not URL-encoded.
2392
2106
  # All service defined metrics must be prefixed with the service name, in the
2393
- # format of ``service name`/`relative metric name``, such as
2394
- # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
2395
- # name must follow:
2107
+ # format of ``service name`/`relative metric name``, such as `cloudsql.
2108
+ # googleapis.com/database/cpu/utilization`. The relative metric name must follow:
2396
2109
  # * Only upper and lower-case letters, digits, '/' and underscores '_' are
2397
- # allowed.
2398
- # * The maximum number of characters allowed for the relative_metric_name is
2399
- # 100.
2400
- # All user-defined metric types have the DNS name
2401
- # `custom.googleapis.com`, `external.googleapis.com`, or
2402
- # `logging.googleapis.com/user/`.
2403
- # Metric types should use a natural hierarchical grouping. For example:
2404
- # "custom.googleapis.com/invoice/paid/amount"
2405
- # "external.googleapis.com/prometheus/up"
2406
- # "appengine.googleapis.com/http/server/response_latencies"
2110
+ # allowed. * The maximum number of characters allowed for the
2111
+ # relative_metric_name is 100. All user-defined metric types have the DNS name `
2112
+ # custom.googleapis.com`, `external.googleapis.com`, or `logging.googleapis.com/
2113
+ # user/`. Metric types should use a natural hierarchical grouping. For example: "
2114
+ # custom.googleapis.com/invoice/paid/amount" "external.googleapis.com/prometheus/
2115
+ # up" "appengine.googleapis.com/http/server/response_latencies"
2407
2116
  # Corresponds to the JSON property `type`
2408
2117
  # @return [String]
2409
2118
  attr_accessor :type
2410
2119
 
2411
- # The units in which the metric value is reported. It is only applicable
2412
- # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
2413
- # defines the representation of the stored metric values.
2414
- # Different systems may scale the values to be more easily displayed (so a
2415
- # value of `0.02KBy` _might_ be displayed as `20By`, and a value of
2416
- # `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
2417
- # `KBy`, then the value of the metric is always in thousands of bytes, no
2418
- # matter how it may be displayed..
2419
- # If you want a custom metric to record the exact number of CPU-seconds used
2420
- # by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
2421
- # `s`CPU`` (or equivalently `1s`CPU`` or just `s`). If the job uses 12,005
2422
- # CPU-seconds, then the value is written as `12005`.
2423
- # Alternatively, if you want a custom metric to record data in a more
2424
- # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
2425
- # `ks`CPU``, and then write the value `12.005` (which is `12005/1000`),
2426
- # or use `Kis`CPU`` and write `11.723` (which is `12005/1024`).
2427
- # The supported units are a subset of [The Unified Code for Units of
2428
- # Measure](http://unitsofmeasure.org/ucum.html) standard:
2429
- # **Basic units (UNIT)**
2430
- # * `bit` bit
2431
- # * `By` byte
2432
- # * `s` second
2433
- # * `min` minute
2434
- # * `h` hour
2435
- # * `d` day
2436
- # * `1` dimensionless
2437
- # **Prefixes (PREFIX)**
2438
- # * `k` kilo (10^3)
2439
- # * `M` mega (10^6)
2440
- # * `G` giga (10^9)
2441
- # * `T` tera (10^12)
2442
- # * `P` peta (10^15)
2443
- # * `E` exa (10^18)
2444
- # * `Z` zetta (10^21)
2445
- # * `Y` yotta (10^24)
2446
- # * `m` milli (10^-3)
2447
- # * `u` micro (10^-6)
2448
- # * `n` nano (10^-9)
2449
- # * `p` pico (10^-12)
2450
- # * `f` femto (10^-15)
2451
- # * `a` atto (10^-18)
2452
- # * `z` zepto (10^-21)
2453
- # * `y` yocto (10^-24)
2454
- # * `Ki` kibi (2^10)
2455
- # * `Mi` mebi (2^20)
2456
- # * `Gi` gibi (2^30)
2457
- # * `Ti` tebi (2^40)
2458
- # * `Pi` pebi (2^50)
2459
- # **Grammar**
2460
- # The grammar also includes these connectors:
2461
- # * `/` division or ratio (as an infix operator). For examples,
2462
- # `kBy/`email`` or `MiBy/10ms` (although you should almost never
2463
- # have `/s` in a metric `unit`; rates should always be computed at
2464
- # query time from the underlying cumulative or delta value).
2465
- # * `.` multiplication or composition (as an infix operator). For
2466
- # examples, `GBy.d` or `k`watt`.h`.
2467
- # The grammar for a unit is as follows:
2468
- # Expression = Component ` "." Component ` ` "/" Component ` ;
2469
- # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
2470
- # | Annotation
2471
- # | "1"
2472
- # ;
2473
- # Annotation = "`" NAME "`" ;
2474
- # Notes:
2475
- # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
2476
- # is used alone, then the unit is equivalent to `1`. For examples,
2477
- # ``request`/s == 1/s`, `By`transmitted`/s == By/s`.
2478
- # * `NAME` is a sequence of non-blank printable ASCII characters not
2479
- # containing ``` or ```.
2480
- # * `1` represents a unitary [dimensionless
2481
- # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
2482
- # as in `1/s`. It is typically used when none of the basic units are
2483
- # appropriate. For example, "new users per day" can be represented as
2484
- # `1/d` or ``new-users`/d` (and a metric value `5` would mean "5 new
2485
- # users). Alternatively, "thousands of page views per day" would be
2486
- # represented as `1000/d` or `k1/d` or `k`page_views`/d` (and a metric
2487
- # value of `5.3` would mean "5300 page views per day").
2488
- # * `%` represents dimensionless value of 1/100, and annotates values giving
2489
- # a percentage (so the metric values are typically in the range of 0..100,
2490
- # and a metric value `3` means "3 percent").
2491
- # * `10^2.%` indicates a metric contains a ratio, typically in the range
2492
- # 0..1, that will be multiplied by 100 and displayed as a percentage
2493
- # (so a metric value `0.03` means "3 percent").
2120
+ # The units in which the metric value is reported. It is only applicable if the `
2121
+ # value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the
2122
+ # representation of the stored metric values. Different systems may scale the
2123
+ # values to be more easily displayed (so a value of `0.02KBy` _might_ be
2124
+ # displayed as `20By`, and a value of `3523KBy` _might_ be displayed as `3.5MBy`)
2125
+ # . However, if the `unit` is `KBy`, then the value of the metric is always in
2126
+ # thousands of bytes, no matter how it may be displayed.. If you want a custom
2127
+ # metric to record the exact number of CPU-seconds used by a job, you can create
2128
+ # an `INT64 CUMULATIVE` metric whose `unit` is `s`CPU`` (or equivalently `1s`CPU`
2129
+ # ` or just `s`). If the job uses 12,005 CPU-seconds, then the value is written
2130
+ # as `12005`. Alternatively, if you want a custom metric to record data in a
2131
+ # more granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
2132
+ # `ks`CPU``, and then write the value `12.005` (which is `12005/1000`), or use `
2133
+ # Kis`CPU`` and write `11.723` (which is `12005/1024`). The supported units are
2134
+ # a subset of [The Unified Code for Units of Measure](http://unitsofmeasure.org/
2135
+ # ucum.html) standard: **Basic units (UNIT)** * `bit` bit * `By` byte * `s`
2136
+ # second * `min` minute * `h` hour * `d` day * `1` dimensionless **Prefixes (
2137
+ # PREFIX)** * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera (10^
2138
+ # 12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^
2139
+ # 24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-
2140
+ # 12) * `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` yocto (
2141
+ # 10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (
2142
+ # 2^40) * `Pi` pebi (2^50) **Grammar** The grammar also includes these
2143
+ # connectors: * `/` division or ratio (as an infix operator). For examples, `kBy/
2144
+ # `email`` or `MiBy/10ms` (although you should almost never have `/s` in a
2145
+ # metric `unit`; rates should always be computed at query time from the
2146
+ # underlying cumulative or delta value). * `.` multiplication or composition (as
2147
+ # an infix operator). For examples, `GBy.d` or `k`watt`.h`. The grammar for a
2148
+ # unit is as follows: Expression = Component ` "." Component ` ` "/" Component `
2149
+ # ; Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ;
2150
+ # Annotation = "`" NAME "`" ; Notes: * `Annotation` is just a comment if it
2151
+ # follows a `UNIT`. If the annotation is used alone, then the unit is equivalent
2152
+ # to `1`. For examples, ``request`/s == 1/s`, `By`transmitted`/s == By/s`. * `
2153
+ # NAME` is a sequence of non-blank printable ASCII characters not containing ```
2154
+ # or ```. * `1` represents a unitary [dimensionless unit](https://en.wikipedia.
2155
+ # org/wiki/Dimensionless_quantity) of 1, such as in `1/s`. It is typically used
2156
+ # when none of the basic units are appropriate. For example, "new users per day"
2157
+ # can be represented as `1/d` or ``new-users`/d` (and a metric value `5` would
2158
+ # mean "5 new users). Alternatively, "thousands of page views per day" would be
2159
+ # represented as `1000/d` or `k1/d` or `k`page_views`/d` (and a metric value of `
2160
+ # 5.3` would mean "5300 page views per day"). * `%` represents dimensionless
2161
+ # value of 1/100, and annotates values giving a percentage (so the metric values
2162
+ # are typically in the range of 0..100, and a metric value `3` means "3 percent")
2163
+ # . * `10^2.%` indicates a metric contains a ratio, typically in the range 0..1,
2164
+ # that will be multiplied by 100 and displayed as a percentage (so a metric
2165
+ # value `0.03` means "3 percent").
2494
2166
  # Corresponds to the JSON property `unit`
2495
2167
  # @return [String]
2496
2168
  attr_accessor :unit
2497
2169
 
2498
- # Whether the measurement is an integer, a floating-point number, etc.
2499
- # Some combinations of `metric_kind` and `value_type` might not be supported.
2170
+ # Whether the measurement is an integer, a floating-point number, etc. Some
2171
+ # combinations of `metric_kind` and `value_type` might not be supported.
2500
2172
  # Corresponds to the JSON property `valueType`
2501
2173
  # @return [String]
2502
2174
  attr_accessor :value_type
@@ -2525,9 +2197,9 @@ module Google
2525
2197
  class MetricDescriptorMetadata
2526
2198
  include Google::Apis::Core::Hashable
2527
2199
 
2528
- # The delay of data points caused by ingestion. Data points older than this
2529
- # age are guaranteed to be ingested and available to be read, excluding
2530
- # data loss due to errors.
2200
+ # The delay of data points caused by ingestion. Data points older than this age
2201
+ # are guaranteed to be ingested and available to be read, excluding data loss
2202
+ # due to errors.
2531
2203
  # Corresponds to the JSON property `ingestDelay`
2532
2204
  # @return [String]
2533
2205
  attr_accessor :ingest_delay
@@ -2539,8 +2211,8 @@ module Google
2539
2211
 
2540
2212
  # The sampling period of metric data points. For metrics which are written
2541
2213
  # periodically, consecutive data points are stored at this time interval,
2542
- # excluding data loss due to errors. Metrics with a higher granularity have
2543
- # a smaller sampling period.
2214
+ # excluding data loss due to errors. Metrics with a higher granularity have a
2215
+ # smaller sampling period.
2544
2216
  # Corresponds to the JSON property `samplePeriod`
2545
2217
  # @return [String]
2546
2218
  attr_accessor :sample_period
@@ -2557,22 +2229,21 @@ module Google
2557
2229
  end
2558
2230
  end
2559
2231
 
2560
- # Bind API methods to metrics. Binding a method to a metric causes that
2561
- # metric's configured quota behaviors to apply to the method call.
2232
+ # Bind API methods to metrics. Binding a method to a metric causes that metric's
2233
+ # configured quota behaviors to apply to the method call.
2562
2234
  class MetricRule
2563
2235
  include Google::Apis::Core::Hashable
2564
2236
 
2565
2237
  # Metrics to update when the selected methods are called, and the associated
2566
- # cost applied to each metric.
2567
- # The key of the map is the metric name, and the values are the amount
2568
- # increased for the metric against which the quota limits are defined.
2569
- # The value must not be negative.
2238
+ # cost applied to each metric. The key of the map is the metric name, and the
2239
+ # values are the amount increased for the metric against which the quota limits
2240
+ # are defined. The value must not be negative.
2570
2241
  # Corresponds to the JSON property `metricCosts`
2571
2242
  # @return [Hash<String,Fixnum>]
2572
2243
  attr_accessor :metric_costs
2573
2244
 
2574
- # Selects the methods to which this rule applies.
2575
- # Refer to selector for syntax details.
2245
+ # Selects the methods to which this rule applies. Refer to selector for syntax
2246
+ # details.
2576
2247
  # Corresponds to the JSON property `selector`
2577
2248
  # @return [String]
2578
2249
  attr_accessor :selector
@@ -2590,66 +2261,33 @@ module Google
2590
2261
 
2591
2262
  # Declares an API Interface to be included in this interface. The including
2592
2263
  # interface must redeclare all the methods from the included interface, but
2593
- # documentation and options are inherited as follows:
2594
- # - If after comment and whitespace stripping, the documentation
2595
- # string of the redeclared method is empty, it will be inherited
2596
- # from the original method.
2597
- # - Each annotation belonging to the service config (http,
2598
- # visibility) which is not set in the redeclared method will be
2599
- # inherited.
2600
- # - If an http annotation is inherited, the path pattern will be
2601
- # modified as follows. Any version prefix will be replaced by the
2602
- # version of the including interface plus the root path if
2603
- # specified.
2604
- # Example of a simple mixin:
2605
- # package google.acl.v1;
2606
- # service AccessControl `
2607
- # // Get the underlying ACL object.
2608
- # rpc GetAcl(GetAclRequest) returns (Acl) `
2609
- # option (google.api.http).get = "/v1/`resource=**`:getAcl";
2610
- # `
2611
- # `
2612
- # package google.storage.v2;
2613
- # service Storage `
2614
- # // rpc GetAcl(GetAclRequest) returns (Acl);
2615
- # // Get a data record.
2616
- # rpc GetData(GetDataRequest) returns (Data) `
2617
- # option (google.api.http).get = "/v2/`resource=**`";
2618
- # `
2619
- # `
2620
- # Example of a mixin configuration:
2621
- # apis:
2622
- # - name: google.storage.v2.Storage
2623
- # mixins:
2624
- # - name: google.acl.v1.AccessControl
2625
- # The mixin construct implies that all methods in `AccessControl` are
2626
- # also declared with same name and request/response types in
2627
- # `Storage`. A documentation generator or annotation processor will
2628
- # see the effective `Storage.GetAcl` method after inherting
2629
- # documentation and annotations as follows:
2630
- # service Storage `
2631
- # // Get the underlying ACL object.
2632
- # rpc GetAcl(GetAclRequest) returns (Acl) `
2633
- # option (google.api.http).get = "/v2/`resource=**`:getAcl";
2634
- # `
2635
- # ...
2636
- # `
2637
- # Note how the version in the path pattern changed from `v1` to `v2`.
2638
- # If the `root` field in the mixin is specified, it should be a
2639
- # relative path under which inherited HTTP paths are placed. Example:
2640
- # apis:
2641
- # - name: google.storage.v2.Storage
2642
- # mixins:
2643
- # - name: google.acl.v1.AccessControl
2644
- # root: acls
2645
- # This implies the following inherited HTTP annotation:
2646
- # service Storage `
2647
- # // Get the underlying ACL object.
2648
- # rpc GetAcl(GetAclRequest) returns (Acl) `
2649
- # option (google.api.http).get = "/v2/acls/`resource=**`:getAcl";
2650
- # `
2651
- # ...
2652
- # `
2264
+ # documentation and options are inherited as follows: - If after comment and
2265
+ # whitespace stripping, the documentation string of the redeclared method is
2266
+ # empty, it will be inherited from the original method. - Each annotation
2267
+ # belonging to the service config (http, visibility) which is not set in the
2268
+ # redeclared method will be inherited. - If an http annotation is inherited, the
2269
+ # path pattern will be modified as follows. Any version prefix will be replaced
2270
+ # by the version of the including interface plus the root path if specified.
2271
+ # Example of a simple mixin: package google.acl.v1; service AccessControl ` //
2272
+ # Get the underlying ACL object. rpc GetAcl(GetAclRequest) returns (Acl) `
2273
+ # option (google.api.http).get = "/v1/`resource=**`:getAcl"; ` ` package google.
2274
+ # storage.v2; service Storage ` // rpc GetAcl(GetAclRequest) returns (Acl); //
2275
+ # Get a data record. rpc GetData(GetDataRequest) returns (Data) ` option (google.
2276
+ # api.http).get = "/v2/`resource=**`"; ` ` Example of a mixin configuration:
2277
+ # apis: - name: google.storage.v2.Storage mixins: - name: google.acl.v1.
2278
+ # AccessControl The mixin construct implies that all methods in `AccessControl`
2279
+ # are also declared with same name and request/response types in `Storage`. A
2280
+ # documentation generator or annotation processor will see the effective `
2281
+ # Storage.GetAcl` method after inherting documentation and annotations as
2282
+ # follows: service Storage ` // Get the underlying ACL object. rpc GetAcl(
2283
+ # GetAclRequest) returns (Acl) ` option (google.api.http).get = "/v2/`resource=**
2284
+ # `:getAcl"; ` ... ` Note how the version in the path pattern changed from `v1`
2285
+ # to `v2`. If the `root` field in the mixin is specified, it should be a
2286
+ # relative path under which inherited HTTP paths are placed. Example: apis: -
2287
+ # name: google.storage.v2.Storage mixins: - name: google.acl.v1.AccessControl
2288
+ # root: acls This implies the following inherited HTTP annotation: service
2289
+ # Storage ` // Get the underlying ACL object. rpc GetAcl(GetAclRequest) returns (
2290
+ # Acl) ` option (google.api.http).get = "/v2/acls/`resource=**`:getAcl"; ` ... `
2653
2291
  class Mixin
2654
2292
  include Google::Apis::Core::Hashable
2655
2293
 
@@ -2658,8 +2296,7 @@ module Google
2658
2296
  # @return [String]
2659
2297
  attr_accessor :name
2660
2298
 
2661
- # If non-empty specifies a path under which inherited HTTP paths
2662
- # are rooted.
2299
+ # If non-empty specifies a path under which inherited HTTP paths are rooted.
2663
2300
  # Corresponds to the JSON property `root`
2664
2301
  # @return [String]
2665
2302
  attr_accessor :root
@@ -2675,51 +2312,42 @@ module Google
2675
2312
  end
2676
2313
  end
2677
2314
 
2678
- # An object that describes the schema of a MonitoredResource object using a
2679
- # type name and a set of labels. For example, the monitored resource
2680
- # descriptor for Google Compute Engine VM instances has a type of
2681
- # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
2682
- # `"zone"` to identify particular VM instances.
2683
- # Different services can support different monitored resource types.
2684
- # The following are specific rules to service defined monitored resources for
2685
- # Monitoring and Logging:
2686
- # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
2687
- # fields are all required.
2688
- # * The first label of the monitored resource descriptor must be
2689
- # `resource_container`. There are legacy monitored resource descritptors
2690
- # start with `project_id`.
2691
- # * It must include a `location` label.
2692
- # * Maximum of default 5 service defined monitored resource descriptors
2693
- # is allowed per service.
2694
- # * Maximum of default 10 labels per monitored resource is allowed.
2695
- # The default maximum limit can be overridden. Please follow
2696
- # https://cloud.google.com/monitoring/quotas
2315
+ # An object that describes the schema of a MonitoredResource object using a type
2316
+ # name and a set of labels. For example, the monitored resource descriptor for
2317
+ # Google Compute Engine VM instances has a type of `"gce_instance"` and
2318
+ # specifies the use of the labels `"instance_id"` and `"zone"` to identify
2319
+ # particular VM instances. Different services can support different monitored
2320
+ # resource types. The following are specific rules to service defined monitored
2321
+ # resources for Monitoring and Logging: * The `type`, `display_name`, `
2322
+ # description`, `labels` and `launch_stage` fields are all required. * The first
2323
+ # label of the monitored resource descriptor must be `resource_container`. There
2324
+ # are legacy monitored resource descritptors start with `project_id`. * It must
2325
+ # include a `location` label. * Maximum of default 5 service defined monitored
2326
+ # resource descriptors is allowed per service. * Maximum of default 10 labels
2327
+ # per monitored resource is allowed. The default maximum limit can be overridden.
2328
+ # Please follow https://cloud.google.com/monitoring/quotas
2697
2329
  class MonitoredResourceDescriptor
2698
2330
  include Google::Apis::Core::Hashable
2699
2331
 
2700
- # Optional. A detailed description of the monitored resource type that might
2701
- # be used in documentation.
2332
+ # Optional. A detailed description of the monitored resource type that might be
2333
+ # used in documentation.
2702
2334
  # Corresponds to the JSON property `description`
2703
2335
  # @return [String]
2704
2336
  attr_accessor :description
2705
2337
 
2706
2338
  # Optional. A concise name for the monitored resource type that might be
2707
- # displayed in user interfaces. It should be a Title Cased Noun Phrase,
2708
- # without any article or other determiners. For example,
2709
- # `"Google Cloud SQL Database"`.
2339
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
2340
+ # any article or other determiners. For example, `"Google Cloud SQL Database"`.
2710
2341
  # Corresponds to the JSON property `displayName`
2711
2342
  # @return [String]
2712
2343
  attr_accessor :display_name
2713
2344
 
2714
2345
  # Required. A set of labels used to describe instances of this monitored
2715
- # resource type.
2716
- # The label key name must follow:
2717
- # * Only upper and lower-case letters, digits and underscores (_) are
2718
- # allowed.
2719
- # * Label name must start with a letter or digit.
2720
- # * The maximum length of a label name is 100 characters.
2721
- # For example, an individual Google Cloud SQL database is
2722
- # identified by values for the labels `database_id` and `location`.
2346
+ # resource type. The label key name must follow: * Only upper and lower-case
2347
+ # letters, digits and underscores (_) are allowed. * Label name must start with
2348
+ # a letter or digit. * The maximum length of a label name is 100 characters. For
2349
+ # example, an individual Google Cloud SQL database is identified by values for
2350
+ # the labels `database_id` and `location`.
2723
2351
  # Corresponds to the JSON property `labels`
2724
2352
  # @return [Array<Google::Apis::ServicenetworkingV1::LabelDescriptor>]
2725
2353
  attr_accessor :labels
@@ -2729,27 +2357,25 @@ module Google
2729
2357
  # @return [String]
2730
2358
  attr_accessor :launch_stage
2731
2359
 
2732
- # Optional. The resource name of the monitored resource descriptor:
2733
- # `"projects/`project_id`/monitoredResourceDescriptors/`type`"` where
2734
- # `type` is the value of the `type` field in this object and
2735
- # `project_id` is a project ID that provides API-specific context for
2736
- # accessing the type. APIs that do not use project information can use the
2737
- # resource name format `"monitoredResourceDescriptors/`type`"`.
2360
+ # Optional. The resource name of the monitored resource descriptor: `"projects/`
2361
+ # project_id`/monitoredResourceDescriptors/`type`"` where `type` is the value of
2362
+ # the `type` field in this object and `project_id` is a project ID that provides
2363
+ # API-specific context for accessing the type. APIs that do not use project
2364
+ # information can use the resource name format `"monitoredResourceDescriptors/`
2365
+ # type`"`.
2738
2366
  # Corresponds to the JSON property `name`
2739
2367
  # @return [String]
2740
2368
  attr_accessor :name
2741
2369
 
2742
- # Required. The monitored resource type. For example, the type
2743
- # `cloudsql_database` represents databases in Google Cloud SQL.
2744
- # All service defined monitored resource types must be prefixed with the
2745
- # service name, in the format of ``service name`/`relative resource name``.
2746
- # The relative resource name must follow:
2747
- # * Only upper and lower-case letters and digits are allowed.
2748
- # * It must start with upper case character and is recommended to use Upper
2749
- # Camel Case style.
2750
- # * The maximum number of characters allowed for the relative_resource_name
2751
- # is 100.
2752
- # Note there are legacy service monitored resources not following this rule.
2370
+ # Required. The monitored resource type. For example, the type `
2371
+ # cloudsql_database` represents databases in Google Cloud SQL. All service
2372
+ # defined monitored resource types must be prefixed with the service name, in
2373
+ # the format of ``service name`/`relative resource name``. The relative resource
2374
+ # name must follow: * Only upper and lower-case letters and digits are allowed. *
2375
+ # It must start with upper case character and is recommended to use Upper Camel
2376
+ # Case style. * The maximum number of characters allowed for the
2377
+ # relative_resource_name is 100. Note there are legacy service monitored
2378
+ # resources not following this rule.
2753
2379
  # Corresponds to the JSON property `type`
2754
2380
  # @return [String]
2755
2381
  attr_accessor :type
@@ -2769,75 +2395,47 @@ module Google
2769
2395
  end
2770
2396
  end
2771
2397
 
2772
- # Monitoring configuration of the service.
2773
- # The example below shows how to configure monitored resources and metrics
2774
- # for monitoring. In the example, a monitored resource and two metrics are
2775
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
2776
- # to both producer and consumer projects, whereas the
2777
- # `library.googleapis.com/book/num_overdue` metric is only sent to the
2778
- # consumer project.
2779
- # monitored_resources:
2780
- # - type: library.googleapis.com/Branch
2781
- # display_name: "Library Branch"
2782
- # description: "A branch of a library."
2783
- # launch_stage: GA
2784
- # labels:
2785
- # - key: resource_container
2786
- # description: "The Cloud container (ie. project id) for the Branch."
2787
- # - key: location
2788
- # description: "The location of the library branch."
2789
- # - key: branch_id
2790
- # description: "The id of the branch."
2791
- # metrics:
2792
- # - name: library.googleapis.com/book/returned_count
2793
- # display_name: "Books Returned"
2794
- # description: "The count of books that have been returned."
2795
- # launch_stage: GA
2796
- # metric_kind: DELTA
2797
- # value_type: INT64
2798
- # unit: "1"
2799
- # labels:
2800
- # - key: customer_id
2801
- # description: "The id of the customer."
2802
- # - name: library.googleapis.com/book/num_overdue
2803
- # display_name: "Books Overdue"
2804
- # description: "The current number of overdue books."
2805
- # launch_stage: GA
2806
- # metric_kind: GAUGE
2807
- # value_type: INT64
2808
- # unit: "1"
2809
- # labels:
2810
- # - key: customer_id
2811
- # description: "The id of the customer."
2812
- # monitoring:
2813
- # producer_destinations:
2814
- # - monitored_resource: library.googleapis.com/Branch
2815
- # metrics:
2816
- # - library.googleapis.com/book/returned_count
2817
- # consumer_destinations:
2818
- # - monitored_resource: library.googleapis.com/Branch
2819
- # metrics:
2820
- # - library.googleapis.com/book/returned_count
2821
- # - library.googleapis.com/book/num_overdue
2398
+ # Monitoring configuration of the service. The example below shows how to
2399
+ # configure monitored resources and metrics for monitoring. In the example, a
2400
+ # monitored resource and two metrics are defined. The `library.googleapis.com/
2401
+ # book/returned_count` metric is sent to both producer and consumer projects,
2402
+ # whereas the `library.googleapis.com/book/num_overdue` metric is only sent to
2403
+ # the consumer project. monitored_resources: - type: library.googleapis.com/
2404
+ # Branch display_name: "Library Branch" description: "A branch of a library."
2405
+ # launch_stage: GA labels: - key: resource_container description: "The Cloud
2406
+ # container (ie. project id) for the Branch." - key: location description: "The
2407
+ # location of the library branch." - key: branch_id description: "The id of the
2408
+ # branch." metrics: - name: library.googleapis.com/book/returned_count
2409
+ # display_name: "Books Returned" description: "The count of books that have been
2410
+ # returned." launch_stage: GA metric_kind: DELTA value_type: INT64 unit: "1"
2411
+ # labels: - key: customer_id description: "The id of the customer." - name:
2412
+ # library.googleapis.com/book/num_overdue display_name: "Books Overdue"
2413
+ # description: "The current number of overdue books." launch_stage: GA
2414
+ # metric_kind: GAUGE value_type: INT64 unit: "1" labels: - key: customer_id
2415
+ # description: "The id of the customer." monitoring: producer_destinations: -
2416
+ # monitored_resource: library.googleapis.com/Branch metrics: - library.
2417
+ # googleapis.com/book/returned_count consumer_destinations: - monitored_resource:
2418
+ # library.googleapis.com/Branch metrics: - library.googleapis.com/book/
2419
+ # returned_count - library.googleapis.com/book/num_overdue
2822
2420
  class Monitoring
2823
2421
  include Google::Apis::Core::Hashable
2824
2422
 
2825
- # Monitoring configurations for sending metrics to the consumer project.
2826
- # There can be multiple consumer destinations. A monitored resource type may
2827
- # appear in multiple monitoring destinations if different aggregations are
2828
- # needed for different sets of metrics associated with that monitored
2829
- # resource type. A monitored resource and metric pair may only be used once
2830
- # in the Monitoring configuration.
2423
+ # Monitoring configurations for sending metrics to the consumer project. There
2424
+ # can be multiple consumer destinations. A monitored resource type may appear in
2425
+ # multiple monitoring destinations if different aggregations are needed for
2426
+ # different sets of metrics associated with that monitored resource type. A
2427
+ # monitored resource and metric pair may only be used once in the Monitoring
2428
+ # configuration.
2831
2429
  # Corresponds to the JSON property `consumerDestinations`
2832
2430
  # @return [Array<Google::Apis::ServicenetworkingV1::MonitoringDestination>]
2833
2431
  attr_accessor :consumer_destinations
2834
2432
 
2835
- # Monitoring configurations for sending metrics to the producer project.
2836
- # There can be multiple producer destinations. A monitored resource type may
2837
- # appear in multiple monitoring destinations if different aggregations are
2838
- # needed for different sets of metrics associated with that monitored
2839
- # resource type. A monitored resource and metric pair may only be used once
2840
- # in the Monitoring configuration.
2433
+ # Monitoring configurations for sending metrics to the producer project. There
2434
+ # can be multiple producer destinations. A monitored resource type may appear in
2435
+ # multiple monitoring destinations if different aggregations are needed for
2436
+ # different sets of metrics associated with that monitored resource type. A
2437
+ # monitored resource and metric pair may only be used once in the Monitoring
2438
+ # configuration.
2841
2439
  # Corresponds to the JSON property `producerDestinations`
2842
2440
  # @return [Array<Google::Apis::ServicenetworkingV1::MonitoringDestination>]
2843
2441
  attr_accessor :producer_destinations
@@ -2853,19 +2451,19 @@ module Google
2853
2451
  end
2854
2452
  end
2855
2453
 
2856
- # Configuration of a specific monitoring destination (the producer project
2857
- # or the consumer project).
2454
+ # Configuration of a specific monitoring destination (the producer project or
2455
+ # the consumer project).
2858
2456
  class MonitoringDestination
2859
2457
  include Google::Apis::Core::Hashable
2860
2458
 
2861
- # Types of the metrics to report to this monitoring destination.
2862
- # Each type must be defined in Service.metrics section.
2459
+ # Types of the metrics to report to this monitoring destination. Each type must
2460
+ # be defined in Service.metrics section.
2863
2461
  # Corresponds to the JSON property `metrics`
2864
2462
  # @return [Array<String>]
2865
2463
  attr_accessor :metrics
2866
2464
 
2867
- # The monitored resource type. The type must be defined in
2868
- # Service.monitored_resources section.
2465
+ # The monitored resource type. The type must be defined in Service.
2466
+ # monitored_resources section.
2869
2467
  # Corresponds to the JSON property `monitoredResource`
2870
2468
  # @return [String]
2871
2469
  attr_accessor :monitored_resource
@@ -2882,27 +2480,25 @@ module Google
2882
2480
  end
2883
2481
 
2884
2482
  # OAuth scopes are a way to define data and permissions on data. For example,
2885
- # there are scopes defined for "Read-only access to Google Calendar" and
2886
- # "Access to Cloud Platform". Users can consent to a scope for an application,
2887
- # giving it permission to access that data on their behalf.
2888
- # OAuth scope specifications should be fairly coarse grained; a user will need
2889
- # to see and understand the text description of what your scope means.
2890
- # In most cases: use one or at most two OAuth scopes for an entire family of
2891
- # products. If your product has multiple APIs, you should probably be sharing
2892
- # the OAuth scope across all of those APIs.
2893
- # When you need finer grained OAuth consent screens: talk with your product
2894
- # management about how developers will use them in practice.
2895
- # Please note that even though each of the canonical scopes is enough for a
2896
- # request to be accepted and passed to the backend, a request can still fail
2897
- # due to the backend requiring additional scopes or permissions.
2483
+ # there are scopes defined for "Read-only access to Google Calendar" and "Access
2484
+ # to Cloud Platform". Users can consent to a scope for an application, giving it
2485
+ # permission to access that data on their behalf. OAuth scope specifications
2486
+ # should be fairly coarse grained; a user will need to see and understand the
2487
+ # text description of what your scope means. In most cases: use one or at most
2488
+ # two OAuth scopes for an entire family of products. If your product has
2489
+ # multiple APIs, you should probably be sharing the OAuth scope across all of
2490
+ # those APIs. When you need finer grained OAuth consent screens: talk with your
2491
+ # product management about how developers will use them in practice. Please note
2492
+ # that even though each of the canonical scopes is enough for a request to be
2493
+ # accepted and passed to the backend, a request can still fail due to the
2494
+ # backend requiring additional scopes or permissions.
2898
2495
  class OAuthRequirements
2899
2496
  include Google::Apis::Core::Hashable
2900
2497
 
2901
- # The list of publicly documented OAuth scopes that are allowed access. An
2902
- # OAuth token containing any of these scopes will be accepted.
2903
- # Example:
2904
- # canonical_scopes: https://www.googleapis.com/auth/calendar,
2905
- # https://www.googleapis.com/auth/calendar.read
2498
+ # The list of publicly documented OAuth scopes that are allowed access. An OAuth
2499
+ # token containing any of these scopes will be accepted. Example:
2500
+ # canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.
2501
+ # googleapis.com/auth/calendar.read
2906
2502
  # Corresponds to the JSON property `canonicalScopes`
2907
2503
  # @return [String]
2908
2504
  attr_accessor :canonical_scopes
@@ -2922,47 +2518,45 @@ module Google
2922
2518
  class Operation
2923
2519
  include Google::Apis::Core::Hashable
2924
2520
 
2925
- # If the value is `false`, it means the operation is still in progress.
2926
- # If `true`, the operation is completed, and either `error` or `response` is
2927
- # available.
2521
+ # If the value is `false`, it means the operation is still in progress. If `true`
2522
+ # , the operation is completed, and either `error` or `response` is available.
2928
2523
  # Corresponds to the JSON property `done`
2929
2524
  # @return [Boolean]
2930
2525
  attr_accessor :done
2931
2526
  alias_method :done?, :done
2932
2527
 
2933
- # The `Status` type defines a logical error model that is suitable for
2934
- # different programming environments, including REST APIs and RPC APIs. It is
2935
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2936
- # three pieces of data: error code, error message, and error details.
2937
- # You can find out more about this error model and how to work with it in the
2938
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
2528
+ # The `Status` type defines a logical error model that is suitable for different
2529
+ # programming environments, including REST APIs and RPC APIs. It is used by [
2530
+ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
2531
+ # data: error code, error message, and error details. You can find out more
2532
+ # about this error model and how to work with it in the [API Design Guide](https:
2533
+ # //cloud.google.com/apis/design/errors).
2939
2534
  # Corresponds to the JSON property `error`
2940
2535
  # @return [Google::Apis::ServicenetworkingV1::Status]
2941
2536
  attr_accessor :error
2942
2537
 
2943
- # Service-specific metadata associated with the operation. It typically
2944
- # contains progress information and common metadata such as create time.
2945
- # Some services might not provide such metadata. Any method that returns a
2946
- # long-running operation should document the metadata type, if any.
2538
+ # Service-specific metadata associated with the operation. It typically contains
2539
+ # progress information and common metadata such as create time. Some services
2540
+ # might not provide such metadata. Any method that returns a long-running
2541
+ # operation should document the metadata type, if any.
2947
2542
  # Corresponds to the JSON property `metadata`
2948
2543
  # @return [Hash<String,Object>]
2949
2544
  attr_accessor :metadata
2950
2545
 
2951
2546
  # The server-assigned name, which is only unique within the same service that
2952
- # originally returns it. If you use the default HTTP mapping, the
2953
- # `name` should be a resource name ending with `operations/`unique_id``.
2547
+ # originally returns it. If you use the default HTTP mapping, the `name` should
2548
+ # be a resource name ending with `operations/`unique_id``.
2954
2549
  # Corresponds to the JSON property `name`
2955
2550
  # @return [String]
2956
2551
  attr_accessor :name
2957
2552
 
2958
- # The normal response of the operation in case of success. If the original
2959
- # method returns no data on success, such as `Delete`, the response is
2960
- # `google.protobuf.Empty`. If the original method is standard
2961
- # `Get`/`Create`/`Update`, the response should be the resource. For other
2962
- # methods, the response should have the type `XxxResponse`, where `Xxx`
2963
- # is the original method name. For example, if the original method name
2964
- # is `TakeSnapshot()`, the inferred response type is
2965
- # `TakeSnapshotResponse`.
2553
+ # The normal response of the operation in case of success. If the original
2554
+ # method returns no data on success, such as `Delete`, the response is `google.
2555
+ # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
2556
+ # the response should be the resource. For other methods, the response should
2557
+ # have the type `XxxResponse`, where `Xxx` is the original method name. For
2558
+ # example, if the original method name is `TakeSnapshot()`, the inferred
2559
+ # response type is `TakeSnapshotResponse`.
2966
2560
  # Corresponds to the JSON property `response`
2967
2561
  # @return [Hash<String,Object>]
2968
2562
  attr_accessor :response
@@ -2987,17 +2581,17 @@ module Google
2987
2581
  include Google::Apis::Core::Hashable
2988
2582
 
2989
2583
  # The option's name. For protobuf built-in options (options defined in
2990
- # descriptor.proto), this is the short name. For example, `"map_entry"`.
2991
- # For custom options, it should be the fully-qualified name. For example,
2992
- # `"google.api.http"`.
2584
+ # descriptor.proto), this is the short name. For example, `"map_entry"`. For
2585
+ # custom options, it should be the fully-qualified name. For example, `"google.
2586
+ # api.http"`.
2993
2587
  # Corresponds to the JSON property `name`
2994
2588
  # @return [String]
2995
2589
  attr_accessor :name
2996
2590
 
2997
- # The option's value packed in an Any message. If the value is a primitive,
2998
- # the corresponding wrapper type defined in google/protobuf/wrappers.proto
2999
- # should be used. If the value is an enum, it should be stored as an int32
3000
- # value using the google.protobuf.Int32Value type.
2591
+ # The option's value packed in an Any message. If the value is a primitive, the
2592
+ # corresponding wrapper type defined in google/protobuf/wrappers.proto should be
2593
+ # used. If the value is an enum, it should be stored as an int32 value using the
2594
+ # google.protobuf.Int32Value type.
3001
2595
  # Corresponds to the JSON property `value`
3002
2596
  # @return [Hash<String,Object>]
3003
2597
  attr_accessor :value
@@ -3018,32 +2612,25 @@ module Google
3018
2612
  class Page
3019
2613
  include Google::Apis::Core::Hashable
3020
2614
 
3021
- # The Markdown content of the page. You can use <code>&#40;== include `path`
3022
- # ==&#41;</code> to include content from a Markdown file.
2615
+ # The Markdown content of the page. You can use (== include `path` ==) to
2616
+ # include content from a Markdown file.
3023
2617
  # Corresponds to the JSON property `content`
3024
2618
  # @return [String]
3025
2619
  attr_accessor :content
3026
2620
 
3027
- # The name of the page. It will be used as an identity of the page to
3028
- # generate URI of the page, text of the link to this page in navigation,
3029
- # etc. The full page name (start from the root page name to this page
3030
- # concatenated with `.`) can be used as reference to the page in your
3031
- # documentation. For example:
3032
- # <pre><code>pages:
3033
- # - name: Tutorial
3034
- # content: &#40;== include tutorial.md ==&#41;
3035
- # subpages:
3036
- # - name: Java
3037
- # content: &#40;== include tutorial_java.md ==&#41;
3038
- # </code></pre>
3039
- # You can reference `Java` page using Markdown reference link syntax:
3040
- # `Java`.
2621
+ # The name of the page. It will be used as an identity of the page to generate
2622
+ # URI of the page, text of the link to this page in navigation, etc. The full
2623
+ # page name (start from the root page name to this page concatenated with `.`)
2624
+ # can be used as reference to the page in your documentation. For example: pages:
2625
+ # - name: Tutorial content: (== include tutorial.md ==) subpages: - name: Java
2626
+ # content: (== include tutorial_java.md ==) You can reference `Java` page using
2627
+ # Markdown reference link syntax: `Java`.
3041
2628
  # Corresponds to the JSON property `name`
3042
2629
  # @return [String]
3043
2630
  attr_accessor :name
3044
2631
 
3045
- # Subpages of this page. The order of subpages specified here will be
3046
- # honored in the generated docset.
2632
+ # Subpages of this page. The order of subpages specified here will be honored in
2633
+ # the generated docset.
3047
2634
  # Corresponds to the JSON property `subpages`
3048
2635
  # @return [Array<Google::Apis::ServicenetworkingV1::Page>]
3049
2636
  attr_accessor :subpages
@@ -3064,20 +2651,17 @@ module Google
3064
2651
  class PolicyBinding
3065
2652
  include Google::Apis::Core::Hashable
3066
2653
 
3067
- # Required. Member to bind the role with. See
3068
- # /iam/docs/reference/rest/v1/Policy#Binding for how to format each member.
3069
- # Eg.
3070
- # - user:myuser@mydomain.com
3071
- # - serviceAccount:my-service-account@app.gserviceaccount.com
2654
+ # Required. Member to bind the role with. See /iam/docs/reference/rest/v1/Policy#
2655
+ # Binding for how to format each member. Eg. - user:myuser@mydomain.com -
2656
+ # serviceAccount:my-service-account@app.gserviceaccount.com
3072
2657
  # Corresponds to the JSON property `member`
3073
2658
  # @return [String]
3074
2659
  attr_accessor :member
3075
2660
 
3076
2661
  # Required. Role to apply. Only whitelisted roles can be used at the specified
3077
- # granularity. The role must be one of the following:
3078
- # - 'roles/container.hostServiceAgentUser' applied on the shared VPC host
3079
- # project
3080
- # - 'roles/compute.securityAdmin' applied on the shared VPC host project
2662
+ # granularity. The role must be one of the following: - 'roles/container.
2663
+ # hostServiceAgentUser' applied on the shared VPC host project - 'roles/compute.
2664
+ # securityAdmin' applied on the shared VPC host project
3081
2665
  # Corresponds to the JSON property `role`
3082
2666
  # @return [String]
3083
2667
  attr_accessor :role
@@ -3093,46 +2677,25 @@ module Google
3093
2677
  end
3094
2678
  end
3095
2679
 
3096
- # Quota configuration helps to achieve fairness and budgeting in service
3097
- # usage.
3098
- # The metric based quota configuration works this way:
3099
- # - The service configuration defines a set of metrics.
3100
- # - For API calls, the quota.metric_rules maps methods to metrics with
3101
- # corresponding costs.
3102
- # - The quota.limits defines limits on the metrics, which will be used for
3103
- # quota checks at runtime.
3104
- # An example quota configuration in yaml format:
3105
- # quota:
3106
- # limits:
3107
- # - name: apiWriteQpsPerProject
3108
- # metric: library.googleapis.com/write_calls
3109
- # unit: "1/min/`project`" # rate limit for consumer projects
3110
- # values:
3111
- # STANDARD: 10000
3112
- # # The metric rules bind all methods to the read_calls metric,
3113
- # # except for the UpdateBook and DeleteBook methods. These two methods
3114
- # # are mapped to the write_calls metric, with the UpdateBook method
3115
- # # consuming at twice rate as the DeleteBook method.
3116
- # metric_rules:
3117
- # - selector: "*"
3118
- # metric_costs:
3119
- # library.googleapis.com/read_calls: 1
3120
- # - selector: google.example.library.v1.LibraryService.UpdateBook
3121
- # metric_costs:
3122
- # library.googleapis.com/write_calls: 2
3123
- # - selector: google.example.library.v1.LibraryService.DeleteBook
3124
- # metric_costs:
3125
- # library.googleapis.com/write_calls: 1
3126
- # Corresponding Metric definition:
3127
- # metrics:
3128
- # - name: library.googleapis.com/read_calls
3129
- # display_name: Read requests
3130
- # metric_kind: DELTA
3131
- # value_type: INT64
3132
- # - name: library.googleapis.com/write_calls
3133
- # display_name: Write requests
3134
- # metric_kind: DELTA
3135
- # value_type: INT64
2680
+ # Quota configuration helps to achieve fairness and budgeting in service usage.
2681
+ # The metric based quota configuration works this way: - The service
2682
+ # configuration defines a set of metrics. - For API calls, the quota.
2683
+ # metric_rules maps methods to metrics with corresponding costs. - The quota.
2684
+ # limits defines limits on the metrics, which will be used for quota checks at
2685
+ # runtime. An example quota configuration in yaml format: quota: limits: - name:
2686
+ # apiWriteQpsPerProject metric: library.googleapis.com/write_calls unit: "1/min/`
2687
+ # project`" # rate limit for consumer projects values: STANDARD: 10000 # The
2688
+ # metric rules bind all methods to the read_calls metric, # except for the
2689
+ # UpdateBook and DeleteBook methods. These two methods # are mapped to the
2690
+ # write_calls metric, with the UpdateBook method # consuming at twice rate as
2691
+ # the DeleteBook method. metric_rules: - selector: "*" metric_costs: library.
2692
+ # googleapis.com/read_calls: 1 - selector: google.example.library.v1.
2693
+ # LibraryService.UpdateBook metric_costs: library.googleapis.com/write_calls: 2 -
2694
+ # selector: google.example.library.v1.LibraryService.DeleteBook metric_costs:
2695
+ # library.googleapis.com/write_calls: 1 Corresponding Metric definition: metrics:
2696
+ # - name: library.googleapis.com/read_calls display_name: Read requests
2697
+ # metric_kind: DELTA value_type: INT64 - name: library.googleapis.com/
2698
+ # write_calls display_name: Write requests metric_kind: DELTA value_type: INT64
3136
2699
  class Quota
3137
2700
  include Google::Apis::Core::Hashable
3138
2701
 
@@ -3141,8 +2704,8 @@ module Google
3141
2704
  # @return [Array<Google::Apis::ServicenetworkingV1::QuotaLimit>]
3142
2705
  attr_accessor :limits
3143
2706
 
3144
- # List of `MetricRule` definitions, each one mapping a selected method to one
3145
- # or more metrics.
2707
+ # List of `MetricRule` definitions, each one mapping a selected method to one or
2708
+ # more metrics.
3146
2709
  # Corresponds to the JSON property `metricRules`
3147
2710
  # @return [Array<Google::Apis::ServicenetworkingV1::MetricRule>]
3148
2711
  attr_accessor :metric_rules
@@ -3159,95 +2722,89 @@ module Google
3159
2722
  end
3160
2723
 
3161
2724
  # `QuotaLimit` defines a specific limit that applies over a specified duration
3162
- # for a limit type. There can be at most one limit for a duration and limit
3163
- # type combination defined within a `QuotaGroup`.
2725
+ # for a limit type. There can be at most one limit for a duration and limit type
2726
+ # combination defined within a `QuotaGroup`.
3164
2727
  class QuotaLimit
3165
2728
  include Google::Apis::Core::Hashable
3166
2729
 
3167
- # Default number of tokens that can be consumed during the specified
3168
- # duration. This is the number of tokens assigned when a client
3169
- # application developer activates the service for his/her project.
3170
- # Specifying a value of 0 will block all requests. This can be used if you
3171
- # are provisioning quota to selected consumers and blocking others.
3172
- # Similarly, a value of -1 will indicate an unlimited quota. No other
3173
- # negative values are allowed.
3174
- # Used by group-based quotas only.
2730
+ # Default number of tokens that can be consumed during the specified duration.
2731
+ # This is the number of tokens assigned when a client application developer
2732
+ # activates the service for his/her project. Specifying a value of 0 will block
2733
+ # all requests. This can be used if you are provisioning quota to selected
2734
+ # consumers and blocking others. Similarly, a value of -1 will indicate an
2735
+ # unlimited quota. No other negative values are allowed. Used by group-based
2736
+ # quotas only.
3175
2737
  # Corresponds to the JSON property `defaultLimit`
3176
2738
  # @return [Fixnum]
3177
2739
  attr_accessor :default_limit
3178
2740
 
3179
- # Optional. User-visible, extended description for this quota limit.
3180
- # Should be used only when more context is needed to understand this limit
3181
- # than provided by the limit's display name (see: `display_name`).
2741
+ # Optional. User-visible, extended description for this quota limit. Should be
2742
+ # used only when more context is needed to understand this limit than provided
2743
+ # by the limit's display name (see: `display_name`).
3182
2744
  # Corresponds to the JSON property `description`
3183
2745
  # @return [String]
3184
2746
  attr_accessor :description
3185
2747
 
3186
- # User-visible display name for this limit.
3187
- # Optional. If not set, the UI will provide a default display name based on
3188
- # the quota configuration. This field can be used to override the default
3189
- # display name generated from the configuration.
2748
+ # User-visible display name for this limit. Optional. If not set, the UI will
2749
+ # provide a default display name based on the quota configuration. This field
2750
+ # can be used to override the default display name generated from the
2751
+ # configuration.
3190
2752
  # Corresponds to the JSON property `displayName`
3191
2753
  # @return [String]
3192
2754
  attr_accessor :display_name
3193
2755
 
3194
- # Duration of this limit in textual notation. Must be "100s" or "1d".
3195
- # Used by group-based quotas only.
2756
+ # Duration of this limit in textual notation. Must be "100s" or "1d". Used by
2757
+ # group-based quotas only.
3196
2758
  # Corresponds to the JSON property `duration`
3197
2759
  # @return [String]
3198
2760
  attr_accessor :duration
3199
2761
 
3200
- # Free tier value displayed in the Developers Console for this limit.
3201
- # The free tier is the number of tokens that will be subtracted from the
3202
- # billed amount when billing is enabled.
3203
- # This field can only be set on a limit with duration "1d", in a billable
3204
- # group; it is invalid on any other limit. If this field is not set, it
3205
- # defaults to 0, indicating that there is no free tier for this service.
3206
- # Used by group-based quotas only.
2762
+ # Free tier value displayed in the Developers Console for this limit. The free
2763
+ # tier is the number of tokens that will be subtracted from the billed amount
2764
+ # when billing is enabled. This field can only be set on a limit with duration "
2765
+ # 1d", in a billable group; it is invalid on any other limit. If this field is
2766
+ # not set, it defaults to 0, indicating that there is no free tier for this
2767
+ # service. Used by group-based quotas only.
3207
2768
  # Corresponds to the JSON property `freeTier`
3208
2769
  # @return [Fixnum]
3209
2770
  attr_accessor :free_tier
3210
2771
 
3211
- # Maximum number of tokens that can be consumed during the specified
3212
- # duration. Client application developers can override the default limit up
3213
- # to this maximum. If specified, this value cannot be set to a value less
3214
- # than the default limit. If not specified, it is set to the default limit.
3215
- # To allow clients to apply overrides with no upper bound, set this to -1,
3216
- # indicating unlimited maximum quota.
3217
- # Used by group-based quotas only.
2772
+ # Maximum number of tokens that can be consumed during the specified duration.
2773
+ # Client application developers can override the default limit up to this
2774
+ # maximum. If specified, this value cannot be set to a value less than the
2775
+ # default limit. If not specified, it is set to the default limit. To allow
2776
+ # clients to apply overrides with no upper bound, set this to -1, indicating
2777
+ # unlimited maximum quota. Used by group-based quotas only.
3218
2778
  # Corresponds to the JSON property `maxLimit`
3219
2779
  # @return [Fixnum]
3220
2780
  attr_accessor :max_limit
3221
2781
 
3222
- # The name of the metric this quota limit applies to. The quota limits with
3223
- # the same metric will be checked together during runtime. The metric must be
2782
+ # The name of the metric this quota limit applies to. The quota limits with the
2783
+ # same metric will be checked together during runtime. The metric must be
3224
2784
  # defined within the service config.
3225
2785
  # Corresponds to the JSON property `metric`
3226
2786
  # @return [String]
3227
2787
  attr_accessor :metric
3228
2788
 
3229
- # Name of the quota limit.
3230
- # The name must be provided, and it must be unique within the service. The
3231
- # name can only include alphanumeric characters as well as '-'.
3232
- # The maximum length of the limit name is 64 characters.
2789
+ # Name of the quota limit. The name must be provided, and it must be unique
2790
+ # within the service. The name can only include alphanumeric characters as well
2791
+ # as '-'. The maximum length of the limit name is 64 characters.
3233
2792
  # Corresponds to the JSON property `name`
3234
2793
  # @return [String]
3235
2794
  attr_accessor :name
3236
2795
 
3237
- # Specify the unit of the quota limit. It uses the same syntax as
3238
- # Metric.unit. The supported unit kinds are determined by the quota
3239
- # backend system.
3240
- # Here are some examples:
3241
- # * "1/min/`project`" for quota per minute per project.
3242
- # Note: the order of unit components is insignificant.
3243
- # The "1" at the beginning is required to follow the metric unit syntax.
2796
+ # Specify the unit of the quota limit. It uses the same syntax as Metric.unit.
2797
+ # The supported unit kinds are determined by the quota backend system. Here are
2798
+ # some examples: * "1/min/`project`" for quota per minute per project. Note: the
2799
+ # order of unit components is insignificant. The "1" at the beginning is
2800
+ # required to follow the metric unit syntax.
3244
2801
  # Corresponds to the JSON property `unit`
3245
2802
  # @return [String]
3246
2803
  attr_accessor :unit
3247
2804
 
3248
2805
  # Tiered limit values. You must specify this as a key:value pair, with an
3249
- # integer value that is the maximum number of requests allowed for the
3250
- # specified unit. Currently only STANDARD is supported.
2806
+ # integer value that is the maximum number of requests allowed for the specified
2807
+ # unit. Currently only STANDARD is supported.
3251
2808
  # Corresponds to the JSON property `values`
3252
2809
  # @return [Hash<String,Fixnum>]
3253
2810
  attr_accessor :values
@@ -3275,15 +2832,14 @@ module Google
3275
2832
  class Range
3276
2833
  include Google::Apis::Core::Hashable
3277
2834
 
3278
- # CIDR range in "10.x.x.x/y" format that is within the
3279
- # allocated ranges and currently unused.
2835
+ # CIDR range in "10.x.x.x/y" format that is within the allocated ranges and
2836
+ # currently unused.
3280
2837
  # Corresponds to the JSON property `ipCidrRange`
3281
2838
  # @return [String]
3282
2839
  attr_accessor :ip_cidr_range
3283
2840
 
3284
2841
  # In the Shared VPC host project, the VPC network that's peered with the
3285
- # consumer network. For example:
3286
- # `projects/1234321/global/networks/host-network`
2842
+ # consumer network. For example: `projects/1234321/global/networks/host-network`
3287
2843
  # Corresponds to the JSON property `network`
3288
2844
  # @return [String]
3289
2845
  attr_accessor :network
@@ -3304,19 +2860,17 @@ module Google
3304
2860
  include Google::Apis::Core::Hashable
3305
2861
 
3306
2862
  # Required. The size of the desired subnet. Use usual CIDR range notation. For
3307
- # example,
3308
- # '30' to find unused x.x.x.x/30 CIDR range. The goal is to determine if one
3309
- # of the allocated ranges has enough free space for a subnet of the requested
3310
- # size.
2863
+ # example, '30' to find unused x.x.x.x/30 CIDR range. The goal is to determine
2864
+ # if one of the allocated ranges has enough free space for a subnet of the
2865
+ # requested size.
3311
2866
  # Corresponds to the JSON property `ipPrefixLength`
3312
2867
  # @return [Fixnum]
3313
2868
  attr_accessor :ip_prefix_length
3314
2869
 
3315
- # Optional. DO NOT USE - Under development.
3316
- # The size of the desired secondary ranges for the subnet. Use usual CIDR
3317
- # range notation. For example, '30' to find unused x.x.x.x/30 CIDR range. The
3318
- # goal is to determine that the allocated ranges have enough free space for
3319
- # all the requested secondary ranges.
2870
+ # Optional. DO NOT USE - Under development. The size of the desired secondary
2871
+ # ranges for the subnet. Use usual CIDR range notation. For example, '30' to
2872
+ # find unused x.x.x.x/30 CIDR range. The goal is to determine that the allocated
2873
+ # ranges have enough free space for all the requested secondary ranges.
3320
2874
  # Corresponds to the JSON property `secondaryRangeIpPrefixLengths`
3321
2875
  # @return [Array<Fixnum>]
3322
2876
  attr_accessor :secondary_range_ip_prefix_lengths
@@ -3353,9 +2907,8 @@ module Google
3353
2907
  include Google::Apis::Core::Hashable
3354
2908
 
3355
2909
  # Required. The network that the consumer is using to connect with services.
3356
- # Must be in the form of projects/`project`/global/networks/`network`
3357
- # `project` is the project number, as in '12345'
3358
- # `network` is the network name.
2910
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
2911
+ # is the project number, as in '12345' `network` is the network name.
3359
2912
  # Corresponds to the JSON property `consumerNetwork`
3360
2913
  # @return [String]
3361
2914
  attr_accessor :consumer_network
@@ -3366,8 +2919,7 @@ module Google
3366
2919
  attr_accessor :dns_record_set
3367
2920
 
3368
2921
  # Required. The name of the private DNS zone in the shared producer host project
3369
- # from
3370
- # which the record set will be removed.
2922
+ # from which the record set will be removed.
3371
2923
  # Corresponds to the JSON property `zone`
3372
2924
  # @return [String]
3373
2925
  attr_accessor :zone
@@ -3417,16 +2969,14 @@ module Google
3417
2969
  include Google::Apis::Core::Hashable
3418
2970
 
3419
2971
  # Required. The network that the consumer is using to connect with services.
3420
- # Must be in the form of projects/`project`/global/networks/`network`
3421
- # `project` is the project number, as in '12345'
3422
- # `network` is the network name.
2972
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
2973
+ # is the project number, as in '12345' `network` is the network name.
3423
2974
  # Corresponds to the JSON property `consumerNetwork`
3424
2975
  # @return [String]
3425
2976
  attr_accessor :consumer_network
3426
2977
 
3427
2978
  # Required. The name for both the private zone in the shared producer host
3428
- # project and
3429
- # the peering zone in the consumer project.
2979
+ # project and the peering zone in the consumer project.
3430
2980
  # Corresponds to the JSON property `name`
3431
2981
  # @return [String]
3432
2982
  attr_accessor :name
@@ -3471,15 +3021,15 @@ module Google
3471
3021
  attr_accessor :name
3472
3022
 
3473
3023
  # Fully-qualified URL of the VPC network in the producer host tenant project
3474
- # that this route applies to. For example:
3475
- # `projects/123456/global/networks/host-network`
3024
+ # that this route applies to. For example: `projects/123456/global/networks/host-
3025
+ # network`
3476
3026
  # Corresponds to the JSON property `network`
3477
3027
  # @return [String]
3478
3028
  attr_accessor :network
3479
3029
 
3480
3030
  # Fully-qualified URL of the gateway that should handle matching packets that
3481
- # this route applies to. For example:
3482
- # `projects/123456/global/gateways/default-internet-gateway`
3031
+ # this route applies to. For example: `projects/123456/global/gateways/default-
3032
+ # internet-gateway`
3483
3033
  # Corresponds to the JSON property `nextHopGateway`
3484
3034
  # @return [String]
3485
3035
  attr_accessor :next_hop_gateway
@@ -3502,18 +3052,17 @@ module Google
3502
3052
  include Google::Apis::Core::Hashable
3503
3053
 
3504
3054
  # Required. The prefix length of the IP range. Use usual CIDR range notation.
3505
- # For
3506
- # example, '30' to find unused x.x.x.x/30 CIDR range. Actual range will be
3507
- # determined using allocated range for the consumer peered network and
3508
- # returned in the result.
3055
+ # For example, '30' to find unused x.x.x.x/30 CIDR range. Actual range will be
3056
+ # determined using allocated range for the consumer peered network and returned
3057
+ # in the result.
3509
3058
  # Corresponds to the JSON property `ipPrefixLength`
3510
3059
  # @return [Fixnum]
3511
3060
  attr_accessor :ip_prefix_length
3512
3061
 
3513
- # Network name in the consumer project. This network must have been
3514
- # already peered with a shared VPC network using CreateConnection
3515
- # method. Must be in a form 'projects/`project`/global/networks/`network`'.
3516
- # `project` is a project number, as in '12345' `network` is network name.
3062
+ # Network name in the consumer project. This network must have been already
3063
+ # peered with a shared VPC network using CreateConnection method. Must be in a
3064
+ # form 'projects/`project`/global/networks/`network`'. `project` is a project
3065
+ # number, as in '12345' `network` is network name.
3517
3066
  # Corresponds to the JSON property `network`
3518
3067
  # @return [String]
3519
3068
  attr_accessor :network
@@ -3530,50 +3079,32 @@ module Google
3530
3079
  end
3531
3080
 
3532
3081
  # `Service` is the root object of Google service configuration schema. It
3533
- # describes basic information about a service, such as the name and the
3534
- # title, and delegates other aspects to sub-sections. Each sub-section is
3535
- # either a proto message or a repeated proto message that configures a
3536
- # specific aspect, such as auth. See each proto message definition for details.
3537
- # Example:
3538
- # type: google.api.Service
3539
- # config_version: 3
3540
- # name: calendar.googleapis.com
3541
- # title: Google Calendar API
3542
- # apis:
3543
- # - name: google.calendar.v3.Calendar
3544
- # authentication:
3545
- # providers:
3546
- # - id: google_calendar_auth
3547
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
3548
- # issuer: https://securetoken.google.com
3549
- # rules:
3550
- # - selector: "*"
3551
- # requirements:
3552
- # provider_id: google_calendar_auth
3082
+ # describes basic information about a service, such as the name and the title,
3083
+ # and delegates other aspects to sub-sections. Each sub-section is either a
3084
+ # proto message or a repeated proto message that configures a specific aspect,
3085
+ # such as auth. See each proto message definition for details. Example: type:
3086
+ # google.api.Service config_version: 3 name: calendar.googleapis.com title:
3087
+ # Google Calendar API apis: - name: google.calendar.v3.Calendar authentication:
3088
+ # providers: - id: google_calendar_auth jwks_uri: https://www.googleapis.com/
3089
+ # oauth2/v1/certs issuer: https://securetoken.google.com rules: - selector: "*"
3090
+ # requirements: provider_id: google_calendar_auth
3553
3091
  class Service
3554
3092
  include Google::Apis::Core::Hashable
3555
3093
 
3556
- # A list of API interfaces exported by this service. Only the `name` field
3557
- # of the google.protobuf.Api needs to be provided by the configuration
3558
- # author, as the remaining fields will be derived from the IDL during the
3559
- # normalization process. It is an error to specify an API interface here
3560
- # which cannot be resolved against the associated IDL files.
3094
+ # A list of API interfaces exported by this service. Only the `name` field of
3095
+ # the google.protobuf.Api needs to be provided by the configuration author, as
3096
+ # the remaining fields will be derived from the IDL during the normalization
3097
+ # process. It is an error to specify an API interface here which cannot be
3098
+ # resolved against the associated IDL files.
3561
3099
  # Corresponds to the JSON property `apis`
3562
3100
  # @return [Array<Google::Apis::ServicenetworkingV1::Api>]
3563
3101
  attr_accessor :apis
3564
3102
 
3565
- # `Authentication` defines the authentication configuration for an API.
3566
- # Example for an API targeted for external use:
3567
- # name: calendar.googleapis.com
3568
- # authentication:
3569
- # providers:
3570
- # - id: google_calendar_auth
3571
- # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
3572
- # issuer: https://securetoken.google.com
3573
- # rules:
3574
- # - selector: "*"
3575
- # requirements:
3576
- # provider_id: google_calendar_auth
3103
+ # `Authentication` defines the authentication configuration for an API. Example
3104
+ # for an API targeted for external use: name: calendar.googleapis.com
3105
+ # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
3106
+ # googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: -
3107
+ # selector: "*" requirements: provider_id: google_calendar_auth
3577
3108
  # Corresponds to the JSON property `authentication`
3578
3109
  # @return [Google::Apis::ServicenetworkingV1::Authentication]
3579
3110
  attr_accessor :authentication
@@ -3583,211 +3114,136 @@ module Google
3583
3114
  # @return [Google::Apis::ServicenetworkingV1::Backend]
3584
3115
  attr_accessor :backend
3585
3116
 
3586
- # Billing related configuration of the service.
3587
- # The following example shows how to configure monitored resources and metrics
3588
- # for billing, `consumer_destinations` is the only supported destination and
3589
- # the monitored resources need at least one label key
3590
- # `cloud.googleapis.com/location` to indicate the location of the billing
3591
- # usage, using different monitored resources between monitoring and billing is
3592
- # recommended so they can be evolved independently:
3593
- # monitored_resources:
3594
- # - type: library.googleapis.com/billing_branch
3595
- # labels:
3596
- # - key: cloud.googleapis.com/location
3597
- # description: |
3598
- # Predefined label to support billing location restriction.
3599
- # - key: city
3600
- # description: |
3601
- # Custom label to define the city where the library branch is located
3602
- # in.
3603
- # - key: name
3604
- # description: Custom label to define the name of the library branch.
3605
- # metrics:
3606
- # - name: library.googleapis.com/book/borrowed_count
3607
- # metric_kind: DELTA
3608
- # value_type: INT64
3609
- # unit: "1"
3610
- # billing:
3611
- # consumer_destinations:
3612
- # - monitored_resource: library.googleapis.com/billing_branch
3613
- # metrics:
3614
- # - library.googleapis.com/book/borrowed_count
3117
+ # Billing related configuration of the service. The following example shows how
3118
+ # to configure monitored resources and metrics for billing, `
3119
+ # consumer_destinations` is the only supported destination and the monitored
3120
+ # resources need at least one label key `cloud.googleapis.com/location` to
3121
+ # indicate the location of the billing usage, using different monitored
3122
+ # resources between monitoring and billing is recommended so they can be evolved
3123
+ # independently: monitored_resources: - type: library.googleapis.com/
3124
+ # billing_branch labels: - key: cloud.googleapis.com/location description: |
3125
+ # Predefined label to support billing location restriction. - key: city
3126
+ # description: | Custom label to define the city where the library branch is
3127
+ # located in. - key: name description: Custom label to define the name of the
3128
+ # library branch. metrics: - name: library.googleapis.com/book/borrowed_count
3129
+ # metric_kind: DELTA value_type: INT64 unit: "1" billing: consumer_destinations:
3130
+ # - monitored_resource: library.googleapis.com/billing_branch metrics: - library.
3131
+ # googleapis.com/book/borrowed_count
3615
3132
  # Corresponds to the JSON property `billing`
3616
3133
  # @return [Google::Apis::ServicenetworkingV1::Billing]
3617
3134
  attr_accessor :billing
3618
3135
 
3619
- # The semantic version of the service configuration. The config version
3620
- # affects the interpretation of the service configuration. For example,
3621
- # certain features are enabled by default for certain config versions.
3622
- # The latest config version is `3`.
3136
+ # The semantic version of the service configuration. The config version affects
3137
+ # the interpretation of the service configuration. For example, certain features
3138
+ # are enabled by default for certain config versions. The latest config version
3139
+ # is `3`.
3623
3140
  # Corresponds to the JSON property `configVersion`
3624
3141
  # @return [Fixnum]
3625
3142
  attr_accessor :config_version
3626
3143
 
3627
- # `Context` defines which contexts an API requests.
3628
- # Example:
3629
- # context:
3630
- # rules:
3631
- # - selector: "*"
3632
- # requested:
3633
- # - google.rpc.context.ProjectContext
3634
- # - google.rpc.context.OriginContext
3635
- # The above specifies that all methods in the API request
3636
- # `google.rpc.context.ProjectContext` and
3637
- # `google.rpc.context.OriginContext`.
3638
- # Available context types are defined in package
3639
- # `google.rpc.context`.
3640
- # This also provides mechanism to whitelist any protobuf message extension that
3641
- # can be sent in grpc metadata using “x-goog-ext-<extension_id>-bin” and
3642
- # “x-goog-ext-<extension_id>-jspb” format. For example, list any service
3643
- # specific protobuf types that can appear in grpc metadata as follows in your
3644
- # yaml file:
3645
- # Example:
3646
- # context:
3647
- # rules:
3648
- # - selector: "google.example.library.v1.LibraryService.CreateBook"
3649
- # allowed_request_extensions:
3650
- # - google.foo.v1.NewExtension
3651
- # allowed_response_extensions:
3652
- # - google.foo.v1.NewExtension
3653
- # You can also specify extension ID instead of fully qualified extension name
3654
- # here.
3144
+ # `Context` defines which contexts an API requests. Example: context: rules: -
3145
+ # selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.
3146
+ # context.OriginContext The above specifies that all methods in the API request `
3147
+ # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
3148
+ # Available context types are defined in package `google.rpc.context`. This also
3149
+ # provides mechanism to whitelist any protobuf message extension that can be
3150
+ # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
3151
+ # For example, list any service specific protobuf types that can appear in grpc
3152
+ # metadata as follows in your yaml file: Example: context: rules: - selector: "
3153
+ # google.example.library.v1.LibraryService.CreateBook"
3154
+ # allowed_request_extensions: - google.foo.v1.NewExtension
3155
+ # allowed_response_extensions: - google.foo.v1.NewExtension You can also specify
3156
+ # extension ID instead of fully qualified extension name here.
3655
3157
  # Corresponds to the JSON property `context`
3656
3158
  # @return [Google::Apis::ServicenetworkingV1::Context]
3657
3159
  attr_accessor :context
3658
3160
 
3659
- # Selects and configures the service controller used by the service. The
3660
- # service controller handles features like abuse, quota, billing, logging,
3661
- # monitoring, etc.
3161
+ # Selects and configures the service controller used by the service. The service
3162
+ # controller handles features like abuse, quota, billing, logging, monitoring,
3163
+ # etc.
3662
3164
  # Corresponds to the JSON property `control`
3663
3165
  # @return [Google::Apis::ServicenetworkingV1::Control]
3664
3166
  attr_accessor :control
3665
3167
 
3666
- # Customize service error responses. For example, list any service
3667
- # specific protobuf types that can appear in error detail lists of
3668
- # error responses.
3669
- # Example:
3670
- # custom_error:
3671
- # types:
3672
- # - google.foo.v1.CustomError
3673
- # - google.foo.v1.AnotherError
3168
+ # Customize service error responses. For example, list any service specific
3169
+ # protobuf types that can appear in error detail lists of error responses.
3170
+ # Example: custom_error: types: - google.foo.v1.CustomError - google.foo.v1.
3171
+ # AnotherError
3674
3172
  # Corresponds to the JSON property `customError`
3675
3173
  # @return [Google::Apis::ServicenetworkingV1::CustomError]
3676
3174
  attr_accessor :custom_error
3677
3175
 
3678
- # `Documentation` provides the information for describing a service.
3679
- # Example:
3680
- # <pre><code>documentation:
3681
- # summary: >
3682
- # The Google Calendar API gives access
3683
- # to most calendar features.
3684
- # pages:
3685
- # - name: Overview
3686
- # content: &#40;== include google/foo/overview.md ==&#41;
3687
- # - name: Tutorial
3688
- # content: &#40;== include google/foo/tutorial.md ==&#41;
3689
- # subpages;
3690
- # - name: Java
3691
- # content: &#40;== include google/foo/tutorial_java.md ==&#41;
3692
- # rules:
3693
- # - selector: google.calendar.Calendar.Get
3694
- # description: >
3695
- # ...
3696
- # - selector: google.calendar.Calendar.Put
3697
- # description: >
3698
- # ...
3699
- # </code></pre>
3700
- # Documentation is provided in markdown syntax. In addition to
3701
- # standard markdown features, definition lists, tables and fenced
3702
- # code blocks are supported. Section headers can be provided and are
3703
- # interpreted relative to the section nesting of the context where
3704
- # a documentation fragment is embedded.
3705
- # Documentation from the IDL is merged with documentation defined
3706
- # via the config at normalization time, where documentation provided
3707
- # by config rules overrides IDL provided.
3708
- # A number of constructs specific to the API platform are supported
3709
- # in documentation text.
3710
- # In order to reference a proto element, the following
3711
- # notation can be used:
3712
- # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
3713
- # To override the display text used for the link, this can be used:
3714
- # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
3715
- # Text can be excluded from doc using the following notation:
3716
- # <pre><code>&#40;-- internal comment --&#41;</code></pre>
3717
- # A few directives are available in documentation. Note that
3718
- # directives must appear on a single line to be properly
3719
- # identified. The `include` directive includes a markdown file from
3720
- # an external source:
3721
- # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
3722
- # The `resource_for` directive marks a message to be the resource of
3723
- # a collection in REST view. If it is not specified, tools attempt
3724
- # to infer the resource from the operations in a collection:
3725
- # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
3726
- # The directive `suppress_warning` does not directly affect documentation
3727
- # and is documented together with service config validation.
3176
+ # `Documentation` provides the information for describing a service. Example:
3177
+ # documentation: summary: > The Google Calendar API gives access to most
3178
+ # calendar features. pages: - name: Overview content: (== include google/foo/
3179
+ # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
3180
+ # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
3181
+ # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
3182
+ # google.calendar.Calendar.Put description: > ... Documentation is provided in
3183
+ # markdown syntax. In addition to standard markdown features, definition lists,
3184
+ # tables and fenced code blocks are supported. Section headers can be provided
3185
+ # and are interpreted relative to the section nesting of the context where a
3186
+ # documentation fragment is embedded. Documentation from the IDL is merged with
3187
+ # documentation defined via the config at normalization time, where
3188
+ # documentation provided by config rules overrides IDL provided. A number of
3189
+ # constructs specific to the API platform are supported in documentation text.
3190
+ # In order to reference a proto element, the following notation can be used: [
3191
+ # fully.qualified.proto.name][] To override the display text used for the link,
3192
+ # this can be used: [display text][fully.qualified.proto.name] Text can be
3193
+ # excluded from doc using the following notation: (-- internal comment --) A few
3194
+ # directives are available in documentation. Note that directives must appear on
3195
+ # a single line to be properly identified. The `include` directive includes a
3196
+ # markdown file from an external source: (== include path/to/file ==) The `
3197
+ # resource_for` directive marks a message to be the resource of a collection in
3198
+ # REST view. If it is not specified, tools attempt to infer the resource from
3199
+ # the operations in a collection: (== resource_for v1.shelves.books ==) The
3200
+ # directive `suppress_warning` does not directly affect documentation and is
3201
+ # documented together with service config validation.
3728
3202
  # Corresponds to the JSON property `documentation`
3729
3203
  # @return [Google::Apis::ServicenetworkingV1::Documentation]
3730
3204
  attr_accessor :documentation
3731
3205
 
3732
- # Configuration for network endpoints. If this is empty, then an endpoint
3733
- # with the same name as the service is automatically generated to service all
3734
- # defined APIs.
3206
+ # Configuration for network endpoints. If this is empty, then an endpoint with
3207
+ # the same name as the service is automatically generated to service all defined
3208
+ # APIs.
3735
3209
  # Corresponds to the JSON property `endpoints`
3736
3210
  # @return [Array<Google::Apis::ServicenetworkingV1::Endpoint>]
3737
3211
  attr_accessor :endpoints
3738
3212
 
3739
- # A list of all enum types included in this API service. Enums
3740
- # referenced directly or indirectly by the `apis` are automatically
3741
- # included. Enums which are not referenced but shall be included
3742
- # should be listed here by name. Example:
3743
- # enums:
3744
- # - name: google.someapi.v1.SomeEnum
3213
+ # A list of all enum types included in this API service. Enums referenced
3214
+ # directly or indirectly by the `apis` are automatically included. Enums which
3215
+ # are not referenced but shall be included should be listed here by name.
3216
+ # Example: enums: - name: google.someapi.v1.SomeEnum
3745
3217
  # Corresponds to the JSON property `enums`
3746
3218
  # @return [Array<Google::Apis::ServicenetworkingV1::Enum>]
3747
3219
  attr_accessor :enums
3748
3220
 
3749
3221
  # Defines the HTTP configuration for an API service. It contains a list of
3750
- # HttpRule, each specifying the mapping of an RPC method
3751
- # to one or more HTTP REST API methods.
3222
+ # HttpRule, each specifying the mapping of an RPC method to one or more HTTP
3223
+ # REST API methods.
3752
3224
  # Corresponds to the JSON property `http`
3753
3225
  # @return [Google::Apis::ServicenetworkingV1::Http]
3754
3226
  attr_accessor :http
3755
3227
 
3756
- # A unique ID for a specific instance of this message, typically assigned
3757
- # by the client for tracking purpose. Must be no longer than 63 characters
3758
- # and only lower case letters, digits, '.', '_' and '-' are allowed. If
3759
- # empty, the server may choose to generate one instead.
3228
+ # A unique ID for a specific instance of this message, typically assigned by the
3229
+ # client for tracking purpose. Must be no longer than 63 characters and only
3230
+ # lower case letters, digits, '.', '_' and '-' are allowed. If empty, the server
3231
+ # may choose to generate one instead.
3760
3232
  # Corresponds to the JSON property `id`
3761
3233
  # @return [String]
3762
3234
  attr_accessor :id
3763
3235
 
3764
- # Logging configuration of the service.
3765
- # The following example shows how to configure logs to be sent to the
3766
- # producer and consumer projects. In the example, the `activity_history`
3767
- # log is sent to both the producer and consumer projects, whereas the
3768
- # `purchase_history` log is only sent to the producer project.
3769
- # monitored_resources:
3770
- # - type: library.googleapis.com/branch
3771
- # labels:
3772
- # - key: /city
3773
- # description: The city where the library branch is located in.
3774
- # - key: /name
3775
- # description: The name of the branch.
3776
- # logs:
3777
- # - name: activity_history
3778
- # labels:
3779
- # - key: /customer_id
3780
- # - name: purchase_history
3781
- # logging:
3782
- # producer_destinations:
3783
- # - monitored_resource: library.googleapis.com/branch
3784
- # logs:
3785
- # - activity_history
3786
- # - purchase_history
3787
- # consumer_destinations:
3788
- # - monitored_resource: library.googleapis.com/branch
3789
- # logs:
3790
- # - activity_history
3236
+ # Logging configuration of the service. The following example shows how to
3237
+ # configure logs to be sent to the producer and consumer projects. In the
3238
+ # example, the `activity_history` log is sent to both the producer and consumer
3239
+ # projects, whereas the `purchase_history` log is only sent to the producer
3240
+ # project. monitored_resources: - type: library.googleapis.com/branch labels: -
3241
+ # key: /city description: The city where the library branch is located in. - key:
3242
+ # /name description: The name of the branch. logs: - name: activity_history
3243
+ # labels: - key: /customer_id - name: purchase_history logging:
3244
+ # producer_destinations: - monitored_resource: library.googleapis.com/branch
3245
+ # logs: - activity_history - purchase_history consumer_destinations: -
3246
+ # monitored_resource: library.googleapis.com/branch logs: - activity_history
3791
3247
  # Corresponds to the JSON property `logging`
3792
3248
  # @return [Google::Apis::ServicenetworkingV1::Logging]
3793
3249
  attr_accessor :logging
@@ -3802,70 +3258,41 @@ module Google
3802
3258
  # @return [Array<Google::Apis::ServicenetworkingV1::MetricDescriptor>]
3803
3259
  attr_accessor :metrics
3804
3260
 
3805
- # Defines the monitored resources used by this service. This is required
3806
- # by the Service.monitoring and Service.logging configurations.
3261
+ # Defines the monitored resources used by this service. This is required by the
3262
+ # Service.monitoring and Service.logging configurations.
3807
3263
  # Corresponds to the JSON property `monitoredResources`
3808
3264
  # @return [Array<Google::Apis::ServicenetworkingV1::MonitoredResourceDescriptor>]
3809
3265
  attr_accessor :monitored_resources
3810
3266
 
3811
- # Monitoring configuration of the service.
3812
- # The example below shows how to configure monitored resources and metrics
3813
- # for monitoring. In the example, a monitored resource and two metrics are
3814
- # defined. The `library.googleapis.com/book/returned_count` metric is sent
3815
- # to both producer and consumer projects, whereas the
3816
- # `library.googleapis.com/book/num_overdue` metric is only sent to the
3817
- # consumer project.
3818
- # monitored_resources:
3819
- # - type: library.googleapis.com/Branch
3820
- # display_name: "Library Branch"
3821
- # description: "A branch of a library."
3822
- # launch_stage: GA
3823
- # labels:
3824
- # - key: resource_container
3825
- # description: "The Cloud container (ie. project id) for the Branch."
3826
- # - key: location
3827
- # description: "The location of the library branch."
3828
- # - key: branch_id
3829
- # description: "The id of the branch."
3830
- # metrics:
3831
- # - name: library.googleapis.com/book/returned_count
3832
- # display_name: "Books Returned"
3833
- # description: "The count of books that have been returned."
3834
- # launch_stage: GA
3835
- # metric_kind: DELTA
3836
- # value_type: INT64
3837
- # unit: "1"
3838
- # labels:
3839
- # - key: customer_id
3840
- # description: "The id of the customer."
3841
- # - name: library.googleapis.com/book/num_overdue
3842
- # display_name: "Books Overdue"
3843
- # description: "The current number of overdue books."
3844
- # launch_stage: GA
3845
- # metric_kind: GAUGE
3846
- # value_type: INT64
3847
- # unit: "1"
3848
- # labels:
3849
- # - key: customer_id
3850
- # description: "The id of the customer."
3851
- # monitoring:
3852
- # producer_destinations:
3853
- # - monitored_resource: library.googleapis.com/Branch
3854
- # metrics:
3855
- # - library.googleapis.com/book/returned_count
3856
- # consumer_destinations:
3857
- # - monitored_resource: library.googleapis.com/Branch
3858
- # metrics:
3859
- # - library.googleapis.com/book/returned_count
3860
- # - library.googleapis.com/book/num_overdue
3267
+ # Monitoring configuration of the service. The example below shows how to
3268
+ # configure monitored resources and metrics for monitoring. In the example, a
3269
+ # monitored resource and two metrics are defined. The `library.googleapis.com/
3270
+ # book/returned_count` metric is sent to both producer and consumer projects,
3271
+ # whereas the `library.googleapis.com/book/num_overdue` metric is only sent to
3272
+ # the consumer project. monitored_resources: - type: library.googleapis.com/
3273
+ # Branch display_name: "Library Branch" description: "A branch of a library."
3274
+ # launch_stage: GA labels: - key: resource_container description: "The Cloud
3275
+ # container (ie. project id) for the Branch." - key: location description: "The
3276
+ # location of the library branch." - key: branch_id description: "The id of the
3277
+ # branch." metrics: - name: library.googleapis.com/book/returned_count
3278
+ # display_name: "Books Returned" description: "The count of books that have been
3279
+ # returned." launch_stage: GA metric_kind: DELTA value_type: INT64 unit: "1"
3280
+ # labels: - key: customer_id description: "The id of the customer." - name:
3281
+ # library.googleapis.com/book/num_overdue display_name: "Books Overdue"
3282
+ # description: "The current number of overdue books." launch_stage: GA
3283
+ # metric_kind: GAUGE value_type: INT64 unit: "1" labels: - key: customer_id
3284
+ # description: "The id of the customer." monitoring: producer_destinations: -
3285
+ # monitored_resource: library.googleapis.com/Branch metrics: - library.
3286
+ # googleapis.com/book/returned_count consumer_destinations: - monitored_resource:
3287
+ # library.googleapis.com/Branch metrics: - library.googleapis.com/book/
3288
+ # returned_count - library.googleapis.com/book/num_overdue
3861
3289
  # Corresponds to the JSON property `monitoring`
3862
3290
  # @return [Google::Apis::ServicenetworkingV1::Monitoring]
3863
3291
  attr_accessor :monitoring
3864
3292
 
3865
- # The service name, which is a DNS-like logical identifier for the
3866
- # service, such as `calendar.googleapis.com`. The service name
3867
- # typically goes through DNS verification to make sure the owner
3868
- # of the service also owns the DNS name.
3293
+ # The service name, which is a DNS-like logical identifier for the service, such
3294
+ # as `calendar.googleapis.com`. The service name typically goes through DNS
3295
+ # verification to make sure the owner of the service also owns the DNS name.
3869
3296
  # Corresponds to the JSON property `name`
3870
3297
  # @return [String]
3871
3298
  attr_accessor :name
@@ -3875,46 +3302,25 @@ module Google
3875
3302
  # @return [String]
3876
3303
  attr_accessor :producer_project_id
3877
3304
 
3878
- # Quota configuration helps to achieve fairness and budgeting in service
3879
- # usage.
3880
- # The metric based quota configuration works this way:
3881
- # - The service configuration defines a set of metrics.
3882
- # - For API calls, the quota.metric_rules maps methods to metrics with
3883
- # corresponding costs.
3884
- # - The quota.limits defines limits on the metrics, which will be used for
3885
- # quota checks at runtime.
3886
- # An example quota configuration in yaml format:
3887
- # quota:
3888
- # limits:
3889
- # - name: apiWriteQpsPerProject
3890
- # metric: library.googleapis.com/write_calls
3891
- # unit: "1/min/`project`" # rate limit for consumer projects
3892
- # values:
3893
- # STANDARD: 10000
3894
- # # The metric rules bind all methods to the read_calls metric,
3895
- # # except for the UpdateBook and DeleteBook methods. These two methods
3896
- # # are mapped to the write_calls metric, with the UpdateBook method
3897
- # # consuming at twice rate as the DeleteBook method.
3898
- # metric_rules:
3899
- # - selector: "*"
3900
- # metric_costs:
3901
- # library.googleapis.com/read_calls: 1
3902
- # - selector: google.example.library.v1.LibraryService.UpdateBook
3903
- # metric_costs:
3904
- # library.googleapis.com/write_calls: 2
3905
- # - selector: google.example.library.v1.LibraryService.DeleteBook
3906
- # metric_costs:
3907
- # library.googleapis.com/write_calls: 1
3908
- # Corresponding Metric definition:
3909
- # metrics:
3910
- # - name: library.googleapis.com/read_calls
3911
- # display_name: Read requests
3912
- # metric_kind: DELTA
3913
- # value_type: INT64
3914
- # - name: library.googleapis.com/write_calls
3915
- # display_name: Write requests
3916
- # metric_kind: DELTA
3917
- # value_type: INT64
3305
+ # Quota configuration helps to achieve fairness and budgeting in service usage.
3306
+ # The metric based quota configuration works this way: - The service
3307
+ # configuration defines a set of metrics. - For API calls, the quota.
3308
+ # metric_rules maps methods to metrics with corresponding costs. - The quota.
3309
+ # limits defines limits on the metrics, which will be used for quota checks at
3310
+ # runtime. An example quota configuration in yaml format: quota: limits: - name:
3311
+ # apiWriteQpsPerProject metric: library.googleapis.com/write_calls unit: "1/min/`
3312
+ # project`" # rate limit for consumer projects values: STANDARD: 10000 # The
3313
+ # metric rules bind all methods to the read_calls metric, # except for the
3314
+ # UpdateBook and DeleteBook methods. These two methods # are mapped to the
3315
+ # write_calls metric, with the UpdateBook method # consuming at twice rate as
3316
+ # the DeleteBook method. metric_rules: - selector: "*" metric_costs: library.
3317
+ # googleapis.com/read_calls: 1 - selector: google.example.library.v1.
3318
+ # LibraryService.UpdateBook metric_costs: library.googleapis.com/write_calls: 2 -
3319
+ # selector: google.example.library.v1.LibraryService.DeleteBook metric_costs:
3320
+ # library.googleapis.com/write_calls: 1 Corresponding Metric definition: metrics:
3321
+ # - name: library.googleapis.com/read_calls display_name: Read requests
3322
+ # metric_kind: DELTA value_type: INT64 - name: library.googleapis.com/
3323
+ # write_calls display_name: Write requests metric_kind: DELTA value_type: INT64
3918
3324
  # Corresponds to the JSON property `quota`
3919
3325
  # @return [Google::Apis::ServicenetworkingV1::Quota]
3920
3326
  attr_accessor :quota
@@ -3924,20 +3330,18 @@ module Google
3924
3330
  # @return [Google::Apis::ServicenetworkingV1::SourceInfo]
3925
3331
  attr_accessor :source_info
3926
3332
 
3927
- # ### System parameter configuration
3928
- # A system parameter is a special kind of parameter defined by the API
3929
- # system, not by an individual API. It is typically mapped to an HTTP header
3930
- # and/or a URL query parameter. This configuration specifies which methods
3931
- # change the names of the system parameters.
3333
+ # ### System parameter configuration A system parameter is a special kind of
3334
+ # parameter defined by the API system, not by an individual API. It is typically
3335
+ # mapped to an HTTP header and/or a URL query parameter. This configuration
3336
+ # specifies which methods change the names of the system parameters.
3932
3337
  # Corresponds to the JSON property `systemParameters`
3933
3338
  # @return [Google::Apis::ServicenetworkingV1::SystemParameters]
3934
3339
  attr_accessor :system_parameters
3935
3340
 
3936
- # A list of all proto message types included in this API service.
3937
- # It serves similar purpose as [google.api.Service.types], except that
3938
- # these types are not needed by user-defined APIs. Therefore, they will not
3939
- # show up in the generated discovery doc. This field should only be used
3940
- # to define system APIs in ESF.
3341
+ # A list of all proto message types included in this API service. It serves
3342
+ # similar purpose as [google.api.Service.types], except that these types are not
3343
+ # needed by user-defined APIs. Therefore, they will not show up in the generated
3344
+ # discovery doc. This field should only be used to define system APIs in ESF.
3941
3345
  # Corresponds to the JSON property `systemTypes`
3942
3346
  # @return [Array<Google::Apis::ServicenetworkingV1::Type>]
3943
3347
  attr_accessor :system_types
@@ -3947,12 +3351,10 @@ module Google
3947
3351
  # @return [String]
3948
3352
  attr_accessor :title
3949
3353
 
3950
- # A list of all proto message types included in this API service.
3951
- # Types referenced directly or indirectly by the `apis` are
3952
- # automatically included. Messages which are not referenced but
3953
- # shall be included, such as types used by the `google.protobuf.Any` type,
3954
- # should be listed here by name. Example:
3955
- # types:
3354
+ # A list of all proto message types included in this API service. Types
3355
+ # referenced directly or indirectly by the `apis` are automatically included.
3356
+ # Messages which are not referenced but shall be included, such as types used by
3357
+ # the `google.protobuf.Any` type, should be listed here by name. Example: types:
3956
3358
  # - name: google.protobuf.Int32
3957
3359
  # Corresponds to the JSON property `types`
3958
3360
  # @return [Array<Google::Apis::ServicenetworkingV1::Type>]
@@ -3999,32 +3401,28 @@ module Google
3999
3401
  end
4000
3402
  end
4001
3403
 
4002
- # The per-product per-project service identity for a service.
4003
- # Use this field to configure per-product per-project service identity.
4004
- # Example of a service identity configuration.
4005
- # usage:
4006
- # service_identity:
4007
- # - service_account_parent: "projects/123456789"
4008
- # display_name: "Cloud XXX Service Agent"
4009
- # description: "Used as the identity of Cloud XXX to access resources"
3404
+ # The per-product per-project service identity for a service. Use this field to
3405
+ # configure per-product per-project service identity. Example of a service
3406
+ # identity configuration. usage: service_identity: - service_account_parent: "
3407
+ # projects/123456789" display_name: "Cloud XXX Service Agent" description: "Used
3408
+ # as the identity of Cloud XXX to access resources"
4010
3409
  class ServiceIdentity
4011
3410
  include Google::Apis::Core::Hashable
4012
3411
 
4013
- # Optional. A user-specified opaque description of the service account.
4014
- # Must be less than or equal to 256 UTF-8 bytes.
3412
+ # Optional. A user-specified opaque description of the service account. Must be
3413
+ # less than or equal to 256 UTF-8 bytes.
4015
3414
  # Corresponds to the JSON property `description`
4016
3415
  # @return [String]
4017
3416
  attr_accessor :description
4018
3417
 
4019
- # Optional. A user-specified name for the service account.
4020
- # Must be less than or equal to 100 UTF-8 bytes.
3418
+ # Optional. A user-specified name for the service account. Must be less than or
3419
+ # equal to 100 UTF-8 bytes.
4021
3420
  # Corresponds to the JSON property `displayName`
4022
3421
  # @return [String]
4023
3422
  attr_accessor :display_name
4024
3423
 
4025
- # A service account project that hosts the service accounts.
4026
- # An example name would be:
4027
- # `projects/123456789`
3424
+ # A service account project that hosts the service accounts. An example name
3425
+ # would be: `projects/123456789`
4028
3426
  # Corresponds to the JSON property `serviceAccountParent`
4029
3427
  # @return [String]
4030
3428
  attr_accessor :service_account_parent
@@ -4041,13 +3439,13 @@ module Google
4041
3439
  end
4042
3440
  end
4043
3441
 
4044
- # `SourceContext` represents information about the source of a
4045
- # protobuf element, like the file in which it is defined.
3442
+ # `SourceContext` represents information about the source of a protobuf element,
3443
+ # like the file in which it is defined.
4046
3444
  class SourceContext
4047
3445
  include Google::Apis::Core::Hashable
4048
3446
 
4049
3447
  # The path-qualified name of the .proto file that contained the associated
4050
- # protobuf element. For example: `"google/protobuf/source_context.proto"`.
3448
+ # protobuf element. For example: `"google/protobuf/source_context.proto"`.
4051
3449
  # Corresponds to the JSON property `fileName`
4052
3450
  # @return [String]
4053
3451
  attr_accessor :file_name
@@ -4081,12 +3479,12 @@ module Google
4081
3479
  end
4082
3480
  end
4083
3481
 
4084
- # The `Status` type defines a logical error model that is suitable for
4085
- # different programming environments, including REST APIs and RPC APIs. It is
4086
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4087
- # three pieces of data: error code, error message, and error details.
4088
- # You can find out more about this error model and how to work with it in the
4089
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
3482
+ # The `Status` type defines a logical error model that is suitable for different
3483
+ # programming environments, including REST APIs and RPC APIs. It is used by [
3484
+ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
3485
+ # data: error code, error message, and error details. You can find out more
3486
+ # about this error model and how to work with it in the [API Design Guide](https:
3487
+ # //cloud.google.com/apis/design/errors).
4090
3488
  class Status
4091
3489
  include Google::Apis::Core::Hashable
4092
3490
 
@@ -4095,15 +3493,15 @@ module Google
4095
3493
  # @return [Fixnum]
4096
3494
  attr_accessor :code
4097
3495
 
4098
- # A list of messages that carry the error details. There is a common set of
3496
+ # A list of messages that carry the error details. There is a common set of
4099
3497
  # message types for APIs to use.
4100
3498
  # Corresponds to the JSON property `details`
4101
3499
  # @return [Array<Hash<String,Object>>]
4102
3500
  attr_accessor :details
4103
3501
 
4104
- # A developer-facing error message, which should be in English. Any
4105
- # user-facing error message should be localized and sent in the
4106
- # google.rpc.Status.details field, or localized by the client.
3502
+ # A developer-facing error message, which should be in English. Any user-facing
3503
+ # error message should be localized and sent in the google.rpc.Status.details
3504
+ # field, or localized by the client.
4107
3505
  # Corresponds to the JSON property `message`
4108
3506
  # @return [String]
4109
3507
  attr_accessor :message
@@ -4130,21 +3528,19 @@ module Google
4130
3528
  # @return [String]
4131
3529
  attr_accessor :ip_cidr_range
4132
3530
 
4133
- # Subnetwork name.
4134
- # See https://cloud.google.com/compute/docs/vpc/
3531
+ # Subnetwork name. See https://cloud.google.com/compute/docs/vpc/
4135
3532
  # Corresponds to the JSON property `name`
4136
3533
  # @return [String]
4137
3534
  attr_accessor :name
4138
3535
 
4139
3536
  # In the Shared VPC host project, the VPC network that's peered with the
4140
- # consumer network. For example:
4141
- # `projects/1234321/global/networks/host-network`
3537
+ # consumer network. For example: `projects/1234321/global/networks/host-network`
4142
3538
  # Corresponds to the JSON property `network`
4143
3539
  # @return [String]
4144
3540
  attr_accessor :network
4145
3541
 
4146
- # This is a discovered subnet that is not within the current consumer
4147
- # allocated ranges.
3542
+ # This is a discovered subnet that is not within the current consumer allocated
3543
+ # ranges.
4148
3544
  # Corresponds to the JSON property `outsideAllocation`
4149
3545
  # @return [Boolean]
4150
3546
  attr_accessor :outside_allocation
@@ -4169,8 +3565,7 @@ module Google
4169
3565
  class SystemParameter
4170
3566
  include Google::Apis::Core::Hashable
4171
3567
 
4172
- # Define the HTTP header name to use for the parameter. It is case
4173
- # insensitive.
3568
+ # Define the HTTP header name to use for the parameter. It is case insensitive.
4174
3569
  # Corresponds to the JSON property `httpHeader`
4175
3570
  # @return [String]
4176
3571
  attr_accessor :http_header
@@ -4198,23 +3593,20 @@ module Google
4198
3593
  end
4199
3594
  end
4200
3595
 
4201
- # Define a system parameter rule mapping system parameter definitions to
4202
- # methods.
3596
+ # Define a system parameter rule mapping system parameter definitions to methods.
4203
3597
  class SystemParameterRule
4204
3598
  include Google::Apis::Core::Hashable
4205
3599
 
4206
- # Define parameters. Multiple names may be defined for a parameter.
4207
- # For a given method call, only one of them should be used. If multiple
4208
- # names are used the behavior is implementation-dependent.
4209
- # If none of the specified names are present the behavior is
4210
- # parameter-dependent.
3600
+ # Define parameters. Multiple names may be defined for a parameter. For a given
3601
+ # method call, only one of them should be used. If multiple names are used the
3602
+ # behavior is implementation-dependent. If none of the specified names are
3603
+ # present the behavior is parameter-dependent.
4211
3604
  # Corresponds to the JSON property `parameters`
4212
3605
  # @return [Array<Google::Apis::ServicenetworkingV1::SystemParameter>]
4213
3606
  attr_accessor :parameters
4214
3607
 
4215
3608
  # Selects the methods to which this rule applies. Use '*' to indicate all
4216
- # methods in all APIs.
4217
- # Refer to selector for syntax details.
3609
+ # methods in all APIs. Refer to selector for syntax details.
4218
3610
  # Corresponds to the JSON property `selector`
4219
3611
  # @return [String]
4220
3612
  attr_accessor :selector
@@ -4230,36 +3622,23 @@ module Google
4230
3622
  end
4231
3623
  end
4232
3624
 
4233
- # ### System parameter configuration
4234
- # A system parameter is a special kind of parameter defined by the API
4235
- # system, not by an individual API. It is typically mapped to an HTTP header
4236
- # and/or a URL query parameter. This configuration specifies which methods
4237
- # change the names of the system parameters.
3625
+ # ### System parameter configuration A system parameter is a special kind of
3626
+ # parameter defined by the API system, not by an individual API. It is typically
3627
+ # mapped to an HTTP header and/or a URL query parameter. This configuration
3628
+ # specifies which methods change the names of the system parameters.
4238
3629
  class SystemParameters
4239
3630
  include Google::Apis::Core::Hashable
4240
3631
 
4241
- # Define system parameters.
4242
- # The parameters defined here will override the default parameters
4243
- # implemented by the system. If this field is missing from the service
4244
- # config, default system parameters will be used. Default system parameters
4245
- # and names is implementation-dependent.
4246
- # Example: define api key for all methods
4247
- # system_parameters
4248
- # rules:
4249
- # - selector: "*"
4250
- # parameters:
4251
- # - name: api_key
4252
- # url_query_parameter: api_key
4253
- # Example: define 2 api key names for a specific method.
4254
- # system_parameters
4255
- # rules:
4256
- # - selector: "/ListShelves"
4257
- # parameters:
4258
- # - name: api_key
4259
- # http_header: Api-Key1
4260
- # - name: api_key
4261
- # http_header: Api-Key2
4262
- # **NOTE:** All service configuration rules follow "last one wins" order.
3632
+ # Define system parameters. The parameters defined here will override the
3633
+ # default parameters implemented by the system. If this field is missing from
3634
+ # the service config, default system parameters will be used. Default system
3635
+ # parameters and names is implementation-dependent. Example: define api key for
3636
+ # all methods system_parameters rules: - selector: "*" parameters: - name:
3637
+ # api_key url_query_parameter: api_key Example: define 2 api key names for a
3638
+ # specific method. system_parameters rules: - selector: "/ListShelves"
3639
+ # parameters: - name: api_key http_header: Api-Key1 - name: api_key http_header:
3640
+ # Api-Key2 **NOTE:** All service configuration rules follow "last one wins"
3641
+ # order.
4263
3642
  # Corresponds to the JSON property `rules`
4264
3643
  # @return [Array<Google::Apis::ServicenetworkingV1::SystemParameterRule>]
4265
3644
  attr_accessor :rules
@@ -4298,8 +3677,8 @@ module Google
4298
3677
  # @return [Array<Google::Apis::ServicenetworkingV1::Option>]
4299
3678
  attr_accessor :options
4300
3679
 
4301
- # `SourceContext` represents information about the source of a
4302
- # protobuf element, like the file in which it is defined.
3680
+ # `SourceContext` represents information about the source of a protobuf element,
3681
+ # like the file in which it is defined.
4303
3682
  # Corresponds to the JSON property `sourceContext`
4304
3683
  # @return [Google::Apis::ServicenetworkingV1::SourceContext]
4305
3684
  attr_accessor :source_context
@@ -4340,15 +3719,13 @@ module Google
4340
3719
 
4341
3720
  # Request to update a record set from a private managed DNS zone in the shared
4342
3721
  # producer host project. The name, type, ttl, and data values of the existing
4343
- # record set must all exactly match an existing record set in the specified
4344
- # zone.
3722
+ # record set must all exactly match an existing record set in the specified zone.
4345
3723
  class UpdateDnsRecordSetRequest
4346
3724
  include Google::Apis::Core::Hashable
4347
3725
 
4348
3726
  # Required. The network that the consumer is using to connect with services.
4349
- # Must be in the form of projects/`project`/global/networks/`network`
4350
- # `project` is the project number, as in '12345'
4351
- # `network` is the network name.
3727
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
3728
+ # is the project number, as in '12345' `network` is the network name.
4352
3729
  # Corresponds to the JSON property `consumerNetwork`
4353
3730
  # @return [String]
4354
3731
  attr_accessor :consumer_network
@@ -4364,8 +3741,7 @@ module Google
4364
3741
  attr_accessor :new_dns_record_set
4365
3742
 
4366
3743
  # Required. The name of the private DNS zone in the shared producer host project
4367
- # from
4368
- # which the record set will be removed.
3744
+ # from which the record set will be removed.
4369
3745
  # Corresponds to the JSON property `zone`
4370
3746
  # @return [String]
4371
3747
  attr_accessor :zone
@@ -4388,37 +3764,33 @@ module Google
4388
3764
  include Google::Apis::Core::Hashable
4389
3765
 
4390
3766
  # The full resource name of a channel used for sending notifications to the
4391
- # service producer.
4392
- # Google Service Management currently only supports
4393
- # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
4394
- # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
4395
- # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
4396
- # documented in https://cloud.google.com/pubsub/docs/overview.
3767
+ # service producer. Google Service Management currently only supports [Google
3768
+ # Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. To
3769
+ # use Google Cloud Pub/Sub as the channel, this must be the name of a Cloud Pub/
3770
+ # Sub topic that uses the Cloud Pub/Sub topic name format documented in https://
3771
+ # cloud.google.com/pubsub/docs/overview.
4397
3772
  # Corresponds to the JSON property `producerNotificationChannel`
4398
3773
  # @return [String]
4399
3774
  attr_accessor :producer_notification_channel
4400
3775
 
4401
3776
  # Requirements that must be satisfied before a consumer project can use the
4402
- # service. Each requirement is of the form <service.name>/<requirement-id>;
4403
- # for example 'serviceusage.googleapis.com/billing-enabled'.
3777
+ # service. Each requirement is of the form /; for example 'serviceusage.
3778
+ # googleapis.com/billing-enabled'.
4404
3779
  # Corresponds to the JSON property `requirements`
4405
3780
  # @return [Array<String>]
4406
3781
  attr_accessor :requirements
4407
3782
 
4408
- # A list of usage rules that apply to individual API methods.
4409
- # **NOTE:** All service configuration rules follow "last one wins" order.
3783
+ # A list of usage rules that apply to individual API methods. **NOTE:** All
3784
+ # service configuration rules follow "last one wins" order.
4410
3785
  # Corresponds to the JSON property `rules`
4411
3786
  # @return [Array<Google::Apis::ServicenetworkingV1::UsageRule>]
4412
3787
  attr_accessor :rules
4413
3788
 
4414
- # The per-product per-project service identity for a service.
4415
- # Use this field to configure per-product per-project service identity.
4416
- # Example of a service identity configuration.
4417
- # usage:
4418
- # service_identity:
4419
- # - service_account_parent: "projects/123456789"
4420
- # display_name: "Cloud XXX Service Agent"
4421
- # description: "Used as the identity of Cloud XXX to access resources"
3789
+ # The per-product per-project service identity for a service. Use this field to
3790
+ # configure per-product per-project service identity. Example of a service
3791
+ # identity configuration. usage: service_identity: - service_account_parent: "
3792
+ # projects/123456789" display_name: "Cloud XXX Service Agent" description: "Used
3793
+ # as the identity of Cloud XXX to access resources"
4422
3794
  # Corresponds to the JSON property `serviceIdentity`
4423
3795
  # @return [Google::Apis::ServicenetworkingV1::ServiceIdentity]
4424
3796
  attr_accessor :service_identity
@@ -4436,45 +3808,36 @@ module Google
4436
3808
  end
4437
3809
  end
4438
3810
 
4439
- # Usage configuration rules for the service.
4440
- # NOTE: Under development.
4441
- # Use this rule to configure unregistered calls for the service. Unregistered
4442
- # calls are calls that do not contain consumer project identity.
4443
- # (Example: calls that do not contain an API key).
4444
- # By default, API methods do not allow unregistered calls, and each method call
4445
- # must be identified by a consumer project identity. Use this rule to
4446
- # allow/disallow unregistered calls.
4447
- # Example of an API that wants to allow unregistered calls for entire service.
4448
- # usage:
4449
- # rules:
4450
- # - selector: "*"
4451
- # allow_unregistered_calls: true
4452
- # Example of a method that wants to allow unregistered calls.
4453
- # usage:
4454
- # rules:
4455
- # - selector: "google.example.library.v1.LibraryService.CreateBook"
4456
- # allow_unregistered_calls: true
3811
+ # Usage configuration rules for the service. NOTE: Under development. Use this
3812
+ # rule to configure unregistered calls for the service. Unregistered calls are
3813
+ # calls that do not contain consumer project identity. (Example: calls that do
3814
+ # not contain an API key). By default, API methods do not allow unregistered
3815
+ # calls, and each method call must be identified by a consumer project identity.
3816
+ # Use this rule to allow/disallow unregistered calls. Example of an API that
3817
+ # wants to allow unregistered calls for entire service. usage: rules: - selector:
3818
+ # "*" allow_unregistered_calls: true Example of a method that wants to allow
3819
+ # unregistered calls. usage: rules: - selector: "google.example.library.v1.
3820
+ # LibraryService.CreateBook" allow_unregistered_calls: true
4457
3821
  class UsageRule
4458
3822
  include Google::Apis::Core::Hashable
4459
3823
 
4460
- # If true, the selected method allows unregistered calls, e.g. calls
4461
- # that don't identify any user or application.
3824
+ # If true, the selected method allows unregistered calls, e.g. calls that don't
3825
+ # identify any user or application.
4462
3826
  # Corresponds to the JSON property `allowUnregisteredCalls`
4463
3827
  # @return [Boolean]
4464
3828
  attr_accessor :allow_unregistered_calls
4465
3829
  alias_method :allow_unregistered_calls?, :allow_unregistered_calls
4466
3830
 
4467
3831
  # Selects the methods to which this rule applies. Use '*' to indicate all
4468
- # methods in all APIs.
4469
- # Refer to selector for syntax details.
3832
+ # methods in all APIs. Refer to selector for syntax details.
4470
3833
  # Corresponds to the JSON property `selector`
4471
3834
  # @return [String]
4472
3835
  attr_accessor :selector
4473
3836
 
4474
- # If true, the selected method should skip service control and the control
4475
- # plane features, such as quota and billing, will not be available.
4476
- # This flag is used by Google Cloud Endpoints to bypass checks for internal
4477
- # methods, such as service health check methods.
3837
+ # If true, the selected method should skip service control and the control plane
3838
+ # features, such as quota and billing, will not be available. This flag is used
3839
+ # by Google Cloud Endpoints to bypass checks for internal methods, such as
3840
+ # service health check methods.
4478
3841
  # Corresponds to the JSON property `skipServiceControl`
4479
3842
  # @return [Boolean]
4480
3843
  attr_accessor :skip_service_control
@@ -4497,9 +3860,8 @@ module Google
4497
3860
  include Google::Apis::Core::Hashable
4498
3861
 
4499
3862
  # Required. The network that the consumer is using to connect with services.
4500
- # Must be in
4501
- # the form of projects/`project`/global/networks/`network` `project` is a
4502
- # project number, as in '12345' `network` is network name.
3863
+ # Must be in the form of projects/`project`/global/networks/`network` `project`
3864
+ # is a project number, as in '12345' `network` is network name.
4503
3865
  # Corresponds to the JSON property `consumerNetwork`
4504
3866
  # @return [String]
4505
3867
  attr_accessor :consumer_network
@@ -4514,13 +3876,12 @@ module Google
4514
3876
  # @return [Google::Apis::ServicenetworkingV1::RangeReservation]
4515
3877
  attr_accessor :range_reservation
4516
3878
 
4517
- # The validations will be performed in the order listed in the
4518
- # ValidationError enum. The first failure will return. If a validation is not
4519
- # requested, then the next one will be performed.
4520
- # SERVICE_NETWORKING_NOT_ENABLED and NETWORK_NOT_PEERED checks are performed
4521
- # for all requests where validation is requested. NETWORK_NOT_FOUND and
4522
- # NETWORK_DISCONNECTED checks are done for requests that have
4523
- # validate_network set to true.
3879
+ # The validations will be performed in the order listed in the ValidationError
3880
+ # enum. The first failure will return. If a validation is not requested, then
3881
+ # the next one will be performed. SERVICE_NETWORKING_NOT_ENABLED and
3882
+ # NETWORK_NOT_PEERED checks are performed for all requests where validation is
3883
+ # requested. NETWORK_NOT_FOUND and NETWORK_DISCONNECTED checks are done for
3884
+ # requests that have validate_network set to true.
4524
3885
  # Corresponds to the JSON property `validateNetwork`
4525
3886
  # @return [Boolean]
4526
3887
  attr_accessor :validate_network