google-api-client 0.9.8 → 0.9.20

Sign up to get free protection for your applications and to get access to all the features.
Files changed (238) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +37 -0
  3. data/Gemfile +9 -1
  4. data/README.md +10 -2
  5. data/api_names.yaml +63 -110
  6. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +35 -0
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +298 -0
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +122 -0
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +458 -0
  10. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  11. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +260 -13
  12. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +81 -0
  13. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +60 -8
  14. data/generated/google/apis/adexchangeseller_v2_0.rb +2 -3
  15. data/generated/google/apis/adexchangeseller_v2_0/service.rb +1 -2
  16. data/generated/google/apis/admin_directory_v1.rb +1 -1
  17. data/generated/google/apis/admin_directory_v1/classes.rb +86 -0
  18. data/generated/google/apis/admin_directory_v1/representations.rb +24 -0
  19. data/generated/google/apis/admin_directory_v1/service.rb +41 -2
  20. data/generated/google/apis/admin_reports_v1.rb +3 -3
  21. data/generated/google/apis/admin_reports_v1/service.rb +2 -2
  22. data/generated/google/apis/adsense_v1_4.rb +1 -1
  23. data/generated/google/apis/adsense_v1_4/classes.rb +1 -1
  24. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  25. data/generated/google/apis/adsensehost_v4_1/classes.rb +1 -2
  26. data/generated/google/apis/analytics_v3.rb +1 -1
  27. data/generated/google/apis/analytics_v3/classes.rb +379 -3
  28. data/generated/google/apis/analytics_v3/representations.rb +136 -0
  29. data/generated/google/apis/analytics_v3/service.rb +217 -0
  30. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  31. data/generated/google/apis/analyticsreporting_v4/classes.rb +50 -22
  32. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  33. data/generated/google/apis/androidenterprise_v1/classes.rb +813 -49
  34. data/generated/google/apis/androidenterprise_v1/representations.rb +336 -0
  35. data/generated/google/apis/androidenterprise_v1/service.rb +1234 -145
  36. data/generated/google/apis/androidpublisher_v2.rb +1 -1
  37. data/generated/google/apis/androidpublisher_v2/classes.rb +47 -8
  38. data/generated/google/apis/androidpublisher_v2/representations.rb +27 -0
  39. data/generated/google/apis/androidpublisher_v2/service.rb +55 -0
  40. data/generated/google/apis/appengine_v1beta5.rb +7 -1
  41. data/generated/google/apis/appengine_v1beta5/classes.rb +516 -313
  42. data/generated/google/apis/appengine_v1beta5/representations.rb +115 -22
  43. data/generated/google/apis/appengine_v1beta5/service.rb +329 -33
  44. data/generated/google/apis/appsactivity_v1.rb +1 -1
  45. data/generated/google/apis/appsactivity_v1/classes.rb +7 -0
  46. data/generated/google/apis/appsactivity_v1/representations.rb +1 -0
  47. data/generated/google/apis/appstate_v1.rb +1 -1
  48. data/generated/google/apis/bigquery_v2.rb +1 -1
  49. data/generated/google/apis/bigquery_v2/classes.rb +277 -20
  50. data/generated/google/apis/bigquery_v2/representations.rb +86 -0
  51. data/generated/google/apis/bigquery_v2/service.rb +8 -2
  52. data/generated/google/apis/books_v1.rb +2 -2
  53. data/generated/google/apis/books_v1/classes.rb +79 -1
  54. data/generated/google/apis/books_v1/representations.rb +34 -0
  55. data/generated/google/apis/books_v1/service.rb +7 -3
  56. data/generated/google/apis/calendar_v3.rb +1 -1
  57. data/generated/google/apis/civicinfo_v2.rb +3 -2
  58. data/generated/google/apis/civicinfo_v2/classes.rb +377 -5
  59. data/generated/google/apis/civicinfo_v2/representations.rb +149 -0
  60. data/generated/google/apis/civicinfo_v2/service.rb +27 -6
  61. data/generated/google/apis/classroom_v1.rb +1 -1
  62. data/generated/google/apis/classroom_v1/classes.rb +183 -37
  63. data/generated/google/apis/classroom_v1/representations.rb +74 -9
  64. data/generated/google/apis/classroom_v1/service.rb +403 -38
  65. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  66. data/generated/google/apis/cloudbuild_v1/classes.rb +381 -17
  67. data/generated/google/apis/cloudbuild_v1/representations.rb +137 -2
  68. data/generated/google/apis/cloudbuild_v1/service.rb +174 -1
  69. data/generated/google/apis/clouddebugger_v2.rb +3 -6
  70. data/generated/google/apis/clouddebugger_v2/service.rb +4 -4
  71. data/generated/google/apis/cloudmonitoring_v2beta2.rb +1 -1
  72. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  73. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +502 -111
  74. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +162 -24
  75. data/generated/google/apis/cloudresourcemanager_v1/service.rb +274 -30
  76. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  77. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +121 -9
  78. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +46 -0
  79. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +71 -58
  80. data/generated/google/apis/compute_beta.rb +1 -1
  81. data/generated/google/apis/compute_beta/classes.rb +2299 -434
  82. data/generated/google/apis/compute_beta/representations.rb +752 -33
  83. data/generated/google/apis/compute_beta/service.rb +6067 -3153
  84. data/generated/google/apis/compute_v1.rb +1 -1
  85. data/generated/google/apis/compute_v1/classes.rb +1681 -207
  86. data/generated/google/apis/compute_v1/representations.rb +552 -0
  87. data/generated/google/apis/compute_v1/service.rb +2797 -1171
  88. data/generated/google/apis/content_v2.rb +1 -1
  89. data/generated/google/apis/content_v2/classes.rb +757 -1
  90. data/generated/google/apis/content_v2/representations.rb +337 -0
  91. data/generated/google/apis/content_v2/service.rb +244 -0
  92. data/generated/google/apis/dataflow_v1b3.rb +38 -0
  93. data/generated/google/apis/dataflow_v1b3/classes.rb +4053 -0
  94. data/generated/google/apis/dataflow_v1b3/representations.rb +1736 -0
  95. data/generated/google/apis/dataflow_v1b3/service.rb +875 -0
  96. data/generated/google/apis/dataproc_v1.rb +2 -2
  97. data/generated/google/apis/dataproc_v1/classes.rb +213 -68
  98. data/generated/google/apis/dataproc_v1/representations.rb +38 -0
  99. data/generated/google/apis/dataproc_v1/service.rb +78 -48
  100. data/generated/google/apis/datastore_v1.rb +38 -0
  101. data/generated/google/apis/datastore_v1/classes.rb +1284 -0
  102. data/generated/google/apis/datastore_v1/representations.rb +572 -0
  103. data/generated/google/apis/datastore_v1/service.rb +259 -0
  104. data/generated/google/apis/datastore_v1beta3.rb +38 -0
  105. data/generated/google/apis/datastore_v1beta3/classes.rb +1284 -0
  106. data/generated/google/apis/datastore_v1beta3/representations.rb +572 -0
  107. data/generated/google/apis/datastore_v1beta3/service.rb +259 -0
  108. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  109. data/generated/google/apis/deploymentmanager_v2/classes.rb +384 -2
  110. data/generated/google/apis/deploymentmanager_v2/representations.rb +161 -0
  111. data/generated/google/apis/deploymentmanager_v2/service.rb +217 -55
  112. data/generated/google/apis/dfareporting_v2_5.rb +40 -0
  113. data/generated/google/apis/dfareporting_v2_5/classes.rb +11225 -0
  114. data/generated/google/apis/dfareporting_v2_5/representations.rb +3982 -0
  115. data/generated/google/apis/dfareporting_v2_5/service.rb +8755 -0
  116. data/generated/google/apis/dfareporting_v2_6.rb +40 -0
  117. data/generated/google/apis/dfareporting_v2_6/classes.rb +11586 -0
  118. data/generated/google/apis/dfareporting_v2_6/representations.rb +4119 -0
  119. data/generated/google/apis/dfareporting_v2_6/service.rb +9025 -0
  120. data/generated/google/apis/dns_v1.rb +1 -1
  121. data/generated/google/apis/dns_v1/classes.rb +1 -1
  122. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  123. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +79 -86
  124. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +25 -28
  125. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +10 -8
  126. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  127. data/generated/google/apis/drive_v2.rb +1 -1
  128. data/generated/google/apis/drive_v2/classes.rb +27 -3
  129. data/generated/google/apis/drive_v2/representations.rb +4 -0
  130. data/generated/google/apis/drive_v2/service.rb +16 -3
  131. data/generated/google/apis/drive_v3.rb +1 -1
  132. data/generated/google/apis/drive_v3/classes.rb +50 -16
  133. data/generated/google/apis/drive_v3/representations.rb +4 -0
  134. data/generated/google/apis/drive_v3/service.rb +12 -2
  135. data/generated/google/apis/fitness_v1.rb +8 -2
  136. data/generated/google/apis/fitness_v1/classes.rb +64 -6
  137. data/generated/google/apis/fitness_v1/representations.rb +20 -0
  138. data/generated/google/apis/fitness_v1/service.rb +17 -18
  139. data/generated/google/apis/fusiontables_v2.rb +1 -1
  140. data/generated/google/apis/fusiontables_v2/classes.rb +4 -3
  141. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  142. data/generated/google/apis/games_management_v1management.rb +1 -1
  143. data/generated/google/apis/games_v1.rb +1 -1
  144. data/generated/google/apis/genomics_v1.rb +2 -4
  145. data/generated/google/apis/genomics_v1/classes.rb +143 -34
  146. data/generated/google/apis/genomics_v1/representations.rb +48 -11
  147. data/generated/google/apis/genomics_v1/service.rb +35 -37
  148. data/generated/google/apis/gmail_v1.rb +10 -1
  149. data/generated/google/apis/gmail_v1/classes.rb +542 -4
  150. data/generated/google/apis/gmail_v1/representations.rb +213 -0
  151. data/generated/google/apis/gmail_v1/service.rb +898 -1
  152. data/generated/google/apis/groupssettings_v1.rb +1 -1
  153. data/generated/google/apis/groupssettings_v1/classes.rb +12 -0
  154. data/generated/google/apis/groupssettings_v1/representations.rb +2 -0
  155. data/generated/google/apis/iam_v1.rb +2 -2
  156. data/generated/google/apis/iam_v1/classes.rb +181 -206
  157. data/generated/google/apis/iam_v1/representations.rb +36 -45
  158. data/generated/google/apis/iam_v1/service.rb +101 -67
  159. data/generated/google/apis/identitytoolkit_v3.rb +4 -1
  160. data/generated/google/apis/identitytoolkit_v3/classes.rb +171 -1
  161. data/generated/google/apis/identitytoolkit_v3/representations.rb +26 -0
  162. data/generated/google/apis/language_v1beta1.rb +36 -0
  163. data/generated/google/apis/language_v1beta1/classes.rb +599 -0
  164. data/generated/google/apis/language_v1beta1/representations.rb +289 -0
  165. data/generated/google/apis/language_v1beta1/service.rb +152 -0
  166. data/generated/google/apis/logging_v2beta1.rb +6 -6
  167. data/generated/google/apis/logging_v2beta1/classes.rb +760 -731
  168. data/generated/google/apis/logging_v2beta1/representations.rb +136 -147
  169. data/generated/google/apis/logging_v2beta1/service.rb +290 -209
  170. data/generated/google/apis/mirror_v1.rb +2 -2
  171. data/generated/google/apis/mirror_v1/service.rb +1 -1
  172. data/generated/google/apis/monitoring_v3.rb +45 -0
  173. data/generated/google/apis/monitoring_v3/classes.rb +1337 -0
  174. data/generated/google/apis/monitoring_v3/representations.rb +516 -0
  175. data/generated/google/apis/monitoring_v3/service.rb +711 -0
  176. data/generated/google/apis/oauth2_v2.rb +1 -1
  177. data/generated/google/apis/pagespeedonline_v2.rb +1 -1
  178. data/generated/google/apis/plus_domains_v1.rb +1 -1
  179. data/generated/google/apis/plus_v1.rb +1 -1
  180. data/generated/google/apis/pubsub_v1.rb +1 -1
  181. data/generated/google/apis/pubsub_v1/classes.rb +10 -9
  182. data/generated/google/apis/pubsub_v1/service.rb +128 -27
  183. data/generated/google/apis/qpx_express_v1.rb +1 -1
  184. data/generated/google/apis/qpx_express_v1/classes.rb +6 -0
  185. data/generated/google/apis/qpx_express_v1/representations.rb +1 -0
  186. data/generated/google/apis/replicapool_v1beta2.rb +1 -1
  187. data/generated/google/apis/replicapoolupdater_v1beta1.rb +4 -2
  188. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +3 -1
  189. data/generated/google/apis/script_v1.rb +1 -1
  190. data/generated/google/apis/script_v1/classes.rb +6 -0
  191. data/generated/google/apis/script_v1/representations.rb +1 -0
  192. data/generated/google/apis/sheets_v4.rb +1 -1
  193. data/generated/google/apis/sheets_v4/classes.rb +910 -89
  194. data/generated/google/apis/sheets_v4/representations.rb +194 -10
  195. data/generated/google/apis/sheets_v4/service.rb +216 -49
  196. data/generated/google/apis/slides_v1.rb +49 -0
  197. data/generated/google/apis/slides_v1/classes.rb +3926 -0
  198. data/generated/google/apis/slides_v1/representations.rb +1722 -0
  199. data/generated/google/apis/slides_v1/service.rb +202 -0
  200. data/generated/google/apis/speech_v1beta1.rb +34 -0
  201. data/generated/google/apis/speech_v1beta1/classes.rb +511 -0
  202. data/generated/google/apis/speech_v1beta1/representations.rb +218 -0
  203. data/generated/google/apis/speech_v1beta1/service.rb +271 -0
  204. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  205. data/generated/google/apis/sqladmin_v1beta4/classes.rb +32 -8
  206. data/generated/google/apis/sqladmin_v1beta4/representations.rb +3 -0
  207. data/generated/google/apis/sqladmin_v1beta4/service.rb +42 -0
  208. data/generated/google/apis/storage_v1.rb +1 -1
  209. data/generated/google/apis/storage_v1/classes.rb +43 -18
  210. data/generated/google/apis/storage_v1/representations.rb +4 -1
  211. data/generated/google/apis/storage_v1/service.rb +5 -2
  212. data/generated/google/apis/translate_v2.rb +2 -2
  213. data/generated/google/apis/translate_v2/service.rb +1 -1
  214. data/generated/google/apis/vision_v1.rb +1 -1
  215. data/generated/google/apis/vision_v1/classes.rb +12 -11
  216. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  217. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  218. data/generated/google/apis/youtube_partner_v1/classes.rb +6 -0
  219. data/generated/google/apis/youtube_partner_v1/representations.rb +2 -0
  220. data/generated/google/apis/youtube_partner_v1/service.rb +15 -3
  221. data/generated/google/apis/youtube_v3.rb +1 -1
  222. data/generated/google/apis/youtube_v3/classes.rb +183 -21
  223. data/generated/google/apis/youtube_v3/representations.rb +85 -4
  224. data/generated/google/apis/youtube_v3/service.rb +41 -5
  225. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  226. data/google-api-client.gemspec +2 -1
  227. data/lib/google/apis/core/api_command.rb +4 -0
  228. data/lib/google/apis/core/base_service.rb +10 -4
  229. data/lib/google/apis/core/download.rb +7 -2
  230. data/lib/google/apis/core/http_command.rb +5 -1
  231. data/lib/google/apis/core/upload.rb +7 -1
  232. data/lib/google/apis/errors.rb +2 -2
  233. data/lib/google/apis/generator/annotator.rb +6 -0
  234. data/lib/google/apis/version.rb +1 -1
  235. data/samples/cli/lib/samples/bigquery.rb +101 -0
  236. data/samples/cli/lib/samples/sheets.rb +61 -0
  237. data/sync.rb +71 -0
  238. metadata +55 -13
@@ -0,0 +1,711 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module MonitoringV3
23
+ # Stackdriver Monitoring API
24
+ #
25
+ # Manages your Stackdriver Monitoring data and configurations. Most projects
26
+ # must be associated with a Stackdriver account, with a few exceptions as noted
27
+ # on the individual method pages.
28
+ #
29
+ # @example
30
+ # require 'google/apis/monitoring_v3'
31
+ #
32
+ # Monitoring = Google::Apis::MonitoringV3 # Alias the module
33
+ # service = Monitoring::MonitoringService.new
34
+ #
35
+ # @see https://cloud.google.com/monitoring/api/
36
+ class MonitoringService < Google::Apis::Core::BaseService
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super('https://monitoring.googleapis.com/', '')
49
+ end
50
+
51
+ # Stackdriver Monitoring Agent only: Creates a new time series.<aside class="
52
+ # caution">This method is only for use by the Stackdriver Monitoring Agent. Use
53
+ # projects.timeSeries.create instead.</aside>
54
+ # @param [String] name
55
+ # The project in which to create the time series. The format is &quot;projects/
56
+ # PROJECT_ID_OR_NUMBER&quot;.
57
+ # @param [Google::Apis::MonitoringV3::CreateCollectdTimeSeriesRequest] create_collectd_time_series_request_object
58
+ # @param [String] quota_user
59
+ # Available to use for quota purposes for server-side applications. Can be any
60
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::MonitoringV3::Empty]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def create_collectd_time_series(name, create_collectd_time_series_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
76
+ command = make_simple_command(:post, 'v3/{+name}/collectdTimeSeries', options)
77
+ command.request_representation = Google::Apis::MonitoringV3::CreateCollectdTimeSeriesRequest::Representation
78
+ command.request_object = create_collectd_time_series_request_object
79
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
80
+ command.response_class = Google::Apis::MonitoringV3::Empty
81
+ command.params['name'] = name unless name.nil?
82
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
83
+ command.query['fields'] = fields unless fields.nil?
84
+ execute_or_queue_command(command, &block)
85
+ end
86
+
87
+ # Updates an existing group. You can change any group attributes except name.
88
+ # @param [String] name
89
+ # Output only. The name of this group. The format is &quot;projects/`
90
+ # project_id_or_number`/groups/`group_id`&quot;. When creating a group, this
91
+ # field is ignored and a new name is created consisting of the project specified
92
+ # in the call to CreateGroup and a unique `group_id` that is generated
93
+ # automatically.
94
+ # @param [Google::Apis::MonitoringV3::Group] group_object
95
+ # @param [Boolean] validate_only
96
+ # If true, validate this request but do not update the existing group.
97
+ # @param [String] quota_user
98
+ # Available to use for quota purposes for server-side applications. Can be any
99
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [String] fields
101
+ # Selector specifying which fields to include in a partial response.
102
+ # @param [Google::Apis::RequestOptions] options
103
+ # Request-specific options
104
+ #
105
+ # @yield [result, err] Result & error if block supplied
106
+ # @yieldparam result [Google::Apis::MonitoringV3::Group] parsed result object
107
+ # @yieldparam err [StandardError] error object if request failed
108
+ #
109
+ # @return [Google::Apis::MonitoringV3::Group]
110
+ #
111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
114
+ def update_project_group(name, group_object = nil, validate_only: nil, quota_user: nil, fields: nil, options: nil, &block)
115
+ command = make_simple_command(:put, 'v3/{+name}', options)
116
+ command.request_representation = Google::Apis::MonitoringV3::Group::Representation
117
+ command.request_object = group_object
118
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
119
+ command.response_class = Google::Apis::MonitoringV3::Group
120
+ command.params['name'] = name unless name.nil?
121
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
122
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
123
+ command.query['fields'] = fields unless fields.nil?
124
+ execute_or_queue_command(command, &block)
125
+ end
126
+
127
+ # Gets a single group.
128
+ # @param [String] name
129
+ # The group to retrieve. The format is &quot;projects/`project_id_or_number`/
130
+ # groups/`group_id`&quot;.
131
+ # @param [String] quota_user
132
+ # Available to use for quota purposes for server-side applications. Can be any
133
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
134
+ # @param [String] fields
135
+ # Selector specifying which fields to include in a partial response.
136
+ # @param [Google::Apis::RequestOptions] options
137
+ # Request-specific options
138
+ #
139
+ # @yield [result, err] Result & error if block supplied
140
+ # @yieldparam result [Google::Apis::MonitoringV3::Group] parsed result object
141
+ # @yieldparam err [StandardError] error object if request failed
142
+ #
143
+ # @return [Google::Apis::MonitoringV3::Group]
144
+ #
145
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
146
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
147
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
148
+ def get_project_group(name, quota_user: nil, fields: nil, options: nil, &block)
149
+ command = make_simple_command(:get, 'v3/{+name}', options)
150
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
151
+ command.response_class = Google::Apis::MonitoringV3::Group
152
+ command.params['name'] = name unless name.nil?
153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
154
+ command.query['fields'] = fields unless fields.nil?
155
+ execute_or_queue_command(command, &block)
156
+ end
157
+
158
+ # Creates a new group.
159
+ # @param [String] name
160
+ # The project in which to create the group. The format is &quot;projects/`
161
+ # project_id_or_number`&quot;.
162
+ # @param [Google::Apis::MonitoringV3::Group] group_object
163
+ # @param [Boolean] validate_only
164
+ # If true, validate this request but do not create the group.
165
+ # @param [String] quota_user
166
+ # Available to use for quota purposes for server-side applications. Can be any
167
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
168
+ # @param [String] fields
169
+ # Selector specifying which fields to include in a partial response.
170
+ # @param [Google::Apis::RequestOptions] options
171
+ # Request-specific options
172
+ #
173
+ # @yield [result, err] Result & error if block supplied
174
+ # @yieldparam result [Google::Apis::MonitoringV3::Group] parsed result object
175
+ # @yieldparam err [StandardError] error object if request failed
176
+ #
177
+ # @return [Google::Apis::MonitoringV3::Group]
178
+ #
179
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
180
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
181
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
182
+ def create_project_group(name, group_object = nil, validate_only: nil, quota_user: nil, fields: nil, options: nil, &block)
183
+ command = make_simple_command(:post, 'v3/{+name}/groups', options)
184
+ command.request_representation = Google::Apis::MonitoringV3::Group::Representation
185
+ command.request_object = group_object
186
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
187
+ command.response_class = Google::Apis::MonitoringV3::Group
188
+ command.params['name'] = name unless name.nil?
189
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ command.query['fields'] = fields unless fields.nil?
192
+ execute_or_queue_command(command, &block)
193
+ end
194
+
195
+ # Lists the existing groups.
196
+ # @param [String] name
197
+ # The project whose groups are to be listed. The format is &quot;projects/`
198
+ # project_id_or_number`&quot;.
199
+ # @param [String] descendants_of_group
200
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
201
+ # Returns the descendants of the specified group. This is a superset of the
202
+ # results returned by the childrenOfGroup filter, and includes children-of-
203
+ # children, and so forth.
204
+ # @param [Fixnum] page_size
205
+ # A positive number that is the maximum number of results to return.
206
+ # @param [String] children_of_group
207
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
208
+ # Returns groups whose parentName field contains the group name. If no groups
209
+ # have this parent, the results are empty.
210
+ # @param [String] ancestors_of_group
211
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
212
+ # Returns groups that are ancestors of the specified group. The groups are
213
+ # returned in order, starting with the immediate parent and ending with the most
214
+ # distant ancestor. If the specified group has no immediate parent, the results
215
+ # are empty.
216
+ # @param [String] page_token
217
+ # If this field is not empty then it must contain the nextPageToken value
218
+ # returned by a previous call to this method. Using this field causes the method
219
+ # to return additional results from the previous method call.
220
+ # @param [String] quota_user
221
+ # Available to use for quota purposes for server-side applications. Can be any
222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
223
+ # @param [String] fields
224
+ # Selector specifying which fields to include in a partial response.
225
+ # @param [Google::Apis::RequestOptions] options
226
+ # Request-specific options
227
+ #
228
+ # @yield [result, err] Result & error if block supplied
229
+ # @yieldparam result [Google::Apis::MonitoringV3::ListGroupsResponse] parsed result object
230
+ # @yieldparam err [StandardError] error object if request failed
231
+ #
232
+ # @return [Google::Apis::MonitoringV3::ListGroupsResponse]
233
+ #
234
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
235
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
236
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
237
+ def list_project_groups(name, descendants_of_group: nil, page_size: nil, children_of_group: nil, ancestors_of_group: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
238
+ command = make_simple_command(:get, 'v3/{+name}/groups', options)
239
+ command.response_representation = Google::Apis::MonitoringV3::ListGroupsResponse::Representation
240
+ command.response_class = Google::Apis::MonitoringV3::ListGroupsResponse
241
+ command.params['name'] = name unless name.nil?
242
+ command.query['descendantsOfGroup'] = descendants_of_group unless descendants_of_group.nil?
243
+ command.query['pageSize'] = page_size unless page_size.nil?
244
+ command.query['childrenOfGroup'] = children_of_group unless children_of_group.nil?
245
+ command.query['ancestorsOfGroup'] = ancestors_of_group unless ancestors_of_group.nil?
246
+ command.query['pageToken'] = page_token unless page_token.nil?
247
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
248
+ command.query['fields'] = fields unless fields.nil?
249
+ execute_or_queue_command(command, &block)
250
+ end
251
+
252
+ # Deletes an existing group.
253
+ # @param [String] name
254
+ # The group to delete. The format is &quot;projects/`project_id_or_number`/
255
+ # groups/`group_id`&quot;.
256
+ # @param [String] quota_user
257
+ # Available to use for quota purposes for server-side applications. Can be any
258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [String] fields
260
+ # Selector specifying which fields to include in a partial response.
261
+ # @param [Google::Apis::RequestOptions] options
262
+ # Request-specific options
263
+ #
264
+ # @yield [result, err] Result & error if block supplied
265
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
266
+ # @yieldparam err [StandardError] error object if request failed
267
+ #
268
+ # @return [Google::Apis::MonitoringV3::Empty]
269
+ #
270
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
271
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
272
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
273
+ def delete_project_group(name, quota_user: nil, fields: nil, options: nil, &block)
274
+ command = make_simple_command(:delete, 'v3/{+name}', options)
275
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
276
+ command.response_class = Google::Apis::MonitoringV3::Empty
277
+ command.params['name'] = name unless name.nil?
278
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
279
+ command.query['fields'] = fields unless fields.nil?
280
+ execute_or_queue_command(command, &block)
281
+ end
282
+
283
+ # Lists the monitored resources that are members of a group.
284
+ # @param [String] name
285
+ # The group whose members are listed. The format is &quot;projects/`
286
+ # project_id_or_number`/groups/`group_id`&quot;.
287
+ # @param [String] filter
288
+ # An optional list filter (/monitoring/api/learn_more#filtering) describing the
289
+ # members to be returned. The filter may reference the type, labels, and
290
+ # metadata of monitored resources that comprise the group. For example, to
291
+ # return only resources representing Compute Engine VM instances, use this
292
+ # filter:
293
+ # resource.type = &quot;gce_instance&quot;
294
+ # @param [String] interval_end_time
295
+ # Required. The end of the time interval.
296
+ # @param [String] interval_start_time
297
+ # Optional. The beginning of the time interval. The default value for the start
298
+ # time is the end time. The start time must not be later than the end time.
299
+ # @param [Fixnum] page_size
300
+ # A positive number that is the maximum number of results to return.
301
+ # @param [String] page_token
302
+ # If this field is not empty then it must contain the nextPageToken value
303
+ # returned by a previous call to this method. Using this field causes the method
304
+ # to return additional results from the previous method call.
305
+ # @param [String] quota_user
306
+ # Available to use for quota purposes for server-side applications. Can be any
307
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
308
+ # @param [String] fields
309
+ # Selector specifying which fields to include in a partial response.
310
+ # @param [Google::Apis::RequestOptions] options
311
+ # Request-specific options
312
+ #
313
+ # @yield [result, err] Result & error if block supplied
314
+ # @yieldparam result [Google::Apis::MonitoringV3::ListGroupMembersResponse] parsed result object
315
+ # @yieldparam err [StandardError] error object if request failed
316
+ #
317
+ # @return [Google::Apis::MonitoringV3::ListGroupMembersResponse]
318
+ #
319
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
320
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
321
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
322
+ def list_project_group_members(name, filter: nil, interval_end_time: nil, interval_start_time: nil, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
323
+ command = make_simple_command(:get, 'v3/{+name}/members', options)
324
+ command.response_representation = Google::Apis::MonitoringV3::ListGroupMembersResponse::Representation
325
+ command.response_class = Google::Apis::MonitoringV3::ListGroupMembersResponse
326
+ command.params['name'] = name unless name.nil?
327
+ command.query['filter'] = filter unless filter.nil?
328
+ command.query['interval.endTime'] = interval_end_time unless interval_end_time.nil?
329
+ command.query['interval.startTime'] = interval_start_time unless interval_start_time.nil?
330
+ command.query['pageSize'] = page_size unless page_size.nil?
331
+ command.query['pageToken'] = page_token unless page_token.nil?
332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
333
+ command.query['fields'] = fields unless fields.nil?
334
+ execute_or_queue_command(command, &block)
335
+ end
336
+
337
+ # Gets a single metric descriptor. This method does not require a Stackdriver
338
+ # account.
339
+ # @param [String] name
340
+ # The metric descriptor on which to execute the request. The format is &quot;
341
+ # projects/`project_id_or_number`/metricDescriptors/`metric_id`&quot;. An
342
+ # example value of `metric_id` is &quot;compute.googleapis.com/instance/disk/
343
+ # read_bytes_count&quot;.
344
+ # @param [String] quota_user
345
+ # Available to use for quota purposes for server-side applications. Can be any
346
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
347
+ # @param [String] fields
348
+ # Selector specifying which fields to include in a partial response.
349
+ # @param [Google::Apis::RequestOptions] options
350
+ # Request-specific options
351
+ #
352
+ # @yield [result, err] Result & error if block supplied
353
+ # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
354
+ # @yieldparam err [StandardError] error object if request failed
355
+ #
356
+ # @return [Google::Apis::MonitoringV3::MetricDescriptor]
357
+ #
358
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
359
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
360
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
361
+ def get_project_metric_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
362
+ command = make_simple_command(:get, 'v3/{+name}', options)
363
+ command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
364
+ command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
365
+ command.params['name'] = name unless name.nil?
366
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
367
+ command.query['fields'] = fields unless fields.nil?
368
+ execute_or_queue_command(command, &block)
369
+ end
370
+
371
+ # Creates a new metric descriptor. User-created metric descriptors define custom
372
+ # metrics (/monitoring/custom-metrics).
373
+ # @param [String] name
374
+ # The project on which to execute the request. The format is &quot;projects/`
375
+ # project_id_or_number`&quot;.
376
+ # @param [Google::Apis::MonitoringV3::MetricDescriptor] metric_descriptor_object
377
+ # @param [String] quota_user
378
+ # Available to use for quota purposes for server-side applications. Can be any
379
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
380
+ # @param [String] fields
381
+ # Selector specifying which fields to include in a partial response.
382
+ # @param [Google::Apis::RequestOptions] options
383
+ # Request-specific options
384
+ #
385
+ # @yield [result, err] Result & error if block supplied
386
+ # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
387
+ # @yieldparam err [StandardError] error object if request failed
388
+ #
389
+ # @return [Google::Apis::MonitoringV3::MetricDescriptor]
390
+ #
391
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
392
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
393
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
394
+ def create_project_metric_descriptor(name, metric_descriptor_object = nil, quota_user: nil, fields: nil, options: nil, &block)
395
+ command = make_simple_command(:post, 'v3/{+name}/metricDescriptors', options)
396
+ command.request_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
397
+ command.request_object = metric_descriptor_object
398
+ command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
399
+ command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
400
+ command.params['name'] = name unless name.nil?
401
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
402
+ command.query['fields'] = fields unless fields.nil?
403
+ execute_or_queue_command(command, &block)
404
+ end
405
+
406
+ # Lists metric descriptors that match a filter. This method does not require a
407
+ # Stackdriver account.
408
+ # @param [String] name
409
+ # The project on which to execute the request. The format is &quot;projects/`
410
+ # project_id_or_number`&quot;.
411
+ # @param [Fixnum] page_size
412
+ # A positive number that is the maximum number of results to return.
413
+ # @param [String] filter
414
+ # If this field is empty, all custom and system-defined metric descriptors are
415
+ # returned. Otherwise, the filter (/monitoring/api/v3/filters) specifies which
416
+ # metric descriptors are to be returned. For example, the following filter
417
+ # matches all custom metrics (/monitoring/custom-metrics):
418
+ # metric.type = starts_with(&quot;custom.googleapis.com/&quot;)
419
+ # @param [String] page_token
420
+ # If this field is not empty then it must contain the nextPageToken value
421
+ # returned by a previous call to this method. Using this field causes the method
422
+ # to return additional results from the previous method call.
423
+ # @param [String] quota_user
424
+ # Available to use for quota purposes for server-side applications. Can be any
425
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
426
+ # @param [String] fields
427
+ # Selector specifying which fields to include in a partial response.
428
+ # @param [Google::Apis::RequestOptions] options
429
+ # Request-specific options
430
+ #
431
+ # @yield [result, err] Result & error if block supplied
432
+ # @yieldparam result [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse] parsed result object
433
+ # @yieldparam err [StandardError] error object if request failed
434
+ #
435
+ # @return [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse]
436
+ #
437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
440
+ def list_project_metric_descriptors(name, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
441
+ command = make_simple_command(:get, 'v3/{+name}/metricDescriptors', options)
442
+ command.response_representation = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse::Representation
443
+ command.response_class = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse
444
+ command.params['name'] = name unless name.nil?
445
+ command.query['pageSize'] = page_size unless page_size.nil?
446
+ command.query['filter'] = filter unless filter.nil?
447
+ command.query['pageToken'] = page_token unless page_token.nil?
448
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
449
+ command.query['fields'] = fields unless fields.nil?
450
+ execute_or_queue_command(command, &block)
451
+ end
452
+
453
+ # Deletes a metric descriptor. Only user-created custom metrics (/monitoring/
454
+ # custom-metrics) can be deleted.
455
+ # @param [String] name
456
+ # The metric descriptor on which to execute the request. The format is &quot;
457
+ # projects/`project_id_or_number`/metricDescriptors/`metric_id`&quot;. An
458
+ # example of `metric_id` is: &quot;custom.googleapis.com/my_test_metric&quot;.
459
+ # @param [String] quota_user
460
+ # Available to use for quota purposes for server-side applications. Can be any
461
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
462
+ # @param [String] fields
463
+ # Selector specifying which fields to include in a partial response.
464
+ # @param [Google::Apis::RequestOptions] options
465
+ # Request-specific options
466
+ #
467
+ # @yield [result, err] Result & error if block supplied
468
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
469
+ # @yieldparam err [StandardError] error object if request failed
470
+ #
471
+ # @return [Google::Apis::MonitoringV3::Empty]
472
+ #
473
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
474
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
475
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
476
+ def delete_project_metric_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
477
+ command = make_simple_command(:delete, 'v3/{+name}', options)
478
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
479
+ command.response_class = Google::Apis::MonitoringV3::Empty
480
+ command.params['name'] = name unless name.nil?
481
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
482
+ command.query['fields'] = fields unless fields.nil?
483
+ execute_or_queue_command(command, &block)
484
+ end
485
+
486
+ # Creates or adds data to one or more time series. The response is empty if all
487
+ # time series in the request were written. If any time series could not be
488
+ # written, a corresponding failure message is included in the error response.
489
+ # @param [String] name
490
+ # The project on which to execute the request. The format is &quot;projects/`
491
+ # project_id_or_number`&quot;.
492
+ # @param [Google::Apis::MonitoringV3::CreateTimeSeriesRequest] create_time_series_request_object
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # @param [String] fields
497
+ # Selector specifying which fields to include in a partial response.
498
+ # @param [Google::Apis::RequestOptions] options
499
+ # Request-specific options
500
+ #
501
+ # @yield [result, err] Result & error if block supplied
502
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
503
+ # @yieldparam err [StandardError] error object if request failed
504
+ #
505
+ # @return [Google::Apis::MonitoringV3::Empty]
506
+ #
507
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
508
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
509
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
510
+ def create_time_series(name, create_time_series_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
511
+ command = make_simple_command(:post, 'v3/{+name}/timeSeries', options)
512
+ command.request_representation = Google::Apis::MonitoringV3::CreateTimeSeriesRequest::Representation
513
+ command.request_object = create_time_series_request_object
514
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
515
+ command.response_class = Google::Apis::MonitoringV3::Empty
516
+ command.params['name'] = name unless name.nil?
517
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
518
+ command.query['fields'] = fields unless fields.nil?
519
+ execute_or_queue_command(command, &block)
520
+ end
521
+
522
+ # Lists time series that match a filter. This method does not require a
523
+ # Stackdriver account.
524
+ # @param [String] name
525
+ # The project on which to execute the request. The format is "projects/`
526
+ # project_id_or_number`".
527
+ # @param [String] filter
528
+ # A monitoring filter (/monitoring/api/v3/filters) that specifies which time
529
+ # series should be returned. The filter must specify a single metric type, and
530
+ # can additionally specify metric labels and other information. For example:
531
+ # metric.type = &quot;compute.googleapis.com/instance/cpu/usage_time&quot; AND
532
+ # metric.label.instance_name = &quot;my-instance-name&quot;
533
+ # @param [Array<String>, String] aggregation_group_by_fields
534
+ # The set of fields to preserve when crossSeriesReducer is specified. The
535
+ # groupByFields determine how the time series are partitioned into subsets prior
536
+ # to applying the aggregation function. Each subset contains time series that
537
+ # have the same value for each of the grouping fields. Each individual time
538
+ # series is a member of exactly one subset. The crossSeriesReducer is applied to
539
+ # each subset of time series. Fields not specified in groupByFields are
540
+ # aggregated away. If groupByFields is not specified, the time series are
541
+ # aggregated into a single output time series. If crossSeriesReducer is not
542
+ # defined, this field is ignored.
543
+ # @param [String] aggregation_cross_series_reducer
544
+ # The approach to be used to combine time series. Not all reducer functions may
545
+ # be applied to all time series, depending on the metric type and the value type
546
+ # of the original time series. Reduction may change the metric type of value
547
+ # type of the time series.Time series data must be aligned in order to perform
548
+ # cross-time series reduction. If crossSeriesReducer is specified, then
549
+ # perSeriesAligner must be specified and not equal ALIGN_NONE and
550
+ # alignmentPeriod must be specified; otherwise, an error is returned.
551
+ # @param [String] interval_end_time
552
+ # Required. The end of the time interval.
553
+ # @param [String] interval_start_time
554
+ # Optional. The beginning of the time interval. The default value for the start
555
+ # time is the end time. The start time must not be later than the end time.
556
+ # @param [Fixnum] page_size
557
+ # A positive number that is the maximum number of results to return. When view
558
+ # field sets to FULL, it limits the number of Points server will return; if view
559
+ # field is HEADERS, it limits the number of TimeSeries server will return.
560
+ # @param [String] view
561
+ # Specifies which information is returned about the time series.
562
+ # @param [String] aggregation_alignment_period
563
+ # The alignment period for per-time series alignment. If present,
564
+ # alignmentPeriod must be at least 60 seconds. After per-time series alignment,
565
+ # each time series will contain data points only on the period boundaries. If
566
+ # perSeriesAligner is not specified or equals ALIGN_NONE, then this field is
567
+ # ignored. If perSeriesAligner is specified and does not equal ALIGN_NONE, then
568
+ # this field must be defined; otherwise an error is returned.
569
+ # @param [String] aggregation_per_series_aligner
570
+ # The approach to be used to align individual time series. Not all alignment
571
+ # functions may be applied to all time series, depending on the metric type and
572
+ # value type of the original time series. Alignment may change the metric type
573
+ # or the value type of the time series.Time series data must be aligned in order
574
+ # to perform cross-time series reduction. If crossSeriesReducer is specified,
575
+ # then perSeriesAligner must be specified and not equal ALIGN_NONE and
576
+ # alignmentPeriod must be specified; otherwise, an error is returned.
577
+ # @param [String] order_by
578
+ # Specifies the order in which the points of the time series should be returned.
579
+ # By default, results are not ordered. Currently, this field must be left blank.
580
+ # @param [String] page_token
581
+ # If this field is not empty then it must contain the nextPageToken value
582
+ # returned by a previous call to this method. Using this field causes the method
583
+ # to return additional results from the previous method call.
584
+ # @param [String] quota_user
585
+ # Available to use for quota purposes for server-side applications. Can be any
586
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
587
+ # @param [String] fields
588
+ # Selector specifying which fields to include in a partial response.
589
+ # @param [Google::Apis::RequestOptions] options
590
+ # Request-specific options
591
+ #
592
+ # @yield [result, err] Result & error if block supplied
593
+ # @yieldparam result [Google::Apis::MonitoringV3::ListTimeSeriesResponse] parsed result object
594
+ # @yieldparam err [StandardError] error object if request failed
595
+ #
596
+ # @return [Google::Apis::MonitoringV3::ListTimeSeriesResponse]
597
+ #
598
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
599
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
600
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
601
+ def list_project_time_series(name, filter: nil, aggregation_group_by_fields: nil, aggregation_cross_series_reducer: nil, interval_end_time: nil, interval_start_time: nil, page_size: nil, view: nil, aggregation_alignment_period: nil, aggregation_per_series_aligner: nil, order_by: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
602
+ command = make_simple_command(:get, 'v3/{+name}/timeSeries', options)
603
+ command.response_representation = Google::Apis::MonitoringV3::ListTimeSeriesResponse::Representation
604
+ command.response_class = Google::Apis::MonitoringV3::ListTimeSeriesResponse
605
+ command.params['name'] = name unless name.nil?
606
+ command.query['filter'] = filter unless filter.nil?
607
+ command.query['aggregation.groupByFields'] = aggregation_group_by_fields unless aggregation_group_by_fields.nil?
608
+ command.query['aggregation.crossSeriesReducer'] = aggregation_cross_series_reducer unless aggregation_cross_series_reducer.nil?
609
+ command.query['interval.endTime'] = interval_end_time unless interval_end_time.nil?
610
+ command.query['interval.startTime'] = interval_start_time unless interval_start_time.nil?
611
+ command.query['pageSize'] = page_size unless page_size.nil?
612
+ command.query['view'] = view unless view.nil?
613
+ command.query['aggregation.alignmentPeriod'] = aggregation_alignment_period unless aggregation_alignment_period.nil?
614
+ command.query['aggregation.perSeriesAligner'] = aggregation_per_series_aligner unless aggregation_per_series_aligner.nil?
615
+ command.query['orderBy'] = order_by unless order_by.nil?
616
+ command.query['pageToken'] = page_token unless page_token.nil?
617
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
618
+ command.query['fields'] = fields unless fields.nil?
619
+ execute_or_queue_command(command, &block)
620
+ end
621
+
622
+ # Gets a single monitored resource descriptor. This method does not require a
623
+ # Stackdriver account.
624
+ # @param [String] name
625
+ # The monitored resource descriptor to get. The format is &quot;projects/`
626
+ # project_id_or_number`/monitoredResourceDescriptors/`resource_type`&quot;. The `
627
+ # resource_type` is a predefined type, such as cloudsql_database.
628
+ # @param [String] quota_user
629
+ # Available to use for quota purposes for server-side applications. Can be any
630
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
631
+ # @param [String] fields
632
+ # Selector specifying which fields to include in a partial response.
633
+ # @param [Google::Apis::RequestOptions] options
634
+ # Request-specific options
635
+ #
636
+ # @yield [result, err] Result & error if block supplied
637
+ # @yieldparam result [Google::Apis::MonitoringV3::MonitoredResourceDescriptor] parsed result object
638
+ # @yieldparam err [StandardError] error object if request failed
639
+ #
640
+ # @return [Google::Apis::MonitoringV3::MonitoredResourceDescriptor]
641
+ #
642
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
643
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
644
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
645
+ def get_project_monitored_resource_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
646
+ command = make_simple_command(:get, 'v3/{+name}', options)
647
+ command.response_representation = Google::Apis::MonitoringV3::MonitoredResourceDescriptor::Representation
648
+ command.response_class = Google::Apis::MonitoringV3::MonitoredResourceDescriptor
649
+ command.params['name'] = name unless name.nil?
650
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
651
+ command.query['fields'] = fields unless fields.nil?
652
+ execute_or_queue_command(command, &block)
653
+ end
654
+
655
+ # Lists monitored resource descriptors that match a filter. This method does not
656
+ # require a Stackdriver account.
657
+ # @param [String] name
658
+ # The project on which to execute the request. The format is &quot;projects/`
659
+ # project_id_or_number`&quot;.
660
+ # @param [Fixnum] page_size
661
+ # A positive number that is the maximum number of results to return.
662
+ # @param [String] filter
663
+ # An optional filter (/monitoring/api/v3/filters) describing the descriptors to
664
+ # be returned. The filter can reference the descriptor's type and labels. For
665
+ # example, the following filter returns only Google Compute Engine descriptors
666
+ # that have an id label:
667
+ # resource.type = starts_with(&quot;gce_&quot;) AND resource.label:id
668
+ # @param [String] page_token
669
+ # If this field is not empty then it must contain the nextPageToken value
670
+ # returned by a previous call to this method. Using this field causes the method
671
+ # to return additional results from the previous method call.
672
+ # @param [String] quota_user
673
+ # Available to use for quota purposes for server-side applications. Can be any
674
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
675
+ # @param [String] fields
676
+ # Selector specifying which fields to include in a partial response.
677
+ # @param [Google::Apis::RequestOptions] options
678
+ # Request-specific options
679
+ #
680
+ # @yield [result, err] Result & error if block supplied
681
+ # @yieldparam result [Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse] parsed result object
682
+ # @yieldparam err [StandardError] error object if request failed
683
+ #
684
+ # @return [Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse]
685
+ #
686
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
687
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
688
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
689
+ def list_project_monitored_resource_descriptors(name, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
690
+ command = make_simple_command(:get, 'v3/{+name}/monitoredResourceDescriptors', options)
691
+ command.response_representation = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse::Representation
692
+ command.response_class = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse
693
+ command.params['name'] = name unless name.nil?
694
+ command.query['pageSize'] = page_size unless page_size.nil?
695
+ command.query['filter'] = filter unless filter.nil?
696
+ command.query['pageToken'] = page_token unless page_token.nil?
697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
698
+ command.query['fields'] = fields unless fields.nil?
699
+ execute_or_queue_command(command, &block)
700
+ end
701
+
702
+ protected
703
+
704
+ def apply_command_defaults(command)
705
+ command.query['key'] = key unless key.nil?
706
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
707
+ end
708
+ end
709
+ end
710
+ end
711
+ end