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
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/bigquery/
26
26
  module BigqueryV2
27
27
  VERSION = 'V2'
28
- REVISION = '20170319'
28
+ REVISION = '20170324'
29
29
 
30
30
  # View and manage your data in Google BigQuery
31
31
  AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
@@ -59,6 +59,7 @@ module Google
59
59
  # BigQuery field identifier i.e. does not match [a-zA-Z][a-zA-Z0-9_]*, a valid
60
60
  # identifier must be provided as field_name.
61
61
  # Corresponds to the JSON property `qualifierEncoded`
62
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
62
63
  # @return [String]
63
64
  attr_accessor :qualifier_encoded
64
65
 
@@ -1246,8 +1247,8 @@ module Google
1246
1247
  # [Optional] Specifies a string that represents a null value in a CSV file. For
1247
1248
  # example, if you specify "\N", BigQuery interprets "\N" as a null value when
1248
1249
  # loading a CSV file. The default value is the empty string. If you set this
1249
- # property to a custom value, BigQuery still interprets the empty string as a
1250
- # null value for all data types except for STRING and BYTE. For STRING and BYTE
1250
+ # property to a custom value, BigQuery throws an error if an empty string is
1251
+ # present for all data types except for STRING and BYTE. For STRING and BYTE
1251
1252
  # columns, BigQuery interprets the empty string as an empty value.
1252
1253
  # Corresponds to the JSON property `nullMarker`
1253
1254
  # @return [String]
@@ -1370,8 +1371,10 @@ module Google
1370
1371
  class JobConfigurationQuery
1371
1372
  include Google::Apis::Core::Hashable
1372
1373
 
1373
- # If true, allows the query to produce arbitrarily large result tables at a
1374
- # slight cost in performance. Requires destinationTable to be set.
1374
+ # [Optional] If true and query uses legacy SQL dialect, allows the query to
1375
+ # produce arbitrarily large result tables at a slight cost in performance.
1376
+ # Requires destinationTable to be set. For standard SQL queries, this flag is
1377
+ # ignored and large results are always allowed.
1375
1378
  # Corresponds to the JSON property `allowLargeResults`
1376
1379
  # @return [Boolean]
1377
1380
  attr_accessor :allow_large_results
@@ -1399,8 +1402,10 @@ module Google
1399
1402
  # @return [Google::Apis::BigqueryV2::TableReference]
1400
1403
  attr_accessor :destination_table
1401
1404
 
1402
- # [Optional] Flattens all nested and repeated fields in the query results. The
1403
- # default value is true. allowLargeResults must be true if this is set to false.
1405
+ # [Optional] If true and query uses legacy SQL dialect, flattens all nested and
1406
+ # repeated fields in the query results. allowLargeResults must be true if this
1407
+ # is set to false. For standard SQL queries, this flag is ignored and results
1408
+ # are never flattened.
1404
1409
  # Corresponds to the JSON property `flattenResults`
1405
1410
  # @return [Boolean]
1406
1411
  attr_accessor :flatten_results
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/books/docs/v1/getting_started
26
26
  module BooksV1
27
27
  VERSION = 'V1'
28
- REVISION = '20161206'
28
+ REVISION = '20170313'
29
29
 
30
30
  # Manage your books
31
31
  AUTH_BOOKS = 'https://www.googleapis.com/auth/books'
@@ -274,6 +274,7 @@ module Google
274
274
 
275
275
  # Base64 encoded data for this annotation data.
276
276
  # Corresponds to the JSON property `encoded_data`
277
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
277
278
  # @return [String]
278
279
  attr_accessor :encoded_data
279
280
 
@@ -2579,6 +2580,11 @@ module Google
2579
2580
  # @return [Google::Apis::BooksV1::UserSettings::Notification::MoreFromSeries]
2580
2581
  attr_accessor :more_from_series
2581
2582
 
2583
+ #
2584
+ # Corresponds to the JSON property `rewardExpirations`
2585
+ # @return [Google::Apis::BooksV1::UserSettings::Notification::RewardExpirations]
2586
+ attr_accessor :reward_expirations
2587
+
2582
2588
  def initialize(**args)
2583
2589
  update!(**args)
2584
2590
  end
@@ -2587,6 +2593,7 @@ module Google
2587
2593
  def update!(**args)
2588
2594
  @more_from_authors = args[:more_from_authors] if args.key?(:more_from_authors)
2589
2595
  @more_from_series = args[:more_from_series] if args.key?(:more_from_series)
2596
+ @reward_expirations = args[:reward_expirations] if args.key?(:reward_expirations)
2590
2597
  end
2591
2598
 
2592
2599
  #
@@ -2626,6 +2633,25 @@ module Google
2626
2633
  @opted_state = args[:opted_state] if args.key?(:opted_state)
2627
2634
  end
2628
2635
  end
2636
+
2637
+ #
2638
+ class RewardExpirations
2639
+ include Google::Apis::Core::Hashable
2640
+
2641
+ #
2642
+ # Corresponds to the JSON property `opted_state`
2643
+ # @return [String]
2644
+ attr_accessor :opted_state
2645
+
2646
+ def initialize(**args)
2647
+ update!(**args)
2648
+ end
2649
+
2650
+ # Update properties of this object
2651
+ def update!(**args)
2652
+ @opted_state = args[:opted_state] if args.key?(:opted_state)
2653
+ end
2654
+ end
2629
2655
  end
2630
2656
  end
2631
2657
 
@@ -423,6 +423,12 @@ module Google
423
423
 
424
424
  include Google::Apis::Core::JsonObjectSupport
425
425
  end
426
+
427
+ class RewardExpirations
428
+ class Representation < Google::Apis::Core::JsonRepresentation; end
429
+
430
+ include Google::Apis::Core::JsonObjectSupport
431
+ end
426
432
 
427
433
  include Google::Apis::Core::JsonObjectSupport
428
434
  end
@@ -1368,6 +1374,8 @@ module Google
1368
1374
 
1369
1375
  property :more_from_series, as: 'moreFromSeries', class: Google::Apis::BooksV1::UserSettings::Notification::MoreFromSeries, decorator: Google::Apis::BooksV1::UserSettings::Notification::MoreFromSeries::Representation
1370
1376
 
1377
+ property :reward_expirations, as: 'rewardExpirations', class: Google::Apis::BooksV1::UserSettings::Notification::RewardExpirations, decorator: Google::Apis::BooksV1::UserSettings::Notification::RewardExpirations::Representation
1378
+
1371
1379
  end
1372
1380
 
1373
1381
  class MoreFromAuthors
@@ -1383,6 +1391,13 @@ module Google
1383
1391
  property :opted_state, as: 'opted_state'
1384
1392
  end
1385
1393
  end
1394
+
1395
+ class RewardExpirations
1396
+ # @private
1397
+ class Representation < Google::Apis::Core::JsonRepresentation
1398
+ property :opted_state, as: 'opted_state'
1399
+ end
1400
+ end
1386
1401
  end
1387
1402
  end
1388
1403
 
@@ -946,6 +946,8 @@ module Google
946
946
 
947
947
  # Inserts a new annotation.
948
948
  # @param [Google::Apis::BooksV1::Annotation] annotation_object
949
+ # @param [String] annotation_id
950
+ # The ID for the annotation to insert.
949
951
  # @param [String] country
950
952
  # ISO-3166-1 code to override the IP-based location.
951
953
  # @param [Boolean] show_only_summary_in_response
@@ -974,12 +976,13 @@ module Google
974
976
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
975
977
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
976
978
  # @raise [Google::Apis::AuthorizationError] Authorization is required
977
- def insert_my_library_annotation(annotation_object = nil, country: nil, show_only_summary_in_response: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
979
+ def insert_my_library_annotation(annotation_object = nil, annotation_id: nil, country: nil, show_only_summary_in_response: nil, source: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
978
980
  command = make_simple_command(:post, 'mylibrary/annotations', options)
979
981
  command.request_representation = Google::Apis::BooksV1::Annotation::Representation
980
982
  command.request_object = annotation_object
981
983
  command.response_representation = Google::Apis::BooksV1::Annotation::Representation
982
984
  command.response_class = Google::Apis::BooksV1::Annotation
985
+ command.query['annotationId'] = annotation_id unless annotation_id.nil?
983
986
  command.query['country'] = country unless country.nil?
984
987
  command.query['showOnlySummaryInResponse'] = show_only_summary_in_response unless show_only_summary_in_response.nil?
985
988
  command.query['source'] = source unless source.nil?
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/google-apps/calendar/firstapp
26
26
  module CalendarV3
27
27
  VERSION = 'V3'
28
- REVISION = '20170319'
28
+ REVISION = '20170328'
29
29
 
30
30
  # Manage your calendars
31
31
  AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/classroom/
26
26
  module ClassroomV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170322'
28
+ REVISION = '20170329'
29
29
 
30
30
  # View your Google Classroom class rosters
31
31
  AUTH_CLASSROOM_ROSTERS_READONLY = 'https://www.googleapis.com/auth/classroom.rosters.readonly'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/container-builder/docs/
26
26
  module CloudbuildV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170327'
28
+ REVISION = '20170330'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -22,136 +22,86 @@ module Google
22
22
  module Apis
23
23
  module CloudbuildV1
24
24
 
25
- # This resource represents a long-running operation that is the result of a
26
- # network API call.
27
- class Operation
25
+ # A generic empty message that you can re-use to avoid defining duplicated
26
+ # empty messages in your APIs. A typical example is to use it as the request
27
+ # or the response type of an API method. For instance:
28
+ # service Foo `
29
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
30
+ # `
31
+ # The JSON representation for `Empty` is empty JSON object ````.
32
+ class Empty
28
33
  include Google::Apis::Core::Hashable
29
34
 
30
- # The normal response of the operation in case of success. If the original
31
- # method returns no data on success, such as `Delete`, the response is
32
- # `google.protobuf.Empty`. If the original method is standard
33
- # `Get`/`Create`/`Update`, the response should be the resource. For other
34
- # methods, the response should have the type `XxxResponse`, where `Xxx`
35
- # is the original method name. For example, if the original method name
36
- # is `TakeSnapshot()`, the inferred response type is
37
- # `TakeSnapshotResponse`.
38
- # Corresponds to the JSON property `response`
39
- # @return [Hash<String,Object>]
40
- attr_accessor :response
41
-
42
- # The server-assigned name, which is only unique within the same service that
43
- # originally returns it. If you use the default HTTP mapping, the
44
- # `name` should have the format of `operations/some/unique/name`.
45
- # Corresponds to the JSON property `name`
46
- # @return [String]
47
- attr_accessor :name
48
-
49
- # The `Status` type defines a logical error model that is suitable for different
50
- # programming environments, including REST APIs and RPC APIs. It is used by
51
- # [gRPC](https://github.com/grpc). The error model is designed to be:
52
- # - Simple to use and understand for most users
53
- # - Flexible enough to meet unexpected needs
54
- # # Overview
55
- # The `Status` message contains three pieces of data: error code, error message,
56
- # and error details. The error code should be an enum value of
57
- # google.rpc.Code, but it may accept additional error codes if needed. The
58
- # error message should be a developer-facing English message that helps
59
- # developers *understand* and *resolve* the error. If a localized user-facing
60
- # error message is needed, put the localized message in the error details or
61
- # localize it in the client. The optional error details may contain arbitrary
62
- # information about the error. There is a predefined set of error detail types
63
- # in the package `google.rpc` which can be used for common error conditions.
64
- # # Language mapping
65
- # The `Status` message is the logical representation of the error model, but it
66
- # is not necessarily the actual wire format. When the `Status` message is
67
- # exposed in different client libraries and different wire protocols, it can be
68
- # mapped differently. For example, it will likely be mapped to some exceptions
69
- # in Java, but more likely mapped to some error codes in C.
70
- # # Other uses
71
- # The error model and the `Status` message can be used in a variety of
72
- # environments, either with or without APIs, to provide a
73
- # consistent developer experience across different environments.
74
- # Example uses of this error model include:
75
- # - Partial errors. If a service needs to return partial errors to the client,
76
- # it may embed the `Status` in the normal response to indicate the partial
77
- # errors.
78
- # - Workflow errors. A typical workflow has multiple steps. Each step may
79
- # have a `Status` message for error reporting purpose.
80
- # - Batch operations. If a client uses batch request and batch response, the
81
- # `Status` message should be used directly inside batch response, one for
82
- # each error sub-response.
83
- # - Asynchronous operations. If an API call embeds asynchronous operation
84
- # results in its response, the status of those operations should be
85
- # represented directly using the `Status` message.
86
- # - Logging. If some API errors are stored in logs, the message `Status` could
87
- # be used directly after any stripping needed for security/privacy reasons.
88
- # Corresponds to the JSON property `error`
89
- # @return [Google::Apis::CloudbuildV1::Status]
90
- attr_accessor :error
91
-
92
- # Service-specific metadata associated with the operation. It typically
93
- # contains progress information and common metadata such as create time.
94
- # Some services might not provide such metadata. Any method that returns a
95
- # long-running operation should document the metadata type, if any.
96
- # Corresponds to the JSON property `metadata`
97
- # @return [Hash<String,Object>]
98
- attr_accessor :metadata
99
-
100
- # If the value is `false`, it means the operation is still in progress.
101
- # If true, the operation is completed, and either `error` or `response` is
102
- # available.
103
- # Corresponds to the JSON property `done`
104
- # @return [Boolean]
105
- attr_accessor :done
106
- alias_method :done?, :done
107
-
108
35
  def initialize(**args)
109
36
  update!(**args)
110
37
  end
111
38
 
112
39
  # Update properties of this object
113
40
  def update!(**args)
114
- @response = args[:response] if args.key?(:response)
115
- @name = args[:name] if args.key?(:name)
116
- @error = args[:error] if args.key?(:error)
117
- @metadata = args[:metadata] if args.key?(:metadata)
118
- @done = args[:done] if args.key?(:done)
119
41
  end
120
42
  end
121
43
 
122
- # Response containing existing BuildTriggers.
123
- class ListBuildTriggersResponse
44
+ # Configuration for an automated build in response to source repository
45
+ # changes.
46
+ class BuildTrigger
124
47
  include Google::Apis::Core::Hashable
125
48
 
126
- # BuildTriggers for the project, sorted by create_time descending.
127
- # Corresponds to the JSON property `triggers`
128
- # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
129
- attr_accessor :triggers
49
+ # If true, the trigger will never result in a build.
50
+ # Corresponds to the JSON property `disabled`
51
+ # @return [Boolean]
52
+ attr_accessor :disabled
53
+ alias_method :disabled?, :disabled
130
54
 
131
- def initialize(**args)
132
- update!(**args)
133
- end
55
+ # Time when the trigger was created.
56
+ # @OutputOnly
57
+ # Corresponds to the JSON property `createTime`
58
+ # @return [String]
59
+ attr_accessor :create_time
134
60
 
135
- # Update properties of this object
136
- def update!(**args)
137
- @triggers = args[:triggers] if args.key?(:triggers)
138
- end
139
- end
61
+ # RepoSource describes the location of the source in a Google Cloud Source
62
+ # Repository.
63
+ # Corresponds to the JSON property `triggerTemplate`
64
+ # @return [Google::Apis::CloudbuildV1::RepoSource]
65
+ attr_accessor :trigger_template
140
66
 
141
- # BuiltImage describes an image built by the pipeline.
142
- class BuiltImage
143
- include Google::Apis::Core::Hashable
67
+ # Path, from the source root, to a file whose contents is used for the
68
+ # template.
69
+ # Corresponds to the JSON property `filename`
70
+ # @return [String]
71
+ attr_accessor :filename
144
72
 
145
- # Name used to push the container image to Google Container Registry, as
146
- # presented to `docker push`.
147
- # Corresponds to the JSON property `name`
73
+ # Unique identifier of the trigger.
74
+ # @OutputOnly
75
+ # Corresponds to the JSON property `id`
148
76
  # @return [String]
149
- attr_accessor :name
77
+ attr_accessor :id
150
78
 
151
- # Docker Registry 2.0 digest.
152
- # Corresponds to the JSON property `digest`
79
+ # A build resource in the Container Builder API.
80
+ # At a high level, a Build describes where to find source code, how to build
81
+ # it (for example, the builder image to run on the source), and what tag to
82
+ # apply to the built image when it is pushed to Google Container Registry.
83
+ # Fields can include the following variables which will be expanded when the
84
+ # build is created:
85
+ # - $PROJECT_ID: the project ID of the build.
86
+ # - $BUILD_ID: the autogenerated ID of the build.
87
+ # - $REPO_NAME: the source repository name specified by RepoSource.
88
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
89
+ # - $TAG_NAME: the tag name specified by RepoSource.
90
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
91
+ # resolved from the specified branch or tag.
92
+ # Corresponds to the JSON property `build`
93
+ # @return [Google::Apis::CloudbuildV1::Build]
94
+ attr_accessor :build
95
+
96
+ # Substitutions data for Build resource.
97
+ # Corresponds to the JSON property `substitutions`
98
+ # @return [Hash<String,String>]
99
+ attr_accessor :substitutions
100
+
101
+ # Human-readable description of this trigger.
102
+ # Corresponds to the JSON property `description`
153
103
  # @return [String]
154
- attr_accessor :digest
104
+ attr_accessor :description
155
105
 
156
106
  def initialize(**args)
157
107
  update!(**args)
@@ -159,41 +109,148 @@ module Google
159
109
 
160
110
  # Update properties of this object
161
111
  def update!(**args)
162
- @name = args[:name] if args.key?(:name)
163
- @digest = args[:digest] if args.key?(:digest)
112
+ @disabled = args[:disabled] if args.key?(:disabled)
113
+ @create_time = args[:create_time] if args.key?(:create_time)
114
+ @trigger_template = args[:trigger_template] if args.key?(:trigger_template)
115
+ @filename = args[:filename] if args.key?(:filename)
116
+ @id = args[:id] if args.key?(:id)
117
+ @build = args[:build] if args.key?(:build)
118
+ @substitutions = args[:substitutions] if args.key?(:substitutions)
119
+ @description = args[:description] if args.key?(:description)
164
120
  end
165
121
  end
166
122
 
167
- # RepoSource describes the location of the source in a Google Cloud Source
168
- # Repository.
169
- class RepoSource
123
+ # A build resource in the Container Builder API.
124
+ # At a high level, a Build describes where to find source code, how to build
125
+ # it (for example, the builder image to run on the source), and what tag to
126
+ # apply to the built image when it is pushed to Google Container Registry.
127
+ # Fields can include the following variables which will be expanded when the
128
+ # build is created:
129
+ # - $PROJECT_ID: the project ID of the build.
130
+ # - $BUILD_ID: the autogenerated ID of the build.
131
+ # - $REPO_NAME: the source repository name specified by RepoSource.
132
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
133
+ # - $TAG_NAME: the tag name specified by RepoSource.
134
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
135
+ # resolved from the specified branch or tag.
136
+ class Build
170
137
  include Google::Apis::Core::Hashable
171
138
 
172
- # Name of the tag to build.
173
- # Corresponds to the JSON property `tagName`
139
+ # Optional arguments to enable specific features of builds.
140
+ # Corresponds to the JSON property `options`
141
+ # @return [Google::Apis::CloudbuildV1::BuildOptions]
142
+ attr_accessor :options
143
+
144
+ # Source describes the location of the source in a supported storage
145
+ # service.
146
+ # Corresponds to the JSON property `source`
147
+ # @return [Google::Apis::CloudbuildV1::Source]
148
+ attr_accessor :source
149
+
150
+ # Customer-readable message about the current status.
151
+ # @OutputOnly
152
+ # Corresponds to the JSON property `statusDetail`
174
153
  # @return [String]
175
- attr_accessor :tag_name
154
+ attr_accessor :status_detail
176
155
 
177
- # Explicit commit SHA to build.
178
- # Corresponds to the JSON property `commitSha`
156
+ # Status of the build.
157
+ # @OutputOnly
158
+ # Corresponds to the JSON property `status`
179
159
  # @return [String]
180
- attr_accessor :commit_sha
160
+ attr_accessor :status
181
161
 
182
- # ID of the project that owns the repo. If omitted, the project ID requesting
183
- # the build is assumed.
162
+ # Amount of time that this build should be allowed to run, to second
163
+ # granularity. If this amount of time elapses, work on the build will cease
164
+ # and the build status will be TIMEOUT.
165
+ # Default time is ten minutes.
166
+ # Corresponds to the JSON property `timeout`
167
+ # @return [String]
168
+ attr_accessor :timeout
169
+
170
+ # Google Cloud Storage bucket where logs should be written (see
171
+ # [Bucket Name
172
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
173
+ # ).
174
+ # Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
175
+ # Corresponds to the JSON property `logsBucket`
176
+ # @return [String]
177
+ attr_accessor :logs_bucket
178
+
179
+ # Results describes the artifacts created by the build pipeline.
180
+ # Corresponds to the JSON property `results`
181
+ # @return [Google::Apis::CloudbuildV1::Results]
182
+ attr_accessor :results
183
+
184
+ # Describes the operations to be performed on the workspace.
185
+ # Corresponds to the JSON property `steps`
186
+ # @return [Array<Google::Apis::CloudbuildV1::BuildStep>]
187
+ attr_accessor :steps
188
+
189
+ # The ID of the BuildTrigger that triggered this build, if it was
190
+ # triggered automatically.
191
+ # @OutputOnly
192
+ # Corresponds to the JSON property `buildTriggerId`
193
+ # @return [String]
194
+ attr_accessor :build_trigger_id
195
+
196
+ # Unique identifier of the build.
197
+ # @OutputOnly
198
+ # Corresponds to the JSON property `id`
199
+ # @return [String]
200
+ attr_accessor :id
201
+
202
+ # Time at which execution of the build was started.
203
+ # @OutputOnly
204
+ # Corresponds to the JSON property `startTime`
205
+ # @return [String]
206
+ attr_accessor :start_time
207
+
208
+ # Substitutions data for Build resource.
209
+ # Corresponds to the JSON property `substitutions`
210
+ # @return [Hash<String,String>]
211
+ attr_accessor :substitutions
212
+
213
+ # Time at which the request to create the build was received.
214
+ # @OutputOnly
215
+ # Corresponds to the JSON property `createTime`
216
+ # @return [String]
217
+ attr_accessor :create_time
218
+
219
+ # Provenance of the source. Ways to find the original source, or verify that
220
+ # some source was used for this build.
221
+ # Corresponds to the JSON property `sourceProvenance`
222
+ # @return [Google::Apis::CloudbuildV1::SourceProvenance]
223
+ attr_accessor :source_provenance
224
+
225
+ # A list of images to be pushed upon the successful completion of all build
226
+ # steps.
227
+ # The images will be pushed using the builder service account's credentials.
228
+ # The digests of the pushed images will be stored in the Build resource's
229
+ # results field.
230
+ # If any of the images fail to be pushed, the build is marked FAILURE.
231
+ # Corresponds to the JSON property `images`
232
+ # @return [Array<String>]
233
+ attr_accessor :images
234
+
235
+ # ID of the project.
236
+ # @OutputOnly.
184
237
  # Corresponds to the JSON property `projectId`
185
238
  # @return [String]
186
239
  attr_accessor :project_id
187
240
 
188
- # Name of the repo. If omitted, the name "default" is assumed.
189
- # Corresponds to the JSON property `repoName`
241
+ # Time at which execution of the build was finished.
242
+ # The difference between finish_time and start_time is the duration of the
243
+ # build's execution.
244
+ # @OutputOnly
245
+ # Corresponds to the JSON property `finishTime`
190
246
  # @return [String]
191
- attr_accessor :repo_name
247
+ attr_accessor :finish_time
192
248
 
193
- # Name of the branch to build.
194
- # Corresponds to the JSON property `branchName`
249
+ # URL to logs for this build in Google Cloud Logging.
250
+ # @OutputOnly
251
+ # Corresponds to the JSON property `logUrl`
195
252
  # @return [String]
196
- attr_accessor :branch_name
253
+ attr_accessor :log_url
197
254
 
198
255
  def initialize(**args)
199
256
  update!(**args)
@@ -201,103 +258,53 @@ module Google
201
258
 
202
259
  # Update properties of this object
203
260
  def update!(**args)
204
- @tag_name = args[:tag_name] if args.key?(:tag_name)
205
- @commit_sha = args[:commit_sha] if args.key?(:commit_sha)
261
+ @options = args[:options] if args.key?(:options)
262
+ @source = args[:source] if args.key?(:source)
263
+ @status_detail = args[:status_detail] if args.key?(:status_detail)
264
+ @status = args[:status] if args.key?(:status)
265
+ @timeout = args[:timeout] if args.key?(:timeout)
266
+ @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
267
+ @results = args[:results] if args.key?(:results)
268
+ @steps = args[:steps] if args.key?(:steps)
269
+ @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
270
+ @id = args[:id] if args.key?(:id)
271
+ @start_time = args[:start_time] if args.key?(:start_time)
272
+ @substitutions = args[:substitutions] if args.key?(:substitutions)
273
+ @create_time = args[:create_time] if args.key?(:create_time)
274
+ @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
275
+ @images = args[:images] if args.key?(:images)
206
276
  @project_id = args[:project_id] if args.key?(:project_id)
207
- @repo_name = args[:repo_name] if args.key?(:repo_name)
208
- @branch_name = args[:branch_name] if args.key?(:branch_name)
277
+ @finish_time = args[:finish_time] if args.key?(:finish_time)
278
+ @log_url = args[:log_url] if args.key?(:log_url)
209
279
  end
210
280
  end
211
281
 
212
- # Container message for hash values.
213
- class HashProp
282
+ # Request to cancel an ongoing build.
283
+ class CancelBuildRequest
214
284
  include Google::Apis::Core::Hashable
215
285
 
216
- # The type of hash that was performed.
217
- # Corresponds to the JSON property `type`
218
- # @return [String]
219
- attr_accessor :type
220
-
221
- # The hash value.
222
- # Corresponds to the JSON property `value`
223
- # @return [String]
224
- attr_accessor :value
225
-
226
286
  def initialize(**args)
227
287
  update!(**args)
228
288
  end
229
289
 
230
290
  # Update properties of this object
231
291
  def update!(**args)
232
- @type = args[:type] if args.key?(:type)
233
- @value = args[:value] if args.key?(:value)
234
292
  end
235
293
  end
236
294
 
237
- # BuildStep describes a step to perform in the build pipeline.
238
- class BuildStep
295
+ # Response including listed builds.
296
+ class ListBuildsResponse
239
297
  include Google::Apis::Core::Hashable
240
298
 
241
- # Optional entrypoint to be used instead of the build step image's default
242
- # If unset, the image's default will be used.
243
- # Corresponds to the JSON property `entrypoint`
244
- # @return [String]
245
- attr_accessor :entrypoint
246
-
247
- # Optional unique identifier for this build step, used in wait_for to
248
- # reference this build step as a dependency.
249
- # Corresponds to the JSON property `id`
250
- # @return [String]
251
- attr_accessor :id
252
-
253
- # Working directory (relative to project source root) to use when running
254
- # this operation's container.
255
- # Corresponds to the JSON property `dir`
299
+ # Token to receive the next page of results.
300
+ # Corresponds to the JSON property `nextPageToken`
256
301
  # @return [String]
257
- attr_accessor :dir
258
-
259
- # A list of environment variable definitions to be used when running a step.
260
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
261
- # being given the value "VALUE".
262
- # Corresponds to the JSON property `env`
263
- # @return [Array<String>]
264
- attr_accessor :env
265
-
266
- # The ID(s) of the step(s) that this build step depends on.
267
- # This build step will not start until all the build steps in wait_for
268
- # have completed successfully. If wait_for is empty, this build step will
269
- # start when all previous build steps in the Build.Steps list have completed
270
- # successfully.
271
- # Corresponds to the JSON property `waitFor`
272
- # @return [Array<String>]
273
- attr_accessor :wait_for
274
-
275
- # A list of arguments that will be presented to the step when it is started.
276
- # If the image used to run the step's container has an entrypoint, these args
277
- # will be used as arguments to that entrypoint. If the image does not define
278
- # an entrypoint, the first element in args will be used as the entrypoint,
279
- # and the remainder will be used as arguments.
280
- # Corresponds to the JSON property `args`
281
- # @return [Array<String>]
282
- attr_accessor :args
302
+ attr_accessor :next_page_token
283
303
 
284
- # The name of the container image that will run this particular build step.
285
- # If the image is already available in the host's Docker daemon's cache, it
286
- # will be run directly. If not, the host will attempt to pull the image
287
- # first, using the builder service account's credentials if necessary.
288
- # The Docker daemon's cache will already have the latest versions of all of
289
- # the officially supported build steps
290
- # ([https://github.com/GoogleCloudPlatform/cloud-builders](https://github.com/
291
- # GoogleCloudPlatform/cloud-builders)).
292
- # The Docker daemon will also have cached many of the layers for some popular
293
- # images, like "ubuntu", "debian", but they will be refreshed at the time you
294
- # attempt to use them.
295
- # If you built an image in a previous build step, it will be stored in the
296
- # host's Docker daemon's cache and is available to use as the name for a
297
- # later build step.
298
- # Corresponds to the JSON property `name`
299
- # @return [String]
300
- attr_accessor :name
304
+ # Builds will be sorted by create_time, descending.
305
+ # Corresponds to the JSON property `builds`
306
+ # @return [Array<Google::Apis::CloudbuildV1::Build>]
307
+ attr_accessor :builds
301
308
 
302
309
  def initialize(**args)
303
310
  update!(**args)
@@ -305,25 +312,24 @@ module Google
305
312
 
306
313
  # Update properties of this object
307
314
  def update!(**args)
308
- @entrypoint = args[:entrypoint] if args.key?(:entrypoint)
309
- @id = args[:id] if args.key?(:id)
310
- @dir = args[:dir] if args.key?(:dir)
311
- @env = args[:env] if args.key?(:env)
312
- @wait_for = args[:wait_for] if args.key?(:wait_for)
313
- @args = args[:args] if args.key?(:args)
314
- @name = args[:name] if args.key?(:name)
315
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
316
+ @builds = args[:builds] if args.key?(:builds)
315
317
  end
316
318
  end
317
319
 
318
- # Container message for hashes of byte content of files, used in
319
- # SourceProvenance messages to verify integrity of source input to the build.
320
- class FileHashes
320
+ # The response message for Operations.ListOperations.
321
+ class ListOperationsResponse
321
322
  include Google::Apis::Core::Hashable
322
323
 
323
- # Collection of file hashes.
324
- # Corresponds to the JSON property `fileHash`
325
- # @return [Array<Google::Apis::CloudbuildV1::HashProp>]
326
- attr_accessor :file_hash
324
+ # The standard List next-page token.
325
+ # Corresponds to the JSON property `nextPageToken`
326
+ # @return [String]
327
+ attr_accessor :next_page_token
328
+
329
+ # A list of operations that matches the specified filter in the request.
330
+ # Corresponds to the JSON property `operations`
331
+ # @return [Array<Google::Apis::CloudbuildV1::Operation>]
332
+ attr_accessor :operations
327
333
 
328
334
  def initialize(**args)
329
335
  update!(**args)
@@ -331,69 +337,27 @@ module Google
331
337
 
332
338
  # Update properties of this object
333
339
  def update!(**args)
334
- @file_hash = args[:file_hash] if args.key?(:file_hash)
340
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
341
+ @operations = args[:operations] if args.key?(:operations)
335
342
  end
336
343
  end
337
344
 
338
- # The `Status` type defines a logical error model that is suitable for different
339
- # programming environments, including REST APIs and RPC APIs. It is used by
340
- # [gRPC](https://github.com/grpc). The error model is designed to be:
341
- # - Simple to use and understand for most users
342
- # - Flexible enough to meet unexpected needs
343
- # # Overview
344
- # The `Status` message contains three pieces of data: error code, error message,
345
- # and error details. The error code should be an enum value of
346
- # google.rpc.Code, but it may accept additional error codes if needed. The
347
- # error message should be a developer-facing English message that helps
348
- # developers *understand* and *resolve* the error. If a localized user-facing
349
- # error message is needed, put the localized message in the error details or
350
- # localize it in the client. The optional error details may contain arbitrary
351
- # information about the error. There is a predefined set of error detail types
352
- # in the package `google.rpc` which can be used for common error conditions.
353
- # # Language mapping
354
- # The `Status` message is the logical representation of the error model, but it
355
- # is not necessarily the actual wire format. When the `Status` message is
356
- # exposed in different client libraries and different wire protocols, it can be
357
- # mapped differently. For example, it will likely be mapped to some exceptions
358
- # in Java, but more likely mapped to some error codes in C.
359
- # # Other uses
360
- # The error model and the `Status` message can be used in a variety of
361
- # environments, either with or without APIs, to provide a
362
- # consistent developer experience across different environments.
363
- # Example uses of this error model include:
364
- # - Partial errors. If a service needs to return partial errors to the client,
365
- # it may embed the `Status` in the normal response to indicate the partial
366
- # errors.
367
- # - Workflow errors. A typical workflow has multiple steps. Each step may
368
- # have a `Status` message for error reporting purpose.
369
- # - Batch operations. If a client uses batch request and batch response, the
370
- # `Status` message should be used directly inside batch response, one for
371
- # each error sub-response.
372
- # - Asynchronous operations. If an API call embeds asynchronous operation
373
- # results in its response, the status of those operations should be
374
- # represented directly using the `Status` message.
375
- # - Logging. If some API errors are stored in logs, the message `Status` could
376
- # be used directly after any stripping needed for security/privacy reasons.
377
- class Status
378
- include Google::Apis::Core::Hashable
379
-
380
- # A list of messages that carry the error details. There will be a
381
- # common set of message types for APIs to use.
382
- # Corresponds to the JSON property `details`
383
- # @return [Array<Hash<String,Object>>]
384
- attr_accessor :details
385
-
386
- # The status code, which should be an enum value of google.rpc.Code.
387
- # Corresponds to the JSON property `code`
388
- # @return [Fixnum]
389
- attr_accessor :code
345
+ # Source describes the location of the source in a supported storage
346
+ # service.
347
+ class Source
348
+ include Google::Apis::Core::Hashable
390
349
 
391
- # A developer-facing error message, which should be in English. Any
392
- # user-facing error message should be localized and sent in the
393
- # google.rpc.Status.details field, or localized by the client.
394
- # Corresponds to the JSON property `message`
395
- # @return [String]
396
- attr_accessor :message
350
+ # StorageSource describes the location of the source in an archive file in
351
+ # Google Cloud Storage.
352
+ # Corresponds to the JSON property `storageSource`
353
+ # @return [Google::Apis::CloudbuildV1::StorageSource]
354
+ attr_accessor :storage_source
355
+
356
+ # RepoSource describes the location of the source in a Google Cloud Source
357
+ # Repository.
358
+ # Corresponds to the JSON property `repoSource`
359
+ # @return [Google::Apis::CloudbuildV1::RepoSource]
360
+ attr_accessor :repo_source
397
361
 
398
362
  def initialize(**args)
399
363
  update!(**args)
@@ -401,92 +365,61 @@ module Google
401
365
 
402
366
  # Update properties of this object
403
367
  def update!(**args)
404
- @details = args[:details] if args.key?(:details)
405
- @code = args[:code] if args.key?(:code)
406
- @message = args[:message] if args.key?(:message)
368
+ @storage_source = args[:storage_source] if args.key?(:storage_source)
369
+ @repo_source = args[:repo_source] if args.key?(:repo_source)
407
370
  end
408
371
  end
409
372
 
410
- # A generic empty message that you can re-use to avoid defining duplicated
411
- # empty messages in your APIs. A typical example is to use it as the request
412
- # or the response type of an API method. For instance:
413
- # service Foo `
414
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
415
- # `
416
- # The JSON representation for `Empty` is empty JSON object ````.
417
- class Empty
373
+ # Optional arguments to enable specific features of builds.
374
+ class BuildOptions
418
375
  include Google::Apis::Core::Hashable
419
376
 
377
+ # Requested verifiability options.
378
+ # Corresponds to the JSON property `requestedVerifyOption`
379
+ # @return [String]
380
+ attr_accessor :requested_verify_option
381
+
382
+ # Requested hash for SourceProvenance.
383
+ # Corresponds to the JSON property `sourceProvenanceHash`
384
+ # @return [Array<String>]
385
+ attr_accessor :source_provenance_hash
386
+
420
387
  def initialize(**args)
421
388
  update!(**args)
422
389
  end
423
390
 
424
391
  # Update properties of this object
425
392
  def update!(**args)
393
+ @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option)
394
+ @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash)
426
395
  end
427
396
  end
428
397
 
429
- # Configuration for an automated build in response to source repository
430
- # changes.
431
- class BuildTrigger
398
+ # StorageSource describes the location of the source in an archive file in
399
+ # Google Cloud Storage.
400
+ class StorageSource
432
401
  include Google::Apis::Core::Hashable
433
402
 
434
- # If true, the trigger will never result in a build.
435
- # Corresponds to the JSON property `disabled`
436
- # @return [Boolean]
437
- attr_accessor :disabled
438
- alias_method :disabled?, :disabled
439
-
440
- # Time when the trigger was created.
441
- # @OutputOnly
442
- # Corresponds to the JSON property `createTime`
443
- # @return [String]
444
- attr_accessor :create_time
445
-
446
- # RepoSource describes the location of the source in a Google Cloud Source
447
- # Repository.
448
- # Corresponds to the JSON property `triggerTemplate`
449
- # @return [Google::Apis::CloudbuildV1::RepoSource]
450
- attr_accessor :trigger_template
451
-
452
- # Path, from the source root, to a file whose contents is used for the
453
- # template.
454
- # Corresponds to the JSON property `filename`
403
+ # Google Cloud Storage bucket containing source (see
404
+ # [Bucket Name
405
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
406
+ # ).
407
+ # Corresponds to the JSON property `bucket`
455
408
  # @return [String]
456
- attr_accessor :filename
409
+ attr_accessor :bucket
457
410
 
458
- # Unique identifier of the trigger.
459
- # @OutputOnly
460
- # Corresponds to the JSON property `id`
411
+ # Google Cloud Storage object containing source.
412
+ # This object must be a gzipped archive file (.tar.gz) containing source to
413
+ # build.
414
+ # Corresponds to the JSON property `object`
461
415
  # @return [String]
462
- attr_accessor :id
463
-
464
- # A build resource in the Container Builder API.
465
- # At a high level, a Build describes where to find source code, how to build
466
- # it (for example, the builder image to run on the source), and what tag to
467
- # apply to the built image when it is pushed to Google Container Registry.
468
- # Fields can include the following variables which will be expanded when the
469
- # build is created:
470
- # - $PROJECT_ID: the project ID of the build.
471
- # - $BUILD_ID: the autogenerated ID of the build.
472
- # - $REPO_NAME: the source repository name specified by RepoSource.
473
- # - $BRANCH_NAME: the branch name specified by RepoSource.
474
- # - $TAG_NAME: the tag name specified by RepoSource.
475
- # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
476
- # resolved from the specified branch or tag.
477
- # Corresponds to the JSON property `build`
478
- # @return [Google::Apis::CloudbuildV1::Build]
479
- attr_accessor :build
480
-
481
- # Substitutions data for Build resource.
482
- # Corresponds to the JSON property `substitutions`
483
- # @return [Hash<String,String>]
484
- attr_accessor :substitutions
416
+ attr_accessor :object
485
417
 
486
- # Human-readable description of this trigger.
487
- # Corresponds to the JSON property `description`
418
+ # Google Cloud Storage generation for the object. If the generation is
419
+ # omitted, the latest generation will be used.
420
+ # Corresponds to the JSON property `generation`
488
421
  # @return [String]
489
- attr_accessor :description
422
+ attr_accessor :generation
490
423
 
491
424
  def initialize(**args)
492
425
  update!(**args)
@@ -494,148 +427,96 @@ module Google
494
427
 
495
428
  # Update properties of this object
496
429
  def update!(**args)
497
- @disabled = args[:disabled] if args.key?(:disabled)
498
- @create_time = args[:create_time] if args.key?(:create_time)
499
- @trigger_template = args[:trigger_template] if args.key?(:trigger_template)
500
- @filename = args[:filename] if args.key?(:filename)
501
- @id = args[:id] if args.key?(:id)
502
- @build = args[:build] if args.key?(:build)
503
- @substitutions = args[:substitutions] if args.key?(:substitutions)
504
- @description = args[:description] if args.key?(:description)
430
+ @bucket = args[:bucket] if args.key?(:bucket)
431
+ @object = args[:object] if args.key?(:object)
432
+ @generation = args[:generation] if args.key?(:generation)
505
433
  end
506
434
  end
507
435
 
508
- # A build resource in the Container Builder API.
509
- # At a high level, a Build describes where to find source code, how to build
510
- # it (for example, the builder image to run on the source), and what tag to
511
- # apply to the built image when it is pushed to Google Container Registry.
512
- # Fields can include the following variables which will be expanded when the
513
- # build is created:
514
- # - $PROJECT_ID: the project ID of the build.
515
- # - $BUILD_ID: the autogenerated ID of the build.
516
- # - $REPO_NAME: the source repository name specified by RepoSource.
517
- # - $BRANCH_NAME: the branch name specified by RepoSource.
518
- # - $TAG_NAME: the tag name specified by RepoSource.
519
- # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
520
- # resolved from the specified branch or tag.
521
- class Build
436
+ # Results describes the artifacts created by the build pipeline.
437
+ class Results
522
438
  include Google::Apis::Core::Hashable
523
439
 
524
- # Time at which the request to create the build was received.
525
- # @OutputOnly
526
- # Corresponds to the JSON property `createTime`
527
- # @return [String]
528
- attr_accessor :create_time
529
-
530
- # Provenance of the source. Ways to find the original source, or verify that
531
- # some source was used for this build.
532
- # Corresponds to the JSON property `sourceProvenance`
533
- # @return [Google::Apis::CloudbuildV1::SourceProvenance]
534
- attr_accessor :source_provenance
440
+ # List of build step digests, in order corresponding to build step indices.
441
+ # Corresponds to the JSON property `buildStepImages`
442
+ # @return [Array<String>]
443
+ attr_accessor :build_step_images
535
444
 
536
- # A list of images to be pushed upon the successful completion of all build
537
- # steps.
538
- # The images will be pushed using the builder service account's credentials.
539
- # The digests of the pushed images will be stored in the Build resource's
540
- # results field.
541
- # If any of the images fail to be pushed, the build is marked FAILURE.
445
+ # Images that were built as a part of the build.
542
446
  # Corresponds to the JSON property `images`
543
- # @return [Array<String>]
447
+ # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
544
448
  attr_accessor :images
545
449
 
546
- # ID of the project.
547
- # @OutputOnly.
548
- # Corresponds to the JSON property `projectId`
549
- # @return [String]
550
- attr_accessor :project_id
551
-
552
- # URL to logs for this build in Google Cloud Logging.
553
- # @OutputOnly
554
- # Corresponds to the JSON property `logUrl`
555
- # @return [String]
556
- attr_accessor :log_url
557
-
558
- # Time at which execution of the build was finished.
559
- # The difference between finish_time and start_time is the duration of the
560
- # build's execution.
561
- # @OutputOnly
562
- # Corresponds to the JSON property `finishTime`
563
- # @return [String]
564
- attr_accessor :finish_time
565
-
566
- # Optional arguments to enable specific features of builds.
567
- # Corresponds to the JSON property `options`
568
- # @return [Google::Apis::CloudbuildV1::BuildOptions]
569
- attr_accessor :options
570
-
571
- # Source describes the location of the source in a supported storage
572
- # service.
573
- # Corresponds to the JSON property `source`
574
- # @return [Google::Apis::CloudbuildV1::Source]
575
- attr_accessor :source
576
-
577
- # Amount of time that this build should be allowed to run, to second
578
- # granularity. If this amount of time elapses, work on the build will cease
579
- # and the build status will be TIMEOUT.
580
- # Default time is ten minutes.
581
- # Corresponds to the JSON property `timeout`
582
- # @return [String]
583
- attr_accessor :timeout
450
+ def initialize(**args)
451
+ update!(**args)
452
+ end
584
453
 
585
- # Status of the build.
586
- # @OutputOnly
587
- # Corresponds to the JSON property `status`
588
- # @return [String]
589
- attr_accessor :status
454
+ # Update properties of this object
455
+ def update!(**args)
456
+ @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
457
+ @images = args[:images] if args.key?(:images)
458
+ end
459
+ end
590
460
 
591
- # Customer-readable message about the current status.
592
- # @OutputOnly
593
- # Corresponds to the JSON property `statusDetail`
594
- # @return [String]
595
- attr_accessor :status_detail
461
+ # Metadata for build operations.
462
+ class BuildOperationMetadata
463
+ include Google::Apis::Core::Hashable
596
464
 
597
- # Results describes the artifacts created by the build pipeline.
598
- # Corresponds to the JSON property `results`
599
- # @return [Google::Apis::CloudbuildV1::Results]
600
- attr_accessor :results
465
+ # A build resource in the Container Builder API.
466
+ # At a high level, a Build describes where to find source code, how to build
467
+ # it (for example, the builder image to run on the source), and what tag to
468
+ # apply to the built image when it is pushed to Google Container Registry.
469
+ # Fields can include the following variables which will be expanded when the
470
+ # build is created:
471
+ # - $PROJECT_ID: the project ID of the build.
472
+ # - $BUILD_ID: the autogenerated ID of the build.
473
+ # - $REPO_NAME: the source repository name specified by RepoSource.
474
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
475
+ # - $TAG_NAME: the tag name specified by RepoSource.
476
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
477
+ # resolved from the specified branch or tag.
478
+ # Corresponds to the JSON property `build`
479
+ # @return [Google::Apis::CloudbuildV1::Build]
480
+ attr_accessor :build
601
481
 
602
- # Google Cloud Storage bucket where logs should be written (see
603
- # [Bucket Name
604
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
605
- # ).
606
- # Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
607
- # Corresponds to the JSON property `logsBucket`
608
- # @return [String]
609
- attr_accessor :logs_bucket
482
+ def initialize(**args)
483
+ update!(**args)
484
+ end
610
485
 
611
- # Describes the operations to be performed on the workspace.
612
- # Corresponds to the JSON property `steps`
613
- # @return [Array<Google::Apis::CloudbuildV1::BuildStep>]
614
- attr_accessor :steps
486
+ # Update properties of this object
487
+ def update!(**args)
488
+ @build = args[:build] if args.key?(:build)
489
+ end
490
+ end
615
491
 
616
- # The ID of the BuildTrigger that triggered this build, if it was
617
- # triggered automatically.
618
- # @OutputOnly
619
- # Corresponds to the JSON property `buildTriggerId`
620
- # @return [String]
621
- attr_accessor :build_trigger_id
492
+ # Provenance of the source. Ways to find the original source, or verify that
493
+ # some source was used for this build.
494
+ class SourceProvenance
495
+ include Google::Apis::Core::Hashable
622
496
 
623
- # Unique identifier of the build.
497
+ # Hash(es) of the build source, which can be used to verify that the original
498
+ # source integrity was maintained in the build. Note that FileHashes will
499
+ # only be populated if BuildOptions has requested a SourceProvenanceHash.
500
+ # The keys to this map are file paths used as build source and the values
501
+ # contain the hash values for those files.
502
+ # If the build source came in a single package such as a gzipped tarfile
503
+ # (.tar.gz), the FileHash will be for the single path to that file.
624
504
  # @OutputOnly
625
- # Corresponds to the JSON property `id`
626
- # @return [String]
627
- attr_accessor :id
505
+ # Corresponds to the JSON property `fileHashes`
506
+ # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
507
+ attr_accessor :file_hashes
628
508
 
629
- # Time at which execution of the build was started.
630
- # @OutputOnly
631
- # Corresponds to the JSON property `startTime`
632
- # @return [String]
633
- attr_accessor :start_time
509
+ # RepoSource describes the location of the source in a Google Cloud Source
510
+ # Repository.
511
+ # Corresponds to the JSON property `resolvedRepoSource`
512
+ # @return [Google::Apis::CloudbuildV1::RepoSource]
513
+ attr_accessor :resolved_repo_source
634
514
 
635
- # Substitutions data for Build resource.
636
- # Corresponds to the JSON property `substitutions`
637
- # @return [Hash<String,String>]
638
- attr_accessor :substitutions
515
+ # StorageSource describes the location of the source in an archive file in
516
+ # Google Cloud Storage.
517
+ # Corresponds to the JSON property `resolvedStorageSource`
518
+ # @return [Google::Apis::CloudbuildV1::StorageSource]
519
+ attr_accessor :resolved_storage_source
639
520
 
640
521
  def initialize(**args)
641
522
  update!(**args)
@@ -643,29 +524,14 @@ module Google
643
524
 
644
525
  # Update properties of this object
645
526
  def update!(**args)
646
- @create_time = args[:create_time] if args.key?(:create_time)
647
- @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
648
- @images = args[:images] if args.key?(:images)
649
- @project_id = args[:project_id] if args.key?(:project_id)
650
- @log_url = args[:log_url] if args.key?(:log_url)
651
- @finish_time = args[:finish_time] if args.key?(:finish_time)
652
- @options = args[:options] if args.key?(:options)
653
- @source = args[:source] if args.key?(:source)
654
- @timeout = args[:timeout] if args.key?(:timeout)
655
- @status = args[:status] if args.key?(:status)
656
- @status_detail = args[:status_detail] if args.key?(:status_detail)
657
- @results = args[:results] if args.key?(:results)
658
- @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
659
- @steps = args[:steps] if args.key?(:steps)
660
- @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
661
- @id = args[:id] if args.key?(:id)
662
- @start_time = args[:start_time] if args.key?(:start_time)
663
- @substitutions = args[:substitutions] if args.key?(:substitutions)
527
+ @file_hashes = args[:file_hashes] if args.key?(:file_hashes)
528
+ @resolved_repo_source = args[:resolved_repo_source] if args.key?(:resolved_repo_source)
529
+ @resolved_storage_source = args[:resolved_storage_source] if args.key?(:resolved_storage_source)
664
530
  end
665
531
  end
666
532
 
667
- # Request to cancel an ongoing build.
668
- class CancelBuildRequest
533
+ # The request message for Operations.CancelOperation.
534
+ class CancelOperationRequest
669
535
  include Google::Apis::Core::Hashable
670
536
 
671
537
  def initialize(**args)
@@ -677,19 +543,107 @@ module Google
677
543
  end
678
544
  end
679
545
 
680
- # Response including listed builds.
681
- class ListBuildsResponse
546
+ # Response containing existing BuildTriggers.
547
+ class ListBuildTriggersResponse
682
548
  include Google::Apis::Core::Hashable
683
549
 
684
- # Token to receive the next page of results.
685
- # Corresponds to the JSON property `nextPageToken`
550
+ # BuildTriggers for the project, sorted by create_time descending.
551
+ # Corresponds to the JSON property `triggers`
552
+ # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
553
+ attr_accessor :triggers
554
+
555
+ def initialize(**args)
556
+ update!(**args)
557
+ end
558
+
559
+ # Update properties of this object
560
+ def update!(**args)
561
+ @triggers = args[:triggers] if args.key?(:triggers)
562
+ end
563
+ end
564
+
565
+ # This resource represents a long-running operation that is the result of a
566
+ # network API call.
567
+ class Operation
568
+ include Google::Apis::Core::Hashable
569
+
570
+ # If the value is `false`, it means the operation is still in progress.
571
+ # If true, the operation is completed, and either `error` or `response` is
572
+ # available.
573
+ # Corresponds to the JSON property `done`
574
+ # @return [Boolean]
575
+ attr_accessor :done
576
+ alias_method :done?, :done
577
+
578
+ # The normal response of the operation in case of success. If the original
579
+ # method returns no data on success, such as `Delete`, the response is
580
+ # `google.protobuf.Empty`. If the original method is standard
581
+ # `Get`/`Create`/`Update`, the response should be the resource. For other
582
+ # methods, the response should have the type `XxxResponse`, where `Xxx`
583
+ # is the original method name. For example, if the original method name
584
+ # is `TakeSnapshot()`, the inferred response type is
585
+ # `TakeSnapshotResponse`.
586
+ # Corresponds to the JSON property `response`
587
+ # @return [Hash<String,Object>]
588
+ attr_accessor :response
589
+
590
+ # The server-assigned name, which is only unique within the same service that
591
+ # originally returns it. If you use the default HTTP mapping, the
592
+ # `name` should have the format of `operations/some/unique/name`.
593
+ # Corresponds to the JSON property `name`
686
594
  # @return [String]
687
- attr_accessor :next_page_token
595
+ attr_accessor :name
688
596
 
689
- # Builds will be sorted by create_time, descending.
690
- # Corresponds to the JSON property `builds`
691
- # @return [Array<Google::Apis::CloudbuildV1::Build>]
692
- attr_accessor :builds
597
+ # The `Status` type defines a logical error model that is suitable for different
598
+ # programming environments, including REST APIs and RPC APIs. It is used by
599
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
600
+ # - Simple to use and understand for most users
601
+ # - Flexible enough to meet unexpected needs
602
+ # # Overview
603
+ # The `Status` message contains three pieces of data: error code, error message,
604
+ # and error details. The error code should be an enum value of
605
+ # google.rpc.Code, but it may accept additional error codes if needed. The
606
+ # error message should be a developer-facing English message that helps
607
+ # developers *understand* and *resolve* the error. If a localized user-facing
608
+ # error message is needed, put the localized message in the error details or
609
+ # localize it in the client. The optional error details may contain arbitrary
610
+ # information about the error. There is a predefined set of error detail types
611
+ # in the package `google.rpc` which can be used for common error conditions.
612
+ # # Language mapping
613
+ # The `Status` message is the logical representation of the error model, but it
614
+ # is not necessarily the actual wire format. When the `Status` message is
615
+ # exposed in different client libraries and different wire protocols, it can be
616
+ # mapped differently. For example, it will likely be mapped to some exceptions
617
+ # in Java, but more likely mapped to some error codes in C.
618
+ # # Other uses
619
+ # The error model and the `Status` message can be used in a variety of
620
+ # environments, either with or without APIs, to provide a
621
+ # consistent developer experience across different environments.
622
+ # Example uses of this error model include:
623
+ # - Partial errors. If a service needs to return partial errors to the client,
624
+ # it may embed the `Status` in the normal response to indicate the partial
625
+ # errors.
626
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
627
+ # have a `Status` message for error reporting purpose.
628
+ # - Batch operations. If a client uses batch request and batch response, the
629
+ # `Status` message should be used directly inside batch response, one for
630
+ # each error sub-response.
631
+ # - Asynchronous operations. If an API call embeds asynchronous operation
632
+ # results in its response, the status of those operations should be
633
+ # represented directly using the `Status` message.
634
+ # - Logging. If some API errors are stored in logs, the message `Status` could
635
+ # be used directly after any stripping needed for security/privacy reasons.
636
+ # Corresponds to the JSON property `error`
637
+ # @return [Google::Apis::CloudbuildV1::Status]
638
+ attr_accessor :error
639
+
640
+ # Service-specific metadata associated with the operation. It typically
641
+ # contains progress information and common metadata such as create time.
642
+ # Some services might not provide such metadata. Any method that returns a
643
+ # long-running operation should document the metadata type, if any.
644
+ # Corresponds to the JSON property `metadata`
645
+ # @return [Hash<String,Object>]
646
+ attr_accessor :metadata
693
647
 
694
648
  def initialize(**args)
695
649
  update!(**args)
@@ -697,24 +651,28 @@ module Google
697
651
 
698
652
  # Update properties of this object
699
653
  def update!(**args)
700
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
701
- @builds = args[:builds] if args.key?(:builds)
654
+ @done = args[:done] if args.key?(:done)
655
+ @response = args[:response] if args.key?(:response)
656
+ @name = args[:name] if args.key?(:name)
657
+ @error = args[:error] if args.key?(:error)
658
+ @metadata = args[:metadata] if args.key?(:metadata)
702
659
  end
703
660
  end
704
661
 
705
- # The response message for Operations.ListOperations.
706
- class ListOperationsResponse
662
+ # BuiltImage describes an image built by the pipeline.
663
+ class BuiltImage
707
664
  include Google::Apis::Core::Hashable
708
665
 
709
- # The standard List next-page token.
710
- # Corresponds to the JSON property `nextPageToken`
666
+ # Name used to push the container image to Google Container Registry, as
667
+ # presented to `docker push`.
668
+ # Corresponds to the JSON property `name`
711
669
  # @return [String]
712
- attr_accessor :next_page_token
670
+ attr_accessor :name
713
671
 
714
- # A list of operations that matches the specified filter in the request.
715
- # Corresponds to the JSON property `operations`
716
- # @return [Array<Google::Apis::CloudbuildV1::Operation>]
717
- attr_accessor :operations
672
+ # Docker Registry 2.0 digest.
673
+ # Corresponds to the JSON property `digest`
674
+ # @return [String]
675
+ attr_accessor :digest
718
676
 
719
677
  def initialize(**args)
720
678
  update!(**args)
@@ -722,27 +680,41 @@ module Google
722
680
 
723
681
  # Update properties of this object
724
682
  def update!(**args)
725
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
726
- @operations = args[:operations] if args.key?(:operations)
683
+ @name = args[:name] if args.key?(:name)
684
+ @digest = args[:digest] if args.key?(:digest)
727
685
  end
728
686
  end
729
687
 
730
- # Source describes the location of the source in a supported storage
731
- # service.
732
- class Source
688
+ # RepoSource describes the location of the source in a Google Cloud Source
689
+ # Repository.
690
+ class RepoSource
733
691
  include Google::Apis::Core::Hashable
734
692
 
735
- # StorageSource describes the location of the source in an archive file in
736
- # Google Cloud Storage.
737
- # Corresponds to the JSON property `storageSource`
738
- # @return [Google::Apis::CloudbuildV1::StorageSource]
739
- attr_accessor :storage_source
693
+ # ID of the project that owns the repo. If omitted, the project ID requesting
694
+ # the build is assumed.
695
+ # Corresponds to the JSON property `projectId`
696
+ # @return [String]
697
+ attr_accessor :project_id
740
698
 
741
- # RepoSource describes the location of the source in a Google Cloud Source
742
- # Repository.
743
- # Corresponds to the JSON property `repoSource`
744
- # @return [Google::Apis::CloudbuildV1::RepoSource]
745
- attr_accessor :repo_source
699
+ # Name of the repo. If omitted, the name "default" is assumed.
700
+ # Corresponds to the JSON property `repoName`
701
+ # @return [String]
702
+ attr_accessor :repo_name
703
+
704
+ # Name of the branch to build.
705
+ # Corresponds to the JSON property `branchName`
706
+ # @return [String]
707
+ attr_accessor :branch_name
708
+
709
+ # Name of the tag to build.
710
+ # Corresponds to the JSON property `tagName`
711
+ # @return [String]
712
+ attr_accessor :tag_name
713
+
714
+ # Explicit commit SHA to build.
715
+ # Corresponds to the JSON property `commitSha`
716
+ # @return [String]
717
+ attr_accessor :commit_sha
746
718
 
747
719
  def initialize(**args)
748
720
  update!(**args)
@@ -750,61 +722,78 @@ module Google
750
722
 
751
723
  # Update properties of this object
752
724
  def update!(**args)
753
- @storage_source = args[:storage_source] if args.key?(:storage_source)
754
- @repo_source = args[:repo_source] if args.key?(:repo_source)
725
+ @project_id = args[:project_id] if args.key?(:project_id)
726
+ @repo_name = args[:repo_name] if args.key?(:repo_name)
727
+ @branch_name = args[:branch_name] if args.key?(:branch_name)
728
+ @tag_name = args[:tag_name] if args.key?(:tag_name)
729
+ @commit_sha = args[:commit_sha] if args.key?(:commit_sha)
755
730
  end
756
731
  end
757
732
 
758
- # Optional arguments to enable specific features of builds.
759
- class BuildOptions
733
+ # BuildStep describes a step to perform in the build pipeline.
734
+ class BuildStep
760
735
  include Google::Apis::Core::Hashable
761
736
 
762
- # Requested hash for SourceProvenance.
763
- # Corresponds to the JSON property `sourceProvenanceHash`
764
- # @return [Array<String>]
765
- attr_accessor :source_provenance_hash
766
-
767
- # Requested verifiability options.
768
- # Corresponds to the JSON property `requestedVerifyOption`
737
+ # Working directory (relative to project source root) to use when running
738
+ # this operation's container.
739
+ # Corresponds to the JSON property `dir`
769
740
  # @return [String]
770
- attr_accessor :requested_verify_option
741
+ attr_accessor :dir
771
742
 
772
- def initialize(**args)
773
- update!(**args)
774
- end
743
+ # A list of environment variable definitions to be used when running a step.
744
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
745
+ # being given the value "VALUE".
746
+ # Corresponds to the JSON property `env`
747
+ # @return [Array<String>]
748
+ attr_accessor :env
775
749
 
776
- # Update properties of this object
777
- def update!(**args)
778
- @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash)
779
- @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option)
780
- end
781
- end
750
+ # The ID(s) of the step(s) that this build step depends on.
751
+ # This build step will not start until all the build steps in wait_for
752
+ # have completed successfully. If wait_for is empty, this build step will
753
+ # start when all previous build steps in the Build.Steps list have completed
754
+ # successfully.
755
+ # Corresponds to the JSON property `waitFor`
756
+ # @return [Array<String>]
757
+ attr_accessor :wait_for
782
758
 
783
- # StorageSource describes the location of the source in an archive file in
784
- # Google Cloud Storage.
785
- class StorageSource
786
- include Google::Apis::Core::Hashable
759
+ # A list of arguments that will be presented to the step when it is started.
760
+ # If the image used to run the step's container has an entrypoint, these args
761
+ # will be used as arguments to that entrypoint. If the image does not define
762
+ # an entrypoint, the first element in args will be used as the entrypoint,
763
+ # and the remainder will be used as arguments.
764
+ # Corresponds to the JSON property `args`
765
+ # @return [Array<String>]
766
+ attr_accessor :args
787
767
 
788
- # Google Cloud Storage generation for the object. If the generation is
789
- # omitted, the latest generation will be used.
790
- # Corresponds to the JSON property `generation`
768
+ # The name of the container image that will run this particular build step.
769
+ # If the image is already available in the host's Docker daemon's cache, it
770
+ # will be run directly. If not, the host will attempt to pull the image
771
+ # first, using the builder service account's credentials if necessary.
772
+ # The Docker daemon's cache will already have the latest versions of all of
773
+ # the officially supported build steps
774
+ # ([https://github.com/GoogleCloudPlatform/cloud-builders](https://github.com/
775
+ # GoogleCloudPlatform/cloud-builders)).
776
+ # The Docker daemon will also have cached many of the layers for some popular
777
+ # images, like "ubuntu", "debian", but they will be refreshed at the time you
778
+ # attempt to use them.
779
+ # If you built an image in a previous build step, it will be stored in the
780
+ # host's Docker daemon's cache and is available to use as the name for a
781
+ # later build step.
782
+ # Corresponds to the JSON property `name`
791
783
  # @return [String]
792
- attr_accessor :generation
784
+ attr_accessor :name
793
785
 
794
- # Google Cloud Storage bucket containing source (see
795
- # [Bucket Name
796
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
797
- # ).
798
- # Corresponds to the JSON property `bucket`
786
+ # Optional entrypoint to be used instead of the build step image's default
787
+ # If unset, the image's default will be used.
788
+ # Corresponds to the JSON property `entrypoint`
799
789
  # @return [String]
800
- attr_accessor :bucket
790
+ attr_accessor :entrypoint
801
791
 
802
- # Google Cloud Storage object containing source.
803
- # This object must be a gzipped archive file (.tar.gz) containing source to
804
- # build.
805
- # Corresponds to the JSON property `object`
792
+ # Optional unique identifier for this build step, used in wait_for to
793
+ # reference this build step as a dependency.
794
+ # Corresponds to the JSON property `id`
806
795
  # @return [String]
807
- attr_accessor :object
796
+ attr_accessor :id
808
797
 
809
798
  def initialize(**args)
810
799
  update!(**args)
@@ -812,25 +801,30 @@ module Google
812
801
 
813
802
  # Update properties of this object
814
803
  def update!(**args)
815
- @generation = args[:generation] if args.key?(:generation)
816
- @bucket = args[:bucket] if args.key?(:bucket)
817
- @object = args[:object] if args.key?(:object)
804
+ @dir = args[:dir] if args.key?(:dir)
805
+ @env = args[:env] if args.key?(:env)
806
+ @wait_for = args[:wait_for] if args.key?(:wait_for)
807
+ @args = args[:args] if args.key?(:args)
808
+ @name = args[:name] if args.key?(:name)
809
+ @entrypoint = args[:entrypoint] if args.key?(:entrypoint)
810
+ @id = args[:id] if args.key?(:id)
818
811
  end
819
812
  end
820
813
 
821
- # Results describes the artifacts created by the build pipeline.
822
- class Results
814
+ # Container message for hash values.
815
+ class HashProp
823
816
  include Google::Apis::Core::Hashable
824
817
 
825
- # List of build step digests, in order corresponding to build step indices.
826
- # Corresponds to the JSON property `buildStepImages`
827
- # @return [Array<String>]
828
- attr_accessor :build_step_images
818
+ # The type of hash that was performed.
819
+ # Corresponds to the JSON property `type`
820
+ # @return [String]
821
+ attr_accessor :type
829
822
 
830
- # Images that were built as a part of the build.
831
- # Corresponds to the JSON property `images`
832
- # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
833
- attr_accessor :images
823
+ # The hash value.
824
+ # Corresponds to the JSON property `value`
825
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
826
+ # @return [String]
827
+ attr_accessor :value
834
828
 
835
829
  def initialize(**args)
836
830
  update!(**args)
@@ -838,31 +832,20 @@ module Google
838
832
 
839
833
  # Update properties of this object
840
834
  def update!(**args)
841
- @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
842
- @images = args[:images] if args.key?(:images)
835
+ @type = args[:type] if args.key?(:type)
836
+ @value = args[:value] if args.key?(:value)
843
837
  end
844
838
  end
845
839
 
846
- # Metadata for build operations.
847
- class BuildOperationMetadata
840
+ # Container message for hashes of byte content of files, used in
841
+ # SourceProvenance messages to verify integrity of source input to the build.
842
+ class FileHashes
848
843
  include Google::Apis::Core::Hashable
849
844
 
850
- # A build resource in the Container Builder API.
851
- # At a high level, a Build describes where to find source code, how to build
852
- # it (for example, the builder image to run on the source), and what tag to
853
- # apply to the built image when it is pushed to Google Container Registry.
854
- # Fields can include the following variables which will be expanded when the
855
- # build is created:
856
- # - $PROJECT_ID: the project ID of the build.
857
- # - $BUILD_ID: the autogenerated ID of the build.
858
- # - $REPO_NAME: the source repository name specified by RepoSource.
859
- # - $BRANCH_NAME: the branch name specified by RepoSource.
860
- # - $TAG_NAME: the tag name specified by RepoSource.
861
- # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
862
- # resolved from the specified branch or tag.
863
- # Corresponds to the JSON property `build`
864
- # @return [Google::Apis::CloudbuildV1::Build]
865
- attr_accessor :build
845
+ # Collection of file hashes.
846
+ # Corresponds to the JSON property `fileHash`
847
+ # @return [Array<Google::Apis::CloudbuildV1::HashProp>]
848
+ attr_accessor :file_hash
866
849
 
867
850
  def initialize(**args)
868
851
  update!(**args)
@@ -870,54 +853,69 @@ module Google
870
853
 
871
854
  # Update properties of this object
872
855
  def update!(**args)
873
- @build = args[:build] if args.key?(:build)
856
+ @file_hash = args[:file_hash] if args.key?(:file_hash)
874
857
  end
875
858
  end
876
859
 
877
- # Provenance of the source. Ways to find the original source, or verify that
878
- # some source was used for this build.
879
- class SourceProvenance
860
+ # The `Status` type defines a logical error model that is suitable for different
861
+ # programming environments, including REST APIs and RPC APIs. It is used by
862
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
863
+ # - Simple to use and understand for most users
864
+ # - Flexible enough to meet unexpected needs
865
+ # # Overview
866
+ # The `Status` message contains three pieces of data: error code, error message,
867
+ # and error details. The error code should be an enum value of
868
+ # google.rpc.Code, but it may accept additional error codes if needed. The
869
+ # error message should be a developer-facing English message that helps
870
+ # developers *understand* and *resolve* the error. If a localized user-facing
871
+ # error message is needed, put the localized message in the error details or
872
+ # localize it in the client. The optional error details may contain arbitrary
873
+ # information about the error. There is a predefined set of error detail types
874
+ # in the package `google.rpc` which can be used for common error conditions.
875
+ # # Language mapping
876
+ # The `Status` message is the logical representation of the error model, but it
877
+ # is not necessarily the actual wire format. When the `Status` message is
878
+ # exposed in different client libraries and different wire protocols, it can be
879
+ # mapped differently. For example, it will likely be mapped to some exceptions
880
+ # in Java, but more likely mapped to some error codes in C.
881
+ # # Other uses
882
+ # The error model and the `Status` message can be used in a variety of
883
+ # environments, either with or without APIs, to provide a
884
+ # consistent developer experience across different environments.
885
+ # Example uses of this error model include:
886
+ # - Partial errors. If a service needs to return partial errors to the client,
887
+ # it may embed the `Status` in the normal response to indicate the partial
888
+ # errors.
889
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
890
+ # have a `Status` message for error reporting purpose.
891
+ # - Batch operations. If a client uses batch request and batch response, the
892
+ # `Status` message should be used directly inside batch response, one for
893
+ # each error sub-response.
894
+ # - Asynchronous operations. If an API call embeds asynchronous operation
895
+ # results in its response, the status of those operations should be
896
+ # represented directly using the `Status` message.
897
+ # - Logging. If some API errors are stored in logs, the message `Status` could
898
+ # be used directly after any stripping needed for security/privacy reasons.
899
+ class Status
880
900
  include Google::Apis::Core::Hashable
881
901
 
882
- # Hash(es) of the build source, which can be used to verify that the original
883
- # source integrity was maintained in the build. Note that FileHashes will
884
- # only be populated if BuildOptions has requested a SourceProvenanceHash.
885
- # The keys to this map are file paths used as build source and the values
886
- # contain the hash values for those files.
887
- # If the build source came in a single package such as a gzipped tarfile
888
- # (.tar.gz), the FileHash will be for the single path to that file.
889
- # @OutputOnly
890
- # Corresponds to the JSON property `fileHashes`
891
- # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
892
- attr_accessor :file_hashes
893
-
894
- # RepoSource describes the location of the source in a Google Cloud Source
895
- # Repository.
896
- # Corresponds to the JSON property `resolvedRepoSource`
897
- # @return [Google::Apis::CloudbuildV1::RepoSource]
898
- attr_accessor :resolved_repo_source
899
-
900
- # StorageSource describes the location of the source in an archive file in
901
- # Google Cloud Storage.
902
- # Corresponds to the JSON property `resolvedStorageSource`
903
- # @return [Google::Apis::CloudbuildV1::StorageSource]
904
- attr_accessor :resolved_storage_source
905
-
906
- def initialize(**args)
907
- update!(**args)
908
- end
902
+ # The status code, which should be an enum value of google.rpc.Code.
903
+ # Corresponds to the JSON property `code`
904
+ # @return [Fixnum]
905
+ attr_accessor :code
909
906
 
910
- # Update properties of this object
911
- def update!(**args)
912
- @file_hashes = args[:file_hashes] if args.key?(:file_hashes)
913
- @resolved_repo_source = args[:resolved_repo_source] if args.key?(:resolved_repo_source)
914
- @resolved_storage_source = args[:resolved_storage_source] if args.key?(:resolved_storage_source)
915
- end
916
- end
907
+ # A developer-facing error message, which should be in English. Any
908
+ # user-facing error message should be localized and sent in the
909
+ # google.rpc.Status.details field, or localized by the client.
910
+ # Corresponds to the JSON property `message`
911
+ # @return [String]
912
+ attr_accessor :message
917
913
 
918
- # The request message for Operations.CancelOperation.
919
- class CancelOperationRequest
920
- include Google::Apis::Core::Hashable
914
+ # A list of messages that carry the error details. There will be a
915
+ # common set of message types for APIs to use.
916
+ # Corresponds to the JSON property `details`
917
+ # @return [Array<Hash<String,Object>>]
918
+ attr_accessor :details
921
919
 
922
920
  def initialize(**args)
923
921
  update!(**args)
@@ -925,6 +923,9 @@ module Google
925
923
 
926
924
  # Update properties of this object
927
925
  def update!(**args)
926
+ @code = args[:code] if args.key?(:code)
927
+ @message = args[:message] if args.key?(:message)
928
+ @details = args[:details] if args.key?(:details)
928
929
  end
929
930
  end
930
931
  end