google-api-client 0.10.2 → 0.10.3

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