google-api-client 0.10.2 → 0.10.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (248) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +25 -0
  3. data/MIGRATING.md +22 -7
  4. data/README.md +4 -8
  5. data/api_names.yaml +1210 -37815
  6. data/generated/google/apis/acceleratedmobilepageurl_v1.rb +32 -0
  7. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +144 -0
  8. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +86 -0
  9. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +90 -0
  10. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  11. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +764 -764
  12. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +180 -180
  13. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +421 -421
  14. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +1 -0
  15. data/generated/google/apis/admin_directory_v1/classes.rb +1 -0
  16. data/generated/google/apis/admin_reports_v1.rb +1 -1
  17. data/generated/google/apis/adsense_v1_4.rb +1 -1
  18. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  19. data/generated/google/apis/analyticsreporting_v4/classes.rb +187 -187
  20. data/generated/google/apis/analyticsreporting_v4/representations.rb +42 -42
  21. data/generated/google/apis/appengine_v1.rb +40 -0
  22. data/generated/google/apis/appengine_v1/classes.rb +2251 -0
  23. data/generated/google/apis/appengine_v1/representations.rb +858 -0
  24. data/generated/google/apis/appengine_v1/service.rb +894 -0
  25. data/generated/google/apis/bigquery_v2.rb +1 -1
  26. data/generated/google/apis/bigquery_v2/classes.rb +11 -6
  27. data/generated/google/apis/books_v1.rb +1 -1
  28. data/generated/google/apis/books_v1/classes.rb +26 -0
  29. data/generated/google/apis/books_v1/representations.rb +15 -0
  30. data/generated/google/apis/books_v1/service.rb +4 -1
  31. data/generated/google/apis/calendar_v3.rb +1 -1
  32. data/generated/google/apis/classroom_v1.rb +1 -1
  33. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  34. data/generated/google/apis/cloudbuild_v1/classes.rb +638 -637
  35. data/generated/google/apis/cloudbuild_v1/representations.rb +110 -110
  36. data/generated/google/apis/cloudbuild_v1/service.rb +139 -139
  37. data/generated/google/apis/clouddebugger_v2.rb +3 -3
  38. data/generated/google/apis/clouddebugger_v2/classes.rb +131 -131
  39. data/generated/google/apis/clouddebugger_v2/representations.rb +25 -25
  40. data/generated/google/apis/clouderrorreporting_v1beta1.rb +36 -0
  41. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +590 -0
  42. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +252 -0
  43. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +350 -0
  44. data/generated/google/apis/cloudfunctions_v1.rb +35 -0
  45. data/generated/google/apis/cloudfunctions_v1/classes.rb +98 -0
  46. data/generated/google/apis/cloudfunctions_v1/representations.rb +57 -0
  47. data/generated/google/apis/cloudfunctions_v1/service.rb +89 -0
  48. data/generated/google/apis/cloudkms_v1/classes.rb +277 -270
  49. data/generated/google/apis/cloudkms_v1/representations.rb +73 -73
  50. data/generated/google/apis/cloudkms_v1/service.rb +194 -194
  51. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  52. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1147 -1144
  53. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +188 -188
  54. data/generated/google/apis/cloudresourcemanager_v1/service.rb +513 -936
  55. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  56. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +307 -916
  57. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +63 -285
  58. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +333 -681
  59. data/generated/google/apis/cloudtrace_v1/classes.rb +38 -38
  60. data/generated/google/apis/cloudtrace_v1/representations.rb +13 -13
  61. data/generated/google/apis/cloudtrace_v1/service.rb +16 -16
  62. data/generated/google/apis/compute_beta.rb +1 -1
  63. data/generated/google/apis/compute_beta/classes.rb +32 -7
  64. data/generated/google/apis/compute_beta/representations.rb +2 -0
  65. data/generated/google/apis/compute_beta/service.rb +11 -11
  66. data/generated/google/apis/compute_v1.rb +1 -1
  67. data/generated/google/apis/compute_v1/classes.rb +95 -2
  68. data/generated/google/apis/compute_v1/representations.rb +33 -0
  69. data/generated/google/apis/dataflow_v1b3/classes.rb +3333 -3333
  70. data/generated/google/apis/dataflow_v1b3/representations.rb +759 -759
  71. data/generated/google/apis/dataflow_v1b3/service.rb +154 -154
  72. data/generated/google/apis/dataproc_v1.rb +1 -1
  73. data/generated/google/apis/dataproc_v1/classes.rb +1097 -1097
  74. data/generated/google/apis/dataproc_v1/representations.rb +200 -200
  75. data/generated/google/apis/dataproc_v1/service.rb +356 -356
  76. data/generated/google/apis/datastore_v1.rb +4 -4
  77. data/generated/google/apis/datastore_v1/classes.rb +701 -690
  78. data/generated/google/apis/datastore_v1/representations.rb +160 -160
  79. data/generated/google/apis/datastore_v1/service.rb +52 -52
  80. data/generated/google/apis/deploymentmanager_v2/classes.rb +4 -0
  81. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  82. data/generated/google/apis/drive_v2.rb +1 -1
  83. data/generated/google/apis/drive_v2/classes.rb +158 -35
  84. data/generated/google/apis/drive_v2/representations.rb +39 -0
  85. data/generated/google/apis/drive_v2/service.rb +4 -4
  86. data/generated/google/apis/drive_v3.rb +1 -1
  87. data/generated/google/apis/drive_v3/classes.rb +162 -33
  88. data/generated/google/apis/drive_v3/representations.rb +39 -0
  89. data/generated/google/apis/drive_v3/service.rb +4 -4
  90. data/generated/google/apis/firebasedynamiclinks_v1.rb +35 -0
  91. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +466 -0
  92. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +222 -0
  93. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +95 -0
  94. data/generated/google/apis/firebaserules_v1.rb +41 -0
  95. data/generated/google/apis/firebaserules_v1/classes.rb +425 -0
  96. data/generated/google/apis/firebaserules_v1/representations.rb +222 -0
  97. data/generated/google/apis/firebaserules_v1/service.rb +495 -0
  98. data/generated/google/apis/games_v1/classes.rb +4 -0
  99. data/generated/google/apis/genomics_v1.rb +7 -7
  100. data/generated/google/apis/genomics_v1/classes.rb +2336 -2335
  101. data/generated/google/apis/genomics_v1/representations.rb +387 -387
  102. data/generated/google/apis/genomics_v1/service.rb +1187 -1187
  103. data/generated/google/apis/gmail_v1/classes.rb +3 -0
  104. data/generated/google/apis/iam_v1.rb +1 -1
  105. data/generated/google/apis/iam_v1/classes.rb +123 -117
  106. data/generated/google/apis/iam_v1/representations.rb +33 -33
  107. data/generated/google/apis/iam_v1/service.rb +109 -109
  108. data/generated/google/apis/identitytoolkit_v3/classes.rb +5 -0
  109. data/generated/google/apis/kgsearch_v1/classes.rb +6 -6
  110. data/generated/google/apis/kgsearch_v1/representations.rb +1 -1
  111. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  112. data/generated/google/apis/language_v1.rb +36 -0
  113. data/generated/google/apis/language_v1/classes.rb +757 -0
  114. data/generated/google/apis/language_v1/representations.rb +338 -0
  115. data/generated/google/apis/language_v1/service.rb +185 -0
  116. data/generated/google/apis/language_v1beta1/classes.rb +407 -407
  117. data/generated/google/apis/language_v1beta1/representations.rb +103 -103
  118. data/generated/google/apis/language_v1beta1/service.rb +45 -45
  119. data/generated/google/apis/logging_v2.rb +46 -0
  120. data/generated/google/apis/logging_v2/classes.rb +1271 -0
  121. data/generated/google/apis/logging_v2/representations.rb +421 -0
  122. data/generated/google/apis/logging_v2/service.rb +1569 -0
  123. data/generated/google/apis/logging_v2beta1.rb +1 -1
  124. data/generated/google/apis/logging_v2beta1/classes.rb +886 -886
  125. data/generated/google/apis/logging_v2beta1/representations.rb +132 -132
  126. data/generated/google/apis/logging_v2beta1/service.rb +235 -235
  127. data/generated/google/apis/manufacturers_v1/classes.rb +147 -147
  128. data/generated/google/apis/manufacturers_v1/representations.rb +29 -29
  129. data/generated/google/apis/ml_v1.rb +34 -0
  130. data/generated/google/apis/ml_v1/classes.rb +1617 -0
  131. data/generated/google/apis/ml_v1/representations.rb +498 -0
  132. data/generated/google/apis/ml_v1/service.rb +769 -0
  133. data/generated/google/apis/monitoring_v3.rb +4 -4
  134. data/generated/google/apis/monitoring_v3/classes.rb +630 -630
  135. data/generated/google/apis/monitoring_v3/representations.rb +134 -134
  136. data/generated/google/apis/monitoring_v3/service.rb +240 -240
  137. data/generated/google/apis/pagespeedonline_v2/classes.rb +1 -0
  138. data/generated/google/apis/partners_v2.rb +1 -1
  139. data/generated/google/apis/partners_v2/classes.rb +639 -639
  140. data/generated/google/apis/partners_v2/representations.rb +168 -168
  141. data/generated/google/apis/partners_v2/service.rb +381 -381
  142. data/generated/google/apis/people_v1.rb +10 -10
  143. data/generated/google/apis/people_v1/classes.rb +524 -524
  144. data/generated/google/apis/people_v1/representations.rb +143 -143
  145. data/generated/google/apis/people_v1/service.rb +30 -30
  146. data/generated/google/apis/plus_domains_v1.rb +1 -1
  147. data/generated/google/apis/plus_v1.rb +1 -1
  148. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +454 -444
  149. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +90 -90
  150. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +110 -110
  151. data/generated/google/apis/pubsub_v1/classes.rb +175 -173
  152. data/generated/google/apis/pubsub_v1/representations.rb +53 -53
  153. data/generated/google/apis/pubsub_v1/service.rb +210 -210
  154. data/generated/google/apis/replicapool_v1beta2/classes.rb +2 -0
  155. data/generated/google/apis/runtimeconfig_v1.rb +38 -0
  156. data/generated/google/apis/runtimeconfig_v1/classes.rb +252 -0
  157. data/generated/google/apis/runtimeconfig_v1/representations.rb +98 -0
  158. data/generated/google/apis/runtimeconfig_v1/service.rb +176 -0
  159. data/generated/google/apis/script_v1.rb +1 -1
  160. data/generated/google/apis/script_v1/classes.rb +6 -6
  161. data/generated/google/apis/script_v1/representations.rb +1 -1
  162. data/generated/google/apis/searchconsole_v1.rb +31 -0
  163. data/generated/google/apis/searchconsole_v1/classes.rb +205 -0
  164. data/generated/google/apis/searchconsole_v1/representations.rb +129 -0
  165. data/generated/google/apis/searchconsole_v1/service.rb +88 -0
  166. data/generated/google/apis/servicecontrol_v1.rb +38 -0
  167. data/generated/google/apis/servicecontrol_v1/classes.rb +1675 -0
  168. data/generated/google/apis/servicecontrol_v1/representations.rb +601 -0
  169. data/generated/google/apis/servicecontrol_v1/service.rb +337 -0
  170. data/generated/google/apis/servicemanagement_v1.rb +45 -0
  171. data/generated/google/apis/servicemanagement_v1/classes.rb +4934 -0
  172. data/generated/google/apis/servicemanagement_v1/representations.rb +1526 -0
  173. data/generated/google/apis/servicemanagement_v1/service.rb +860 -0
  174. data/generated/google/apis/serviceuser_v1.rb +42 -0
  175. data/generated/google/apis/serviceuser_v1/classes.rb +3746 -0
  176. data/generated/google/apis/serviceuser_v1/representations.rb +1041 -0
  177. data/generated/google/apis/serviceuser_v1/service.rb +214 -0
  178. data/generated/google/apis/sheets_v4.rb +3 -3
  179. data/generated/google/apis/sheets_v4/classes.rb +4390 -4390
  180. data/generated/google/apis/sheets_v4/representations.rb +381 -381
  181. data/generated/google/apis/sheets_v4/service.rb +48 -48
  182. data/generated/google/apis/slides_v1.rb +3 -3
  183. data/generated/google/apis/slides_v1/classes.rb +2860 -2860
  184. data/generated/google/apis/slides_v1/representations.rb +693 -693
  185. data/generated/google/apis/slides_v1/service.rb +30 -30
  186. data/generated/google/apis/sourcerepo_v1.rb +34 -0
  187. data/generated/google/apis/sourcerepo_v1/classes.rb +687 -0
  188. data/generated/google/apis/sourcerepo_v1/representations.rb +285 -0
  189. data/generated/google/apis/sourcerepo_v1/service.rb +291 -0
  190. data/generated/google/apis/spanner_v1.rb +35 -0
  191. data/generated/google/apis/spanner_v1/classes.rb +3294 -0
  192. data/generated/google/apis/spanner_v1/representations.rb +984 -0
  193. data/generated/google/apis/spanner_v1/service.rb +1504 -0
  194. data/generated/google/apis/speech_v1beta1.rb +1 -1
  195. data/generated/google/apis/speech_v1beta1/classes.rb +197 -196
  196. data/generated/google/apis/speech_v1beta1/representations.rb +53 -53
  197. data/generated/google/apis/speech_v1beta1/service.rb +27 -27
  198. data/generated/google/apis/storage_v1.rb +1 -1
  199. data/generated/google/apis/storage_v1/classes.rb +131 -0
  200. data/generated/google/apis/storage_v1/representations.rb +51 -0
  201. data/generated/google/apis/storage_v1/service.rb +182 -0
  202. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  203. data/generated/google/apis/storagetransfer_v1/classes.rb +732 -661
  204. data/generated/google/apis/storagetransfer_v1/representations.rb +132 -132
  205. data/generated/google/apis/storagetransfer_v1/service.rb +174 -197
  206. data/generated/google/apis/surveys_v2.rb +40 -0
  207. data/generated/google/apis/surveys_v2/classes.rb +806 -0
  208. data/generated/google/apis/surveys_v2/representations.rb +347 -0
  209. data/generated/google/apis/surveys_v2/service.rb +477 -0
  210. data/generated/google/apis/tagmanager_v2.rb +52 -0
  211. data/generated/google/apis/tagmanager_v2/classes.rb +2435 -0
  212. data/generated/google/apis/tagmanager_v2/representations.rb +993 -0
  213. data/generated/google/apis/tagmanager_v2/service.rb +2865 -0
  214. data/generated/google/apis/toolresults_v1beta3.rb +34 -0
  215. data/generated/google/apis/toolresults_v1beta3/classes.rb +2160 -0
  216. data/generated/google/apis/toolresults_v1beta3/representations.rb +729 -0
  217. data/generated/google/apis/toolresults_v1beta3/service.rb +1236 -0
  218. data/generated/google/apis/tracing_v1.rb +40 -0
  219. data/generated/google/apis/tracing_v1/classes.rb +664 -0
  220. data/generated/google/apis/tracing_v1/representations.rb +279 -0
  221. data/generated/google/apis/tracing_v1/service.rb +225 -0
  222. data/generated/google/apis/vision_v1.rb +1 -1
  223. data/generated/google/apis/vision_v1/classes.rb +1223 -1222
  224. data/generated/google/apis/vision_v1/representations.rb +234 -234
  225. data/generated/google/apis/vision_v1/service.rb +10 -10
  226. data/generated/google/apis/webfonts_v1.rb +33 -0
  227. data/generated/google/apis/webfonts_v1/classes.rb +113 -0
  228. data/generated/google/apis/webfonts_v1/representations.rb +62 -0
  229. data/generated/google/apis/webfonts_v1/service.rb +102 -0
  230. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  231. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  232. data/generated/google/apis/youtube_partner_v1/classes.rb +31 -0
  233. data/generated/google/apis/youtube_partner_v1/representations.rb +6 -0
  234. data/generated/google/apis/youtube_partner_v1/service.rb +41 -0
  235. data/generated/google/apis/youtube_v3/classes.rb +1 -0
  236. data/generated/google/apis/youtubereporting_v1.rb +4 -4
  237. data/generated/google/apis/youtubereporting_v1/classes.rb +76 -76
  238. data/generated/google/apis/youtubereporting_v1/representations.rb +25 -25
  239. data/generated/google/apis/youtubereporting_v1/service.rb +95 -95
  240. data/lib/google/apis/generator/annotator.rb +5 -4
  241. data/lib/google/apis/generator/templates/_class.tmpl +3 -0
  242. data/lib/google/apis/version.rb +1 -1
  243. data/samples/cli/lib/samples/adsense.rb +99 -0
  244. data/samples/cli/lib/samples/analytics.rb +18 -0
  245. data/samples/cli/lib/samples/gmail.rb +33 -0
  246. data/samples/cli/lib/samples/vision.rb +69 -0
  247. metadata +89 -4
  248. data/sync.rb +0 -71
@@ -0,0 +1,40 @@
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/tracing_v1/service.rb'
16
+ require 'google/apis/tracing_v1/classes.rb'
17
+ require 'google/apis/tracing_v1/representations.rb'
18
+
19
+ module Google
20
+ module Apis
21
+ # Google Tracing API
22
+ #
23
+ # Send and retrieve trace data from Google Stackdriver Trace.
24
+ #
25
+ # @see https://cloud.google.com/trace
26
+ module TracingV1
27
+ VERSION = 'V1'
28
+ REVISION = '20170320'
29
+
30
+ # Read Trace data for a project or application
31
+ AUTH_TRACE_READONLY = 'https://www.googleapis.com/auth/trace.readonly'
32
+
33
+ # Write Trace data for a project or application
34
+ AUTH_TRACE_APPEND = 'https://www.googleapis.com/auth/trace.append'
35
+
36
+ # View and manage your data across Google Cloud Platform services
37
+ AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
38
+ end
39
+ end
40
+ end
@@ -0,0 +1,664 @@
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 'date'
16
+ require 'google/apis/core/base_service'
17
+ require 'google/apis/core/json_representation'
18
+ require 'google/apis/core/hashable'
19
+ require 'google/apis/errors'
20
+
21
+ module Google
22
+ module Apis
23
+ module TracingV1
24
+
25
+ # A trace describes how long it takes for an application to perform some
26
+ # operations. It consists of a set of spans, each representing
27
+ # an operation and including time information and operation details.
28
+ class Trace
29
+ include Google::Apis::Core::Hashable
30
+
31
+ # A globally unique identifier for the trace in the format
32
+ # `projects/PROJECT_NUMBER/traces/TRACE_ID`. `TRACE_ID` is a base16-encoded
33
+ # string of a 128-bit number and is required to be 32 char long.
34
+ # Corresponds to the JSON property `name`
35
+ # @return [String]
36
+ attr_accessor :name
37
+
38
+ def initialize(**args)
39
+ update!(**args)
40
+ end
41
+
42
+ # Update properties of this object
43
+ def update!(**args)
44
+ @name = args[:name] if args.key?(:name)
45
+ end
46
+ end
47
+
48
+ # Binary module.
49
+ class Module
50
+ include Google::Apis::Core::Hashable
51
+
52
+ # Build_id is a unique identifier for the module,
53
+ # usually a hash of its contents
54
+ # Corresponds to the JSON property `buildId`
55
+ # @return [String]
56
+ attr_accessor :build_id
57
+
58
+ # E.g. main binary, kernel modules, and dynamic libraries
59
+ # such as libc.so, sharedlib.so
60
+ # Corresponds to the JSON property `module`
61
+ # @return [String]
62
+ attr_accessor :module
63
+
64
+ def initialize(**args)
65
+ update!(**args)
66
+ end
67
+
68
+ # Update properties of this object
69
+ def update!(**args)
70
+ @build_id = args[:build_id] if args.key?(:build_id)
71
+ @module = args[:module] if args.key?(:module)
72
+ end
73
+ end
74
+
75
+ # The `Status` type defines a logical error model that is suitable for different
76
+ # programming environments, including REST APIs and RPC APIs. It is used by
77
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
78
+ # - Simple to use and understand for most users
79
+ # - Flexible enough to meet unexpected needs
80
+ # # Overview
81
+ # The `Status` message contains three pieces of data: error code, error message,
82
+ # and error details. The error code should be an enum value of
83
+ # google.rpc.Code, but it may accept additional error codes if needed. The
84
+ # error message should be a developer-facing English message that helps
85
+ # developers *understand* and *resolve* the error. If a localized user-facing
86
+ # error message is needed, put the localized message in the error details or
87
+ # localize it in the client. The optional error details may contain arbitrary
88
+ # information about the error. There is a predefined set of error detail types
89
+ # in the package `google.rpc` which can be used for common error conditions.
90
+ # # Language mapping
91
+ # The `Status` message is the logical representation of the error model, but it
92
+ # is not necessarily the actual wire format. When the `Status` message is
93
+ # exposed in different client libraries and different wire protocols, it can be
94
+ # mapped differently. For example, it will likely be mapped to some exceptions
95
+ # in Java, but more likely mapped to some error codes in C.
96
+ # # Other uses
97
+ # The error model and the `Status` message can be used in a variety of
98
+ # environments, either with or without APIs, to provide a
99
+ # consistent developer experience across different environments.
100
+ # Example uses of this error model include:
101
+ # - Partial errors. If a service needs to return partial errors to the client,
102
+ # it may embed the `Status` in the normal response to indicate the partial
103
+ # errors.
104
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
105
+ # have a `Status` message for error reporting purpose.
106
+ # - Batch operations. If a client uses batch request and batch response, the
107
+ # `Status` message should be used directly inside batch response, one for
108
+ # each error sub-response.
109
+ # - Asynchronous operations. If an API call embeds asynchronous operation
110
+ # results in its response, the status of those operations should be
111
+ # represented directly using the `Status` message.
112
+ # - Logging. If some API errors are stored in logs, the message `Status` could
113
+ # be used directly after any stripping needed for security/privacy reasons.
114
+ class Status
115
+ include Google::Apis::Core::Hashable
116
+
117
+ # The status code, which should be an enum value of google.rpc.Code.
118
+ # Corresponds to the JSON property `code`
119
+ # @return [Fixnum]
120
+ attr_accessor :code
121
+
122
+ # A developer-facing error message, which should be in English. Any
123
+ # user-facing error message should be localized and sent in the
124
+ # google.rpc.Status.details field, or localized by the client.
125
+ # Corresponds to the JSON property `message`
126
+ # @return [String]
127
+ attr_accessor :message
128
+
129
+ # A list of messages that carry the error details. There will be a
130
+ # common set of message types for APIs to use.
131
+ # Corresponds to the JSON property `details`
132
+ # @return [Array<Hash<String,Object>>]
133
+ attr_accessor :details
134
+
135
+ def initialize(**args)
136
+ update!(**args)
137
+ end
138
+
139
+ # Update properties of this object
140
+ def update!(**args)
141
+ @code = args[:code] if args.key?(:code)
142
+ @message = args[:message] if args.key?(:message)
143
+ @details = args[:details] if args.key?(:details)
144
+ end
145
+ end
146
+
147
+ # A generic empty message that you can re-use to avoid defining duplicated
148
+ # empty messages in your APIs. A typical example is to use it as the request
149
+ # or the response type of an API method. For instance:
150
+ # service Foo `
151
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
152
+ # `
153
+ # The JSON representation for `Empty` is empty JSON object ````.
154
+ class Empty
155
+ include Google::Apis::Core::Hashable
156
+
157
+ def initialize(**args)
158
+ update!(**args)
159
+ end
160
+
161
+ # Update properties of this object
162
+ def update!(**args)
163
+ end
164
+ end
165
+
166
+ # The response message for the `ListTraces` method.
167
+ class ListTracesResponse
168
+ include Google::Apis::Core::Hashable
169
+
170
+ # List of trace records returned.
171
+ # Corresponds to the JSON property `traces`
172
+ # @return [Array<Google::Apis::TracingV1::Trace>]
173
+ attr_accessor :traces
174
+
175
+ # If defined, indicates that there are more traces that match the request
176
+ # and that this value should be passed to the next request to continue
177
+ # retrieving additional traces.
178
+ # Corresponds to the JSON property `nextPageToken`
179
+ # @return [String]
180
+ attr_accessor :next_page_token
181
+
182
+ def initialize(**args)
183
+ update!(**args)
184
+ end
185
+
186
+ # Update properties of this object
187
+ def update!(**args)
188
+ @traces = args[:traces] if args.key?(:traces)
189
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
190
+ end
191
+ end
192
+
193
+ # A span represents a single operation within a trace. Spans can be nested
194
+ # to form a trace tree. Often, a trace contains a root span that
195
+ # describes the end-to-end latency and, optionally, one or more subspans for
196
+ # its sub-operations. (A trace could alternatively contain multiple root spans,
197
+ # or none at all.) Spans do not need to be contiguous. There may be gaps
198
+ # and/or overlaps between spans in a trace.
199
+ class Span
200
+ include Google::Apis::Core::Hashable
201
+
202
+ # End time of the span.
203
+ # On the client side, this is the local machine clock time at which the span
204
+ # execution was ended; on the server
205
+ # side, this is the time at which the server application handler stopped
206
+ # running.
207
+ # Corresponds to the JSON property `localEndTime`
208
+ # @return [String]
209
+ attr_accessor :local_end_time
210
+
211
+ # ID of the parent span. If this is a root span, the value must be `0` or
212
+ # empty.
213
+ # Corresponds to the JSON property `parentId`
214
+ # @return [String]
215
+ attr_accessor :parent_id
216
+
217
+ # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation
218
+ # on the span, consisting of either user-supplied key:value pairs, or
219
+ # details of an RPC message sent/received on the network.
220
+ # Corresponds to the JSON property `timeEvents`
221
+ # @return [Array<Google::Apis::TracingV1::TimeEvent>]
222
+ attr_accessor :time_events
223
+
224
+ # The `Status` type defines a logical error model that is suitable for different
225
+ # programming environments, including REST APIs and RPC APIs. It is used by
226
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
227
+ # - Simple to use and understand for most users
228
+ # - Flexible enough to meet unexpected needs
229
+ # # Overview
230
+ # The `Status` message contains three pieces of data: error code, error message,
231
+ # and error details. The error code should be an enum value of
232
+ # google.rpc.Code, but it may accept additional error codes if needed. The
233
+ # error message should be a developer-facing English message that helps
234
+ # developers *understand* and *resolve* the error. If a localized user-facing
235
+ # error message is needed, put the localized message in the error details or
236
+ # localize it in the client. The optional error details may contain arbitrary
237
+ # information about the error. There is a predefined set of error detail types
238
+ # in the package `google.rpc` which can be used for common error conditions.
239
+ # # Language mapping
240
+ # The `Status` message is the logical representation of the error model, but it
241
+ # is not necessarily the actual wire format. When the `Status` message is
242
+ # exposed in different client libraries and different wire protocols, it can be
243
+ # mapped differently. For example, it will likely be mapped to some exceptions
244
+ # in Java, but more likely mapped to some error codes in C.
245
+ # # Other uses
246
+ # The error model and the `Status` message can be used in a variety of
247
+ # environments, either with or without APIs, to provide a
248
+ # consistent developer experience across different environments.
249
+ # Example uses of this error model include:
250
+ # - Partial errors. If a service needs to return partial errors to the client,
251
+ # it may embed the `Status` in the normal response to indicate the partial
252
+ # errors.
253
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
254
+ # have a `Status` message for error reporting purpose.
255
+ # - Batch operations. If a client uses batch request and batch response, the
256
+ # `Status` message should be used directly inside batch response, one for
257
+ # each error sub-response.
258
+ # - Asynchronous operations. If an API call embeds asynchronous operation
259
+ # results in its response, the status of those operations should be
260
+ # represented directly using the `Status` message.
261
+ # - Logging. If some API errors are stored in logs, the message `Status` could
262
+ # be used directly after any stripping needed for security/privacy reasons.
263
+ # Corresponds to the JSON property `status`
264
+ # @return [Google::Apis::TracingV1::Status]
265
+ attr_accessor :status
266
+
267
+ # Name of the span. The span name is sanitized and displayed in the
268
+ # Stackdriver Trace tool in the `% dynamic print site_values.console_name %`.
269
+ # The name may be a method name or some other per-call site name.
270
+ # For the same executable and the same call point, a best practice is
271
+ # to use a consistent name, which makes it easier to correlate
272
+ # cross-trace spans.
273
+ # Corresponds to the JSON property `name`
274
+ # @return [String]
275
+ attr_accessor :name
276
+
277
+ # StackTrace collected in a trace.
278
+ # Corresponds to the JSON property `stackTrace`
279
+ # @return [Google::Apis::TracingV1::StackTrace]
280
+ attr_accessor :stack_trace
281
+
282
+ # A collection of links, which are references from this span to another span
283
+ # in a different trace.
284
+ # Corresponds to the JSON property `links`
285
+ # @return [Array<Google::Apis::TracingV1::Link>]
286
+ attr_accessor :links
287
+
288
+ # Properties of a span in key:value format. The maximum length for the
289
+ # key is 128 characters. The value can be a string (up to 2000 characters),
290
+ # int, or boolean.
291
+ # Some common pair examples:
292
+ # "/instance_id": "my-instance"
293
+ # "/zone": "us-central1-a"
294
+ # "/grpc/peer_address": "ip:port" (dns, etc.)
295
+ # "/grpc/deadline": "Duration"
296
+ # "/http/user_agent"
297
+ # "/http/request_bytes": 300
298
+ # "/http/response_bytes": 1200
299
+ # "/http/url": google.com/apis
300
+ # "abc.com/myattribute": true
301
+ # Corresponds to the JSON property `attributes`
302
+ # @return [Hash<String,Google::Apis::TracingV1::AttributeValue>]
303
+ attr_accessor :attributes
304
+
305
+ # Identifier for the span. Must be a 64-bit integer other than 0 and
306
+ # unique within a trace.
307
+ # Corresponds to the JSON property `id`
308
+ # @return [String]
309
+ attr_accessor :id
310
+
311
+ # Start time of the span.
312
+ # On the client side, this is the local machine clock time at which the span
313
+ # execution was started; on the server
314
+ # side, this is the time at which the server application handler started
315
+ # running.
316
+ # Corresponds to the JSON property `localStartTime`
317
+ # @return [String]
318
+ attr_accessor :local_start_time
319
+
320
+ # True if this span has a remote parent (is an RPC server span).
321
+ # Corresponds to the JSON property `hasRemoteParent`
322
+ # @return [Boolean]
323
+ attr_accessor :has_remote_parent
324
+ alias_method :has_remote_parent?, :has_remote_parent
325
+
326
+ def initialize(**args)
327
+ update!(**args)
328
+ end
329
+
330
+ # Update properties of this object
331
+ def update!(**args)
332
+ @local_end_time = args[:local_end_time] if args.key?(:local_end_time)
333
+ @parent_id = args[:parent_id] if args.key?(:parent_id)
334
+ @time_events = args[:time_events] if args.key?(:time_events)
335
+ @status = args[:status] if args.key?(:status)
336
+ @name = args[:name] if args.key?(:name)
337
+ @stack_trace = args[:stack_trace] if args.key?(:stack_trace)
338
+ @links = args[:links] if args.key?(:links)
339
+ @attributes = args[:attributes] if args.key?(:attributes)
340
+ @id = args[:id] if args.key?(:id)
341
+ @local_start_time = args[:local_start_time] if args.key?(:local_start_time)
342
+ @has_remote_parent = args[:has_remote_parent] if args.key?(:has_remote_parent)
343
+ end
344
+ end
345
+
346
+ # The allowed types for the value side of an attribute key:value pair.
347
+ class AttributeValue
348
+ include Google::Apis::Core::Hashable
349
+
350
+ # A string value.
351
+ # Corresponds to the JSON property `stringValue`
352
+ # @return [String]
353
+ attr_accessor :string_value
354
+
355
+ # A boolean value.
356
+ # Corresponds to the JSON property `boolValue`
357
+ # @return [Boolean]
358
+ attr_accessor :bool_value
359
+ alias_method :bool_value?, :bool_value
360
+
361
+ # An integer value.
362
+ # Corresponds to the JSON property `intValue`
363
+ # @return [String]
364
+ attr_accessor :int_value
365
+
366
+ def initialize(**args)
367
+ update!(**args)
368
+ end
369
+
370
+ # Update properties of this object
371
+ def update!(**args)
372
+ @string_value = args[:string_value] if args.key?(:string_value)
373
+ @bool_value = args[:bool_value] if args.key?(:bool_value)
374
+ @int_value = args[:int_value] if args.key?(:int_value)
375
+ end
376
+ end
377
+
378
+ # The request message for the `BatchUpdateSpans` method.
379
+ class BatchUpdateSpansRequest
380
+ include Google::Apis::Core::Hashable
381
+
382
+ # A map from trace name to spans to be stored or updated.
383
+ # Corresponds to the JSON property `spanUpdates`
384
+ # @return [Hash<String,Google::Apis::TracingV1::SpanUpdates>]
385
+ attr_accessor :span_updates
386
+
387
+ def initialize(**args)
388
+ update!(**args)
389
+ end
390
+
391
+ # Update properties of this object
392
+ def update!(**args)
393
+ @span_updates = args[:span_updates] if args.key?(:span_updates)
394
+ end
395
+ end
396
+
397
+ # StackTrace collected in a trace.
398
+ class StackTrace
399
+ include Google::Apis::Core::Hashable
400
+
401
+ # Stack frames of this stack trace.
402
+ # Corresponds to the JSON property `stackFrame`
403
+ # @return [Array<Google::Apis::TracingV1::StackFrame>]
404
+ attr_accessor :stack_frame
405
+
406
+ # The hash ID is used to conserve network bandwidth for duplicate
407
+ # stack traces within a single trace.
408
+ # Often multiple spans will have identical stack traces.
409
+ # The first occurance of a stack trace should contain both the
410
+ # `stackFrame` content and a value in `stackTraceHashId`.
411
+ # Subsequent spans within the same request can refer
412
+ # to that stack trace by only setting `stackTraceHashId`.
413
+ # Corresponds to the JSON property `stackTraceHashId`
414
+ # @return [String]
415
+ attr_accessor :stack_trace_hash_id
416
+
417
+ def initialize(**args)
418
+ update!(**args)
419
+ end
420
+
421
+ # Update properties of this object
422
+ def update!(**args)
423
+ @stack_frame = args[:stack_frame] if args.key?(:stack_frame)
424
+ @stack_trace_hash_id = args[:stack_trace_hash_id] if args.key?(:stack_trace_hash_id)
425
+ end
426
+ end
427
+
428
+ # A time-stamped annotation in the Span.
429
+ class TimeEvent
430
+ include Google::Apis::Core::Hashable
431
+
432
+ # An event describing an RPC message sent/received on the network.
433
+ # Corresponds to the JSON property `networkEvent`
434
+ # @return [Google::Apis::TracingV1::NetworkEvent]
435
+ attr_accessor :network_event
436
+
437
+ # Text annotation with a set of attributes.
438
+ # Corresponds to the JSON property `annotation`
439
+ # @return [Google::Apis::TracingV1::Annotation]
440
+ attr_accessor :annotation
441
+
442
+ # The timestamp indicating the time the event occurred.
443
+ # Corresponds to the JSON property `localTime`
444
+ # @return [String]
445
+ attr_accessor :local_time
446
+
447
+ def initialize(**args)
448
+ update!(**args)
449
+ end
450
+
451
+ # Update properties of this object
452
+ def update!(**args)
453
+ @network_event = args[:network_event] if args.key?(:network_event)
454
+ @annotation = args[:annotation] if args.key?(:annotation)
455
+ @local_time = args[:local_time] if args.key?(:local_time)
456
+ end
457
+ end
458
+
459
+ # An event describing an RPC message sent/received on the network.
460
+ class NetworkEvent
461
+ include Google::Apis::Core::Hashable
462
+
463
+ # The number of bytes sent or received.
464
+ # Corresponds to the JSON property `messageSize`
465
+ # @return [String]
466
+ attr_accessor :message_size
467
+
468
+ # If available, this is the kernel time:
469
+ # * For sent messages, this is the time at which the first bit was sent.
470
+ # * For received messages, this is the time at which the last bit was
471
+ # received.
472
+ # Corresponds to the JSON property `kernelTime`
473
+ # @return [String]
474
+ attr_accessor :kernel_time
475
+
476
+ # Type of NetworkEvent. Indicates whether the RPC message was sent or
477
+ # received.
478
+ # Corresponds to the JSON property `type`
479
+ # @return [String]
480
+ attr_accessor :type
481
+
482
+ # An identifier for the message, which must be unique in this span.
483
+ # Corresponds to the JSON property `messageId`
484
+ # @return [String]
485
+ attr_accessor :message_id
486
+
487
+ def initialize(**args)
488
+ update!(**args)
489
+ end
490
+
491
+ # Update properties of this object
492
+ def update!(**args)
493
+ @message_size = args[:message_size] if args.key?(:message_size)
494
+ @kernel_time = args[:kernel_time] if args.key?(:kernel_time)
495
+ @type = args[:type] if args.key?(:type)
496
+ @message_id = args[:message_id] if args.key?(:message_id)
497
+ end
498
+ end
499
+
500
+ # The response message for the `ListSpans` method.
501
+ class ListSpansResponse
502
+ include Google::Apis::Core::Hashable
503
+
504
+ # The requested spans if there are any in the specified trace.
505
+ # Corresponds to the JSON property `spans`
506
+ # @return [Array<Google::Apis::TracingV1::Span>]
507
+ attr_accessor :spans
508
+
509
+ # If defined, indicates that there are more spans that match the request.
510
+ # Pass this as the value of `pageToken` in a subsequent request to retrieve
511
+ # additional spans.
512
+ # Corresponds to the JSON property `nextPageToken`
513
+ # @return [String]
514
+ attr_accessor :next_page_token
515
+
516
+ def initialize(**args)
517
+ update!(**args)
518
+ end
519
+
520
+ # Update properties of this object
521
+ def update!(**args)
522
+ @spans = args[:spans] if args.key?(:spans)
523
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
524
+ end
525
+ end
526
+
527
+ # Collection of spans to update.
528
+ class SpanUpdates
529
+ include Google::Apis::Core::Hashable
530
+
531
+ # A collection of spans.
532
+ # Corresponds to the JSON property `spans`
533
+ # @return [Array<Google::Apis::TracingV1::Span>]
534
+ attr_accessor :spans
535
+
536
+ def initialize(**args)
537
+ update!(**args)
538
+ end
539
+
540
+ # Update properties of this object
541
+ def update!(**args)
542
+ @spans = args[:spans] if args.key?(:spans)
543
+ end
544
+ end
545
+
546
+ # Represents a single stack frame in a stack trace.
547
+ class StackFrame
548
+ include Google::Apis::Core::Hashable
549
+
550
+ # The filename of the file containing this frame.
551
+ # Corresponds to the JSON property `fileName`
552
+ # @return [String]
553
+ attr_accessor :file_name
554
+
555
+ # The version of the deployed source code.
556
+ # Corresponds to the JSON property `sourceVersion`
557
+ # @return [String]
558
+ attr_accessor :source_version
559
+
560
+ # Used when the function name is
561
+ # [mangled](http://www.avabodh.com/cxxin/namemangling.html). May be
562
+ # fully-qualified.
563
+ # Corresponds to the JSON property `originalFunctionName`
564
+ # @return [String]
565
+ attr_accessor :original_function_name
566
+
567
+ # The fully-qualified name that uniquely identifies this function or
568
+ # method.
569
+ # Corresponds to the JSON property `functionName`
570
+ # @return [String]
571
+ attr_accessor :function_name
572
+
573
+ # Line number of the frame.
574
+ # Corresponds to the JSON property `lineNumber`
575
+ # @return [String]
576
+ attr_accessor :line_number
577
+
578
+ # Binary module.
579
+ # Corresponds to the JSON property `loadModule`
580
+ # @return [Google::Apis::TracingV1::Module]
581
+ attr_accessor :load_module
582
+
583
+ # Column number is important in JavaScript (anonymous functions).
584
+ # May not be available in some languages.
585
+ # Corresponds to the JSON property `columnNumber`
586
+ # @return [String]
587
+ attr_accessor :column_number
588
+
589
+ def initialize(**args)
590
+ update!(**args)
591
+ end
592
+
593
+ # Update properties of this object
594
+ def update!(**args)
595
+ @file_name = args[:file_name] if args.key?(:file_name)
596
+ @source_version = args[:source_version] if args.key?(:source_version)
597
+ @original_function_name = args[:original_function_name] if args.key?(:original_function_name)
598
+ @function_name = args[:function_name] if args.key?(:function_name)
599
+ @line_number = args[:line_number] if args.key?(:line_number)
600
+ @load_module = args[:load_module] if args.key?(:load_module)
601
+ @column_number = args[:column_number] if args.key?(:column_number)
602
+ end
603
+ end
604
+
605
+ # A pointer from this span to another span in a different `Trace`. Used
606
+ # (for example) in batching operations, where a single batch handler
607
+ # processes multiple requests from different traces.
608
+ class Link
609
+ include Google::Apis::Core::Hashable
610
+
611
+ # The relationship of the current span relative to the linked span.
612
+ # Corresponds to the JSON property `type`
613
+ # @return [String]
614
+ attr_accessor :type
615
+
616
+ # The ID of the parent trace of the linked span.
617
+ # Corresponds to the JSON property `traceId`
618
+ # @return [String]
619
+ attr_accessor :trace_id
620
+
621
+ # The `id` of the linked span.
622
+ # Corresponds to the JSON property `spanId`
623
+ # @return [String]
624
+ attr_accessor :span_id
625
+
626
+ def initialize(**args)
627
+ update!(**args)
628
+ end
629
+
630
+ # Update properties of this object
631
+ def update!(**args)
632
+ @type = args[:type] if args.key?(:type)
633
+ @trace_id = args[:trace_id] if args.key?(:trace_id)
634
+ @span_id = args[:span_id] if args.key?(:span_id)
635
+ end
636
+ end
637
+
638
+ # Text annotation with a set of attributes.
639
+ class Annotation
640
+ include Google::Apis::Core::Hashable
641
+
642
+ # A user-supplied message describing the event.
643
+ # Corresponds to the JSON property `description`
644
+ # @return [String]
645
+ attr_accessor :description
646
+
647
+ # A set of attributes on the annotation.
648
+ # Corresponds to the JSON property `attributes`
649
+ # @return [Hash<String,Google::Apis::TracingV1::AttributeValue>]
650
+ attr_accessor :attributes
651
+
652
+ def initialize(**args)
653
+ update!(**args)
654
+ end
655
+
656
+ # Update properties of this object
657
+ def update!(**args)
658
+ @description = args[:description] if args.key?(:description)
659
+ @attributes = args[:attributes] if args.key?(:attributes)
660
+ end
661
+ end
662
+ end
663
+ end
664
+ end