google-api-client 0.9.23 → 0.9.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +1 -1
  3. data/api_names.yaml +2556 -0
  4. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  5. data/generated/google/apis/adsense_v1_4.rb +1 -1
  6. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  7. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  8. data/generated/google/apis/androidenterprise_v1/service.rb +0 -46
  9. data/generated/google/apis/appstate_v1.rb +1 -1
  10. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  11. data/generated/google/apis/cloudbuild_v1/classes.rb +578 -578
  12. data/generated/google/apis/cloudbuild_v1/representations.rb +113 -113
  13. data/generated/google/apis/cloudbuild_v1/service.rb +182 -182
  14. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  15. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  16. data/generated/google/apis/dfareporting_v2_7.rb +40 -0
  17. data/generated/google/apis/dfareporting_v2_7/classes.rb +11876 -0
  18. data/generated/google/apis/dfareporting_v2_7/representations.rb +4243 -0
  19. data/generated/google/apis/dfareporting_v2_7/service.rb +9095 -0
  20. data/generated/google/apis/dns_v1.rb +1 -1
  21. data/generated/google/apis/dns_v2beta1.rb +1 -1
  22. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  23. data/generated/google/apis/games_management_v1management.rb +1 -1
  24. data/generated/google/apis/games_v1.rb +1 -1
  25. data/generated/google/apis/logging_v2beta1/classes.rb +837 -837
  26. data/generated/google/apis/logging_v2beta1/representations.rb +165 -165
  27. data/generated/google/apis/logging_v2beta1/service.rb +208 -208
  28. data/generated/google/apis/monitoring_v3.rb +1 -1
  29. data/generated/google/apis/plus_domains_v1.rb +1 -1
  30. data/generated/google/apis/plus_v1.rb +1 -1
  31. data/generated/google/apis/sheets_v4.rb +3 -3
  32. data/generated/google/apis/sheets_v4/classes.rb +4203 -4203
  33. data/generated/google/apis/sheets_v4/representations.rb +835 -835
  34. data/generated/google/apis/sheets_v4/service.rb +195 -195
  35. data/generated/google/apis/slides_v1.rb +1 -1
  36. data/generated/google/apis/webmasters_v3.rb +1 -1
  37. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  38. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  39. data/lib/google/apis/version.rb +1 -1
  40. metadata +6 -2
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://developers.google.com/ad-exchange/buyer-rest/guides/client-access/
27
27
  module Adexchangebuyer2V2beta1
28
28
  VERSION = 'V2beta1'
29
- REVISION = '20170118'
29
+ REVISION = '20170123'
30
30
 
31
31
  # Manage your Ad Exchange buyer account configuration
32
32
  AUTH_ADEXCHANGE_BUYER = 'https://www.googleapis.com/auth/adexchange.buyer'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/adsense/management/
26
26
  module AdsenseV1_4
27
27
  VERSION = 'V1_4'
28
- REVISION = '20170118'
28
+ REVISION = '20170123'
29
29
 
30
30
  # View and manage your AdSense data
31
31
  AUTH_ADSENSE = 'https://www.googleapis.com/auth/adsense'
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://developers.google.com/adsense/host/
27
27
  module AdsensehostV4_1
28
28
  VERSION = 'V4_1'
29
- REVISION = '20170118'
29
+ REVISION = '20170123'
30
30
 
31
31
  # View and manage your AdSense host data and associated accounts
32
32
  AUTH_ADSENSEHOST = 'https://www.googleapis.com/auth/adsensehost'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/android/work/play/emm-api
26
26
  module AndroidenterpriseV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170111'
28
+ REVISION = '20170117'
29
29
 
30
30
  # Manage corporate Android devices
31
31
  AUTH_ANDROIDENTERPRISE = 'https://www.googleapis.com/auth/androidenterprise'
@@ -2214,52 +2214,6 @@ module Google
2214
2214
  execute_or_queue_command(command, &block)
2215
2215
  end
2216
2216
 
2217
- # This method has been deprecated. To programmatically approve applications, you
2218
- # must use the iframe mechanism via the generateApprovalUrl and approve
2219
- # methods of the Products resource. For more information, see the Play EMM API
2220
- # usage requirements.
2221
- # The updatePermissions method (deprecated) updates the set of Android app
2222
- # permissions for this app that have been accepted by the enterprise.
2223
- # @param [String] enterprise_id
2224
- # The ID of the enterprise.
2225
- # @param [String] product_id
2226
- # The ID of the product.
2227
- # @param [Google::Apis::AndroidenterpriseV1::ProductPermissions] product_permissions_object
2228
- # @param [String] fields
2229
- # Selector specifying which fields to include in a partial response.
2230
- # @param [String] quota_user
2231
- # Available to use for quota purposes for server-side applications. Can be any
2232
- # arbitrary string assigned to a user, but should not exceed 40 characters.
2233
- # Overrides userIp if both are provided.
2234
- # @param [String] user_ip
2235
- # IP address of the site where the request originates. Use this if you want to
2236
- # enforce per-user limits.
2237
- # @param [Google::Apis::RequestOptions] options
2238
- # Request-specific options
2239
- #
2240
- # @yield [result, err] Result & error if block supplied
2241
- # @yieldparam result [Google::Apis::AndroidenterpriseV1::ProductPermissions] parsed result object
2242
- # @yieldparam err [StandardError] error object if request failed
2243
- #
2244
- # @return [Google::Apis::AndroidenterpriseV1::ProductPermissions]
2245
- #
2246
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2247
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2248
- # @raise [Google::Apis::AuthorizationError] Authorization is required
2249
- def update_product_permissions(enterprise_id, product_id, product_permissions_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2250
- command = make_simple_command(:put, 'enterprises/{enterpriseId}/products/{productId}/permissions', options)
2251
- command.request_representation = Google::Apis::AndroidenterpriseV1::ProductPermissions::Representation
2252
- command.request_object = product_permissions_object
2253
- command.response_representation = Google::Apis::AndroidenterpriseV1::ProductPermissions::Representation
2254
- command.response_class = Google::Apis::AndroidenterpriseV1::ProductPermissions
2255
- command.params['enterpriseId'] = enterprise_id unless enterprise_id.nil?
2256
- command.params['productId'] = product_id unless product_id.nil?
2257
- command.query['fields'] = fields unless fields.nil?
2258
- command.query['quotaUser'] = quota_user unless quota_user.nil?
2259
- command.query['userIp'] = user_ip unless user_ip.nil?
2260
- execute_or_queue_command(command, &block)
2261
- end
2262
-
2263
2217
  # Removes and invalidates the specified credentials for the service account
2264
2218
  # associated with this enterprise. The calling service account must have been
2265
2219
  # retrieved by calling Enterprises.GetServiceAccount and must have been set as
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/games/services/web/api/states
26
26
  module AppstateV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170111'
28
+ REVISION = '20170119'
29
29
 
30
30
  # View and manage your data for this application
31
31
  AUTH_APPSTATE = 'https://www.googleapis.com/auth/appstate'
@@ -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 = '20170119'
28
+ REVISION = '20170124'
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,65 +22,19 @@ module Google
22
22
  module Apis
23
23
  module CloudbuildV1
24
24
 
25
- # The `Status` type defines a logical error model that is suitable for different
26
- # programming environments, including REST APIs and RPC APIs. It is used by
27
- # [gRPC](https://github.com/grpc). The error model is designed to be:
28
- # - Simple to use and understand for most users
29
- # - Flexible enough to meet unexpected needs
30
- # # Overview
31
- # The `Status` message contains three pieces of data: error code, error message,
32
- # and error details. The error code should be an enum value of
33
- # google.rpc.Code, but it may accept additional error codes if needed. The
34
- # error message should be a developer-facing English message that helps
35
- # developers *understand* and *resolve* the error. If a localized user-facing
36
- # error message is needed, put the localized message in the error details or
37
- # localize it in the client. The optional error details may contain arbitrary
38
- # information about the error. There is a predefined set of error detail types
39
- # in the package `google.rpc` which can be used for common error conditions.
40
- # # Language mapping
41
- # The `Status` message is the logical representation of the error model, but it
42
- # is not necessarily the actual wire format. When the `Status` message is
43
- # exposed in different client libraries and different wire protocols, it can be
44
- # mapped differently. For example, it will likely be mapped to some exceptions
45
- # in Java, but more likely mapped to some error codes in C.
46
- # # Other uses
47
- # The error model and the `Status` message can be used in a variety of
48
- # environments, either with or without APIs, to provide a
49
- # consistent developer experience across different environments.
50
- # Example uses of this error model include:
51
- # - Partial errors. If a service needs to return partial errors to the client,
52
- # it may embed the `Status` in the normal response to indicate the partial
53
- # errors.
54
- # - Workflow errors. A typical workflow has multiple steps. Each step may
55
- # have a `Status` message for error reporting purpose.
56
- # - Batch operations. If a client uses batch request and batch response, the
57
- # `Status` message should be used directly inside batch response, one for
58
- # each error sub-response.
59
- # - Asynchronous operations. If an API call embeds asynchronous operation
60
- # results in its response, the status of those operations should be
61
- # represented directly using the `Status` message.
62
- # - Logging. If some API errors are stored in logs, the message `Status` could
63
- # be used directly after any stripping needed for security/privacy reasons.
64
- class Status
25
+ # Response including listed builds.
26
+ class ListBuildsResponse
65
27
  include Google::Apis::Core::Hashable
66
28
 
67
- # The status code, which should be an enum value of google.rpc.Code.
68
- # Corresponds to the JSON property `code`
69
- # @return [Fixnum]
70
- attr_accessor :code
71
-
72
- # A list of messages that carry the error details. There will be a
73
- # common set of message types for APIs to use.
74
- # Corresponds to the JSON property `details`
75
- # @return [Array<Hash<String,Object>>]
76
- attr_accessor :details
77
-
78
- # A developer-facing error message, which should be in English. Any
79
- # user-facing error message should be localized and sent in the
80
- # google.rpc.Status.details field, or localized by the client.
81
- # Corresponds to the JSON property `message`
29
+ # Token to receive the next page of results.
30
+ # Corresponds to the JSON property `nextPageToken`
82
31
  # @return [String]
83
- attr_accessor :message
32
+ attr_accessor :next_page_token
33
+
34
+ # Builds will be sorted by create_time, descending.
35
+ # Corresponds to the JSON property `builds`
36
+ # @return [Array<Google::Apis::CloudbuildV1::Build>]
37
+ attr_accessor :builds
84
38
 
85
39
  def initialize(**args)
86
40
  update!(**args)
@@ -88,32 +42,24 @@ module Google
88
42
 
89
43
  # Update properties of this object
90
44
  def update!(**args)
91
- @code = args[:code] if args.key?(:code)
92
- @details = args[:details] if args.key?(:details)
93
- @message = args[:message] if args.key?(:message)
45
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
46
+ @builds = args[:builds] if args.key?(:builds)
94
47
  end
95
48
  end
96
49
 
97
- # Metadata for build operations.
98
- class BuildOperationMetadata
50
+ # The response message for Operations.ListOperations.
51
+ class ListOperationsResponse
99
52
  include Google::Apis::Core::Hashable
100
53
 
101
- # A build resource in the Container Builder API.
102
- # At a high level, a Build describes where to find source code, how to build
103
- # it (for example, the builder image to run on the source), and what tag to
104
- # apply to the built image when it is pushed to Google Container Registry.
105
- # Fields can include the following variables which will be expanded when the
106
- # build is created:
107
- # - $PROJECT_ID: the project ID of the build.
108
- # - $BUILD_ID: the autogenerated ID of the build.
109
- # - $REPO_NAME: the source repository name specified by RepoSource.
110
- # - $BRANCH_NAME: the branch name specified by RepoSource.
111
- # - $TAG_NAME: the tag name specified by RepoSource.
112
- # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
113
- # resolved from the specified branch or tag.
114
- # Corresponds to the JSON property `build`
115
- # @return [Google::Apis::CloudbuildV1::Build]
116
- attr_accessor :build
54
+ # The standard List next-page token.
55
+ # Corresponds to the JSON property `nextPageToken`
56
+ # @return [String]
57
+ attr_accessor :next_page_token
58
+
59
+ # A list of operations that matches the specified filter in the request.
60
+ # Corresponds to the JSON property `operations`
61
+ # @return [Array<Google::Apis::CloudbuildV1::Operation>]
62
+ attr_accessor :operations
117
63
 
118
64
  def initialize(**args)
119
65
  update!(**args)
@@ -121,7 +67,8 @@ module Google
121
67
 
122
68
  # Update properties of this object
123
69
  def update!(**args)
124
- @build = args[:build] if args.key?(:build)
70
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
71
+ @operations = args[:operations] if args.key?(:operations)
125
72
  end
126
73
  end
127
74
 
@@ -153,34 +100,19 @@ module Google
153
100
  end
154
101
  end
155
102
 
156
- # Provenance of the source. Ways to find the original source, or verify that
157
- # some source was used for this build.
158
- class SourceProvenance
103
+ # Optional arguments to enable specific features of builds.
104
+ class BuildOptions
159
105
  include Google::Apis::Core::Hashable
160
106
 
161
- # RepoSource describes the location of the source in a Google Cloud Source
162
- # Repository.
163
- # Corresponds to the JSON property `resolvedRepoSource`
164
- # @return [Google::Apis::CloudbuildV1::RepoSource]
165
- attr_accessor :resolved_repo_source
166
-
167
- # StorageSource describes the location of the source in an archive file in
168
- # Google Cloud Storage.
169
- # Corresponds to the JSON property `resolvedStorageSource`
170
- # @return [Google::Apis::CloudbuildV1::StorageSource]
171
- attr_accessor :resolved_storage_source
107
+ # Requested hash for SourceProvenance.
108
+ # Corresponds to the JSON property `sourceProvenanceHash`
109
+ # @return [Array<String>]
110
+ attr_accessor :source_provenance_hash
172
111
 
173
- # Hash(es) of the build source, which can be used to verify that the original
174
- # source integrity was maintained in the build. Note that FileHashes will
175
- # only be populated if BuildOptions has requested a SourceProvenanceHash.
176
- # The keys to this map are file paths used as build source and the values
177
- # contain the hash values for those files.
178
- # If the build source came in a single package such as a gzipped tarfile
179
- # (.tar.gz), the FileHash will be for the single path to that file.
180
- # @OutputOnly
181
- # Corresponds to the JSON property `fileHashes`
182
- # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
183
- attr_accessor :file_hashes
112
+ # Requested verifiability options.
113
+ # Corresponds to the JSON property `requestedVerifyOption`
114
+ # @return [String]
115
+ attr_accessor :requested_verify_option
184
116
 
185
117
  def initialize(**args)
186
118
  update!(**args)
@@ -188,94 +120,36 @@ module Google
188
120
 
189
121
  # Update properties of this object
190
122
  def update!(**args)
191
- @resolved_repo_source = args[:resolved_repo_source] if args.key?(:resolved_repo_source)
192
- @resolved_storage_source = args[:resolved_storage_source] if args.key?(:resolved_storage_source)
193
- @file_hashes = args[:file_hashes] if args.key?(:file_hashes)
123
+ @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash)
124
+ @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option)
194
125
  end
195
126
  end
196
127
 
197
- # This resource represents a long-running operation that is the result of a
198
- # network API call.
199
- class Operation
128
+ # StorageSource describes the location of the source in an archive file in
129
+ # Google Cloud Storage.
130
+ class StorageSource
200
131
  include Google::Apis::Core::Hashable
201
132
 
202
- # The `Status` type defines a logical error model that is suitable for different
203
- # programming environments, including REST APIs and RPC APIs. It is used by
204
- # [gRPC](https://github.com/grpc). The error model is designed to be:
205
- # - Simple to use and understand for most users
206
- # - Flexible enough to meet unexpected needs
207
- # # Overview
208
- # The `Status` message contains three pieces of data: error code, error message,
209
- # and error details. The error code should be an enum value of
210
- # google.rpc.Code, but it may accept additional error codes if needed. The
211
- # error message should be a developer-facing English message that helps
212
- # developers *understand* and *resolve* the error. If a localized user-facing
213
- # error message is needed, put the localized message in the error details or
214
- # localize it in the client. The optional error details may contain arbitrary
215
- # information about the error. There is a predefined set of error detail types
216
- # in the package `google.rpc` which can be used for common error conditions.
217
- # # Language mapping
218
- # The `Status` message is the logical representation of the error model, but it
219
- # is not necessarily the actual wire format. When the `Status` message is
220
- # exposed in different client libraries and different wire protocols, it can be
221
- # mapped differently. For example, it will likely be mapped to some exceptions
222
- # in Java, but more likely mapped to some error codes in C.
223
- # # Other uses
224
- # The error model and the `Status` message can be used in a variety of
225
- # environments, either with or without APIs, to provide a
226
- # consistent developer experience across different environments.
227
- # Example uses of this error model include:
228
- # - Partial errors. If a service needs to return partial errors to the client,
229
- # it may embed the `Status` in the normal response to indicate the partial
230
- # errors.
231
- # - Workflow errors. A typical workflow has multiple steps. Each step may
232
- # have a `Status` message for error reporting purpose.
233
- # - Batch operations. If a client uses batch request and batch response, the
234
- # `Status` message should be used directly inside batch response, one for
235
- # each error sub-response.
236
- # - Asynchronous operations. If an API call embeds asynchronous operation
237
- # results in its response, the status of those operations should be
238
- # represented directly using the `Status` message.
239
- # - Logging. If some API errors are stored in logs, the message `Status` could
240
- # be used directly after any stripping needed for security/privacy reasons.
241
- # Corresponds to the JSON property `error`
242
- # @return [Google::Apis::CloudbuildV1::Status]
243
- attr_accessor :error
244
-
245
- # If the value is `false`, it means the operation is still in progress.
246
- # If true, the operation is completed, and either `error` or `response` is
247
- # available.
248
- # Corresponds to the JSON property `done`
249
- # @return [Boolean]
250
- attr_accessor :done
251
- alias_method :done?, :done
252
-
253
- # Service-specific metadata associated with the operation. It typically
254
- # contains progress information and common metadata such as create time.
255
- # Some services might not provide such metadata. Any method that returns a
256
- # long-running operation should document the metadata type, if any.
257
- # Corresponds to the JSON property `metadata`
258
- # @return [Hash<String,Object>]
259
- attr_accessor :metadata
133
+ # Google Cloud Storage bucket containing source (see
134
+ # [Bucket Name
135
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
136
+ # ).
137
+ # Corresponds to the JSON property `bucket`
138
+ # @return [String]
139
+ attr_accessor :bucket
260
140
 
261
- # The normal response of the operation in case of success. If the original
262
- # method returns no data on success, such as `Delete`, the response is
263
- # `google.protobuf.Empty`. If the original method is standard
264
- # `Get`/`Create`/`Update`, the response should be the resource. For other
265
- # methods, the response should have the type `XxxResponse`, where `Xxx`
266
- # is the original method name. For example, if the original method name
267
- # is `TakeSnapshot()`, the inferred response type is
268
- # `TakeSnapshotResponse`.
269
- # Corresponds to the JSON property `response`
270
- # @return [Hash<String,Object>]
271
- attr_accessor :response
141
+ # Google Cloud Storage object containing source.
142
+ # This object must be a gzipped archive file (.tar.gz) containing source to
143
+ # build.
144
+ # Corresponds to the JSON property `object`
145
+ # @return [String]
146
+ attr_accessor :object
272
147
 
273
- # The server-assigned name, which is only unique within the same service that
274
- # originally returns it. If you use the default HTTP mapping, the
275
- # `name` should have the format of `operations/some/unique/name`.
276
- # Corresponds to the JSON property `name`
148
+ # Google Cloud Storage generation for the object. If the generation is
149
+ # omitted, the latest generation will be used.
150
+ # Corresponds to the JSON property `generation`
277
151
  # @return [String]
278
- attr_accessor :name
152
+ attr_accessor :generation
279
153
 
280
154
  def initialize(**args)
281
155
  update!(**args)
@@ -283,53 +157,40 @@ module Google
283
157
 
284
158
  # Update properties of this object
285
159
  def update!(**args)
286
- @error = args[:error] if args.key?(:error)
287
- @done = args[:done] if args.key?(:done)
288
- @metadata = args[:metadata] if args.key?(:metadata)
289
- @response = args[:response] if args.key?(:response)
290
- @name = args[:name] if args.key?(:name)
160
+ @bucket = args[:bucket] if args.key?(:bucket)
161
+ @object = args[:object] if args.key?(:object)
162
+ @generation = args[:generation] if args.key?(:generation)
291
163
  end
292
164
  end
293
165
 
294
- # Configuration for an automated build in response to source repository
295
- # changes.
296
- class BuildTrigger
166
+ # Results describes the artifacts created by the build pipeline.
167
+ class Results
297
168
  include Google::Apis::Core::Hashable
298
169
 
299
- # Unique identifier of the trigger.
300
- # @OutputOnly
301
- # Corresponds to the JSON property `id`
302
- # @return [String]
303
- attr_accessor :id
304
-
305
- # Human-readable description of this trigger.
306
- # Corresponds to the JSON property `description`
307
- # @return [String]
308
- attr_accessor :description
170
+ # Images that were built as a part of the build.
171
+ # Corresponds to the JSON property `images`
172
+ # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
173
+ attr_accessor :images
309
174
 
310
- # RepoSource describes the location of the source in a Google Cloud Source
311
- # Repository.
312
- # Corresponds to the JSON property `triggerTemplate`
313
- # @return [Google::Apis::CloudbuildV1::RepoSource]
314
- attr_accessor :trigger_template
175
+ # List of build step digests, in order corresponding to build step indices.
176
+ # Corresponds to the JSON property `buildStepImages`
177
+ # @return [Array<String>]
178
+ attr_accessor :build_step_images
315
179
 
316
- # If true, the trigger will never result in a build.
317
- # Corresponds to the JSON property `disabled`
318
- # @return [Boolean]
319
- attr_accessor :disabled
320
- alias_method :disabled?, :disabled
180
+ def initialize(**args)
181
+ update!(**args)
182
+ end
321
183
 
322
- # Time when the trigger was created.
323
- # @OutputOnly
324
- # Corresponds to the JSON property `createTime`
325
- # @return [String]
326
- attr_accessor :create_time
184
+ # Update properties of this object
185
+ def update!(**args)
186
+ @images = args[:images] if args.key?(:images)
187
+ @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
188
+ end
189
+ end
327
190
 
328
- # Path, from the source root, to a file whose contents is used for the
329
- # template.
330
- # Corresponds to the JSON property `filename`
331
- # @return [String]
332
- attr_accessor :filename
191
+ # Metadata for build operations.
192
+ class BuildOperationMetadata
193
+ include Google::Apis::Core::Hashable
333
194
 
334
195
  # A build resource in the Container Builder API.
335
196
  # At a high level, a Build describes where to find source code, how to build
@@ -354,30 +215,38 @@ module Google
354
215
 
355
216
  # Update properties of this object
356
217
  def update!(**args)
357
- @id = args[:id] if args.key?(:id)
358
- @description = args[:description] if args.key?(:description)
359
- @trigger_template = args[:trigger_template] if args.key?(:trigger_template)
360
- @disabled = args[:disabled] if args.key?(:disabled)
361
- @create_time = args[:create_time] if args.key?(:create_time)
362
- @filename = args[:filename] if args.key?(:filename)
363
218
  @build = args[:build] if args.key?(:build)
364
219
  end
365
220
  end
366
221
 
367
- # BuiltImage describes an image built by the pipeline.
368
- class BuiltImage
222
+ # Provenance of the source. Ways to find the original source, or verify that
223
+ # some source was used for this build.
224
+ class SourceProvenance
369
225
  include Google::Apis::Core::Hashable
370
226
 
371
- # Docker Registry 2.0 digest.
372
- # Corresponds to the JSON property `digest`
373
- # @return [String]
374
- attr_accessor :digest
227
+ # Hash(es) of the build source, which can be used to verify that the original
228
+ # source integrity was maintained in the build. Note that FileHashes will
229
+ # only be populated if BuildOptions has requested a SourceProvenanceHash.
230
+ # The keys to this map are file paths used as build source and the values
231
+ # contain the hash values for those files.
232
+ # If the build source came in a single package such as a gzipped tarfile
233
+ # (.tar.gz), the FileHash will be for the single path to that file.
234
+ # @OutputOnly
235
+ # Corresponds to the JSON property `fileHashes`
236
+ # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
237
+ attr_accessor :file_hashes
375
238
 
376
- # Name used to push the container image to Google Container Registry, as
377
- # presented to `docker push`.
378
- # Corresponds to the JSON property `name`
379
- # @return [String]
380
- attr_accessor :name
239
+ # RepoSource describes the location of the source in a Google Cloud Source
240
+ # Repository.
241
+ # Corresponds to the JSON property `resolvedRepoSource`
242
+ # @return [Google::Apis::CloudbuildV1::RepoSource]
243
+ attr_accessor :resolved_repo_source
244
+
245
+ # StorageSource describes the location of the source in an archive file in
246
+ # Google Cloud Storage.
247
+ # Corresponds to the JSON property `resolvedStorageSource`
248
+ # @return [Google::Apis::CloudbuildV1::StorageSource]
249
+ attr_accessor :resolved_storage_source
381
250
 
382
251
  def initialize(**args)
383
252
  update!(**args)
@@ -385,74 +254,130 @@ module Google
385
254
 
386
255
  # Update properties of this object
387
256
  def update!(**args)
388
- @digest = args[:digest] if args.key?(:digest)
389
- @name = args[:name] if args.key?(:name)
257
+ @file_hashes = args[:file_hashes] if args.key?(:file_hashes)
258
+ @resolved_repo_source = args[:resolved_repo_source] if args.key?(:resolved_repo_source)
259
+ @resolved_storage_source = args[:resolved_storage_source] if args.key?(:resolved_storage_source)
390
260
  end
391
261
  end
392
262
 
393
- # Container message for hash values.
394
- class HashProp
263
+ # The request message for Operations.CancelOperation.
264
+ class CancelOperationRequest
395
265
  include Google::Apis::Core::Hashable
396
266
 
397
- # The hash value.
398
- # Corresponds to the JSON property `value`
399
- # @return [String]
400
- attr_accessor :value
401
-
402
- # The type of hash that was performed.
403
- # Corresponds to the JSON property `type`
404
- # @return [String]
405
- attr_accessor :type
406
-
407
267
  def initialize(**args)
408
268
  update!(**args)
409
269
  end
410
270
 
411
271
  # Update properties of this object
412
272
  def update!(**args)
413
- @value = args[:value] if args.key?(:value)
414
- @type = args[:type] if args.key?(:type)
415
273
  end
416
274
  end
417
275
 
418
- # The request message for Operations.CancelOperation.
419
- class CancelOperationRequest
276
+ # This resource represents a long-running operation that is the result of a
277
+ # network API call.
278
+ class Operation
420
279
  include Google::Apis::Core::Hashable
421
280
 
281
+ # If the value is `false`, it means the operation is still in progress.
282
+ # If true, the operation is completed, and either `error` or `response` is
283
+ # available.
284
+ # Corresponds to the JSON property `done`
285
+ # @return [Boolean]
286
+ attr_accessor :done
287
+ alias_method :done?, :done
288
+
289
+ # The normal response of the operation in case of success. If the original
290
+ # method returns no data on success, such as `Delete`, the response is
291
+ # `google.protobuf.Empty`. If the original method is standard
292
+ # `Get`/`Create`/`Update`, the response should be the resource. For other
293
+ # methods, the response should have the type `XxxResponse`, where `Xxx`
294
+ # is the original method name. For example, if the original method name
295
+ # is `TakeSnapshot()`, the inferred response type is
296
+ # `TakeSnapshotResponse`.
297
+ # Corresponds to the JSON property `response`
298
+ # @return [Hash<String,Object>]
299
+ attr_accessor :response
300
+
301
+ # The server-assigned name, which is only unique within the same service that
302
+ # originally returns it. If you use the default HTTP mapping, the
303
+ # `name` should have the format of `operations/some/unique/name`.
304
+ # Corresponds to the JSON property `name`
305
+ # @return [String]
306
+ attr_accessor :name
307
+
308
+ # The `Status` type defines a logical error model that is suitable for different
309
+ # programming environments, including REST APIs and RPC APIs. It is used by
310
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
311
+ # - Simple to use and understand for most users
312
+ # - Flexible enough to meet unexpected needs
313
+ # # Overview
314
+ # The `Status` message contains three pieces of data: error code, error message,
315
+ # and error details. The error code should be an enum value of
316
+ # google.rpc.Code, but it may accept additional error codes if needed. The
317
+ # error message should be a developer-facing English message that helps
318
+ # developers *understand* and *resolve* the error. If a localized user-facing
319
+ # error message is needed, put the localized message in the error details or
320
+ # localize it in the client. The optional error details may contain arbitrary
321
+ # information about the error. There is a predefined set of error detail types
322
+ # in the package `google.rpc` which can be used for common error conditions.
323
+ # # Language mapping
324
+ # The `Status` message is the logical representation of the error model, but it
325
+ # is not necessarily the actual wire format. When the `Status` message is
326
+ # exposed in different client libraries and different wire protocols, it can be
327
+ # mapped differently. For example, it will likely be mapped to some exceptions
328
+ # in Java, but more likely mapped to some error codes in C.
329
+ # # Other uses
330
+ # The error model and the `Status` message can be used in a variety of
331
+ # environments, either with or without APIs, to provide a
332
+ # consistent developer experience across different environments.
333
+ # Example uses of this error model include:
334
+ # - Partial errors. If a service needs to return partial errors to the client,
335
+ # it may embed the `Status` in the normal response to indicate the partial
336
+ # errors.
337
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
338
+ # have a `Status` message for error reporting purpose.
339
+ # - Batch operations. If a client uses batch request and batch response, the
340
+ # `Status` message should be used directly inside batch response, one for
341
+ # each error sub-response.
342
+ # - Asynchronous operations. If an API call embeds asynchronous operation
343
+ # results in its response, the status of those operations should be
344
+ # represented directly using the `Status` message.
345
+ # - Logging. If some API errors are stored in logs, the message `Status` could
346
+ # be used directly after any stripping needed for security/privacy reasons.
347
+ # Corresponds to the JSON property `error`
348
+ # @return [Google::Apis::CloudbuildV1::Status]
349
+ attr_accessor :error
350
+
351
+ # Service-specific metadata associated with the operation. It typically
352
+ # contains progress information and common metadata such as create time.
353
+ # Some services might not provide such metadata. Any method that returns a
354
+ # long-running operation should document the metadata type, if any.
355
+ # Corresponds to the JSON property `metadata`
356
+ # @return [Hash<String,Object>]
357
+ attr_accessor :metadata
358
+
422
359
  def initialize(**args)
423
360
  update!(**args)
424
361
  end
425
362
 
426
363
  # Update properties of this object
427
364
  def update!(**args)
365
+ @done = args[:done] if args.key?(:done)
366
+ @response = args[:response] if args.key?(:response)
367
+ @name = args[:name] if args.key?(:name)
368
+ @error = args[:error] if args.key?(:error)
369
+ @metadata = args[:metadata] if args.key?(:metadata)
428
370
  end
429
371
  end
430
372
 
431
- # StorageSource describes the location of the source in an archive file in
432
- # Google Cloud Storage.
433
- class StorageSource
373
+ # Response containing existing BuildTriggers.
374
+ class ListBuildTriggersResponse
434
375
  include Google::Apis::Core::Hashable
435
376
 
436
- # Google Cloud Storage bucket containing source (see
437
- # [Bucket Name
438
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
439
- # ).
440
- # Corresponds to the JSON property `bucket`
441
- # @return [String]
442
- attr_accessor :bucket
443
-
444
- # Google Cloud Storage generation for the object. If the generation is
445
- # omitted, the latest generation will be used.
446
- # Corresponds to the JSON property `generation`
447
- # @return [String]
448
- attr_accessor :generation
449
-
450
- # Google Cloud Storage object containing source.
451
- # This object must be a gzipped archive file (.tar.gz) containing source to
452
- # build.
453
- # Corresponds to the JSON property `object`
454
- # @return [String]
455
- attr_accessor :object
377
+ # BuildTriggers for the project, sorted by create_time descending.
378
+ # Corresponds to the JSON property `triggers`
379
+ # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
380
+ attr_accessor :triggers
456
381
 
457
382
  def initialize(**args)
458
383
  update!(**args)
@@ -460,25 +385,24 @@ module Google
460
385
 
461
386
  # Update properties of this object
462
387
  def update!(**args)
463
- @bucket = args[:bucket] if args.key?(:bucket)
464
- @generation = args[:generation] if args.key?(:generation)
465
- @object = args[:object] if args.key?(:object)
388
+ @triggers = args[:triggers] if args.key?(:triggers)
466
389
  end
467
390
  end
468
391
 
469
- # Results describes the artifacts created by the build pipeline.
470
- class Results
392
+ # BuiltImage describes an image built by the pipeline.
393
+ class BuiltImage
471
394
  include Google::Apis::Core::Hashable
472
395
 
473
- # Images that were built as a part of the build.
474
- # Corresponds to the JSON property `images`
475
- # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
476
- attr_accessor :images
396
+ # Name used to push the container image to Google Container Registry, as
397
+ # presented to `docker push`.
398
+ # Corresponds to the JSON property `name`
399
+ # @return [String]
400
+ attr_accessor :name
477
401
 
478
- # List of build step digests, in order corresponding to build step indices.
479
- # Corresponds to the JSON property `buildStepImages`
480
- # @return [Array<String>]
481
- attr_accessor :build_step_images
402
+ # Docker Registry 2.0 digest.
403
+ # Corresponds to the JSON property `digest`
404
+ # @return [String]
405
+ attr_accessor :digest
482
406
 
483
407
  def initialize(**args)
484
408
  update!(**args)
@@ -486,137 +410,74 @@ module Google
486
410
 
487
411
  # Update properties of this object
488
412
  def update!(**args)
489
- @images = args[:images] if args.key?(:images)
490
- @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
413
+ @name = args[:name] if args.key?(:name)
414
+ @digest = args[:digest] if args.key?(:digest)
491
415
  end
492
416
  end
493
417
 
494
- # A build resource in the Container Builder API.
495
- # At a high level, a Build describes where to find source code, how to build
496
- # it (for example, the builder image to run on the source), and what tag to
497
- # apply to the built image when it is pushed to Google Container Registry.
498
- # Fields can include the following variables which will be expanded when the
499
- # build is created:
500
- # - $PROJECT_ID: the project ID of the build.
501
- # - $BUILD_ID: the autogenerated ID of the build.
502
- # - $REPO_NAME: the source repository name specified by RepoSource.
503
- # - $BRANCH_NAME: the branch name specified by RepoSource.
504
- # - $TAG_NAME: the tag name specified by RepoSource.
505
- # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
506
- # resolved from the specified branch or tag.
507
- class Build
418
+ # BuildStep describes a step to perform in the build pipeline.
419
+ class BuildStep
508
420
  include Google::Apis::Core::Hashable
509
421
 
510
- # Unique identifier of the build.
511
- # @OutputOnly
512
- # Corresponds to the JSON property `id`
513
- # @return [String]
514
- attr_accessor :id
515
-
516
- # Provenance of the source. Ways to find the original source, or verify that
517
- # some source was used for this build.
518
- # Corresponds to the JSON property `sourceProvenance`
519
- # @return [Google::Apis::CloudbuildV1::SourceProvenance]
520
- attr_accessor :source_provenance
521
-
522
- # Results describes the artifacts created by the build pipeline.
523
- # Corresponds to the JSON property `results`
524
- # @return [Google::Apis::CloudbuildV1::Results]
525
- attr_accessor :results
526
-
527
- # Status of the build.
528
- # @OutputOnly
529
- # Corresponds to the JSON property `status`
530
- # @return [String]
531
- attr_accessor :status
532
-
533
- # Optional arguments to enable specific features of builds.
534
- # Corresponds to the JSON property `options`
535
- # @return [Google::Apis::CloudbuildV1::BuildOptions]
536
- attr_accessor :options
537
-
538
- # Time at which execution of the build was finished.
539
- # The difference between finish_time and start_time is the duration of the
540
- # build's execution.
541
- # @OutputOnly
542
- # Corresponds to the JSON property `finishTime`
543
- # @return [String]
544
- attr_accessor :finish_time
545
-
546
- # Amount of time that this build should be allowed to run, to second
547
- # granularity. If this amount of time elapses, work on the build will cease
548
- # and the build status will be TIMEOUT.
549
- # Default time is ten minutes.
550
- # Corresponds to the JSON property `timeout`
422
+ # The name of the container image that will run this particular build step.
423
+ # If the image is already available in the host's Docker daemon's cache, it
424
+ # will be run directly. If not, the host will attempt to pull the image
425
+ # first, using the builder service account's credentials if necessary.
426
+ # The Docker daemon's cache will already have the latest versions of all of
427
+ # the officially supported build steps
428
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
429
+ # will also have cached many of the layers for some popular images, like
430
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
431
+ # use them.
432
+ # If you built an image in a previous build step, it will be stored in the
433
+ # host's Docker daemon's cache and is available to use as the name for a
434
+ # later build step.
435
+ # Corresponds to the JSON property `name`
551
436
  # @return [String]
552
- attr_accessor :timeout
553
-
554
- # Describes the operations to be performed on the workspace.
555
- # Corresponds to the JSON property `steps`
556
- # @return [Array<Google::Apis::CloudbuildV1::BuildStep>]
557
- attr_accessor :steps
558
-
559
- # Source describes the location of the source in a supported storage
560
- # service.
561
- # Corresponds to the JSON property `source`
562
- # @return [Google::Apis::CloudbuildV1::Source]
563
- attr_accessor :source
437
+ attr_accessor :name
564
438
 
565
- # Time at which the request to create the build was received.
566
- # @OutputOnly
567
- # Corresponds to the JSON property `createTime`
439
+ # Optional entrypoint to be used instead of the build step image's default
440
+ # If unset, the image's default will be used.
441
+ # Corresponds to the JSON property `entrypoint`
568
442
  # @return [String]
569
- attr_accessor :create_time
443
+ attr_accessor :entrypoint
570
444
 
571
- # URL to logs for this build in Google Cloud Logging.
572
- # @OutputOnly
573
- # Corresponds to the JSON property `logUrl`
445
+ # Optional unique identifier for this build step, used in wait_for to
446
+ # reference this build step as a dependency.
447
+ # Corresponds to the JSON property `id`
574
448
  # @return [String]
575
- attr_accessor :log_url
449
+ attr_accessor :id
576
450
 
577
- # Customer-readable message about the current status.
578
- # @OutputOnly
579
- # Corresponds to the JSON property `statusDetail`
451
+ # Working directory (relative to project source root) to use when running
452
+ # this operation's container.
453
+ # Corresponds to the JSON property `dir`
580
454
  # @return [String]
581
- attr_accessor :status_detail
455
+ attr_accessor :dir
582
456
 
583
- # A list of images to be pushed upon the successful completion of all build
584
- # steps.
585
- # The images will be pushed using the builder service account's credentials.
586
- # The digests of the pushed images will be stored in the Build resource's
587
- # results field.
588
- # If any of the images fail to be pushed, the build is marked FAILURE.
589
- # Corresponds to the JSON property `images`
457
+ # The ID(s) of the step(s) that this build step depends on.
458
+ # This build step will not start until all the build steps in wait_for
459
+ # have completed successfully. If wait_for is empty, this build step will
460
+ # start when all previous build steps in the Build.Steps list have completed
461
+ # successfully.
462
+ # Corresponds to the JSON property `waitFor`
590
463
  # @return [Array<String>]
591
- attr_accessor :images
592
-
593
- # Time at which execution of the build was started.
594
- # @OutputOnly
595
- # Corresponds to the JSON property `startTime`
596
- # @return [String]
597
- attr_accessor :start_time
598
-
599
- # The ID of the BuildTrigger that triggered this build, if it was
600
- # triggered automatically.
601
- # @OutputOnly
602
- # Corresponds to the JSON property `buildTriggerId`
603
- # @return [String]
604
- attr_accessor :build_trigger_id
464
+ attr_accessor :wait_for
605
465
 
606
- # Google Cloud Storage bucket where logs should be written (see
607
- # [Bucket Name
608
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
609
- # ).
610
- # Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
611
- # Corresponds to the JSON property `logsBucket`
612
- # @return [String]
613
- attr_accessor :logs_bucket
466
+ # A list of environment variable definitions to be used when running a step.
467
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
468
+ # being given the value "VALUE".
469
+ # Corresponds to the JSON property `env`
470
+ # @return [Array<String>]
471
+ attr_accessor :env
614
472
 
615
- # ID of the project.
616
- # @OutputOnly.
617
- # Corresponds to the JSON property `projectId`
618
- # @return [String]
619
- attr_accessor :project_id
473
+ # A list of arguments that will be presented to the step when it is started.
474
+ # If the image used to run the step's container has an entrypoint, these args
475
+ # will be used as arguments to that entrypoint. If the image does not define
476
+ # an entrypoint, the first element in args will be used as the entrypoint,
477
+ # and the remainder will be used as arguments.
478
+ # Corresponds to the JSON property `args`
479
+ # @return [Array<String>]
480
+ attr_accessor :args
620
481
 
621
482
  def initialize(**args)
622
483
  update!(**args)
@@ -624,48 +485,46 @@ module Google
624
485
 
625
486
  # Update properties of this object
626
487
  def update!(**args)
488
+ @name = args[:name] if args.key?(:name)
489
+ @entrypoint = args[:entrypoint] if args.key?(:entrypoint)
627
490
  @id = args[:id] if args.key?(:id)
628
- @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
629
- @results = args[:results] if args.key?(:results)
630
- @status = args[:status] if args.key?(:status)
631
- @options = args[:options] if args.key?(:options)
632
- @finish_time = args[:finish_time] if args.key?(:finish_time)
633
- @timeout = args[:timeout] if args.key?(:timeout)
634
- @steps = args[:steps] if args.key?(:steps)
635
- @source = args[:source] if args.key?(:source)
636
- @create_time = args[:create_time] if args.key?(:create_time)
637
- @log_url = args[:log_url] if args.key?(:log_url)
638
- @status_detail = args[:status_detail] if args.key?(:status_detail)
639
- @images = args[:images] if args.key?(:images)
640
- @start_time = args[:start_time] if args.key?(:start_time)
641
- @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
642
- @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
643
- @project_id = args[:project_id] if args.key?(:project_id)
491
+ @dir = args[:dir] if args.key?(:dir)
492
+ @wait_for = args[:wait_for] if args.key?(:wait_for)
493
+ @env = args[:env] if args.key?(:env)
494
+ @args = args[:args] if args.key?(:args)
644
495
  end
645
496
  end
646
497
 
647
- # Response containing existing BuildTriggers.
648
- class ListBuildTriggersResponse
498
+ # RepoSource describes the location of the source in a Google Cloud Source
499
+ # Repository.
500
+ class RepoSource
649
501
  include Google::Apis::Core::Hashable
650
502
 
651
- # BuildTriggers for the project, sorted by create_time descending.
652
- # Corresponds to the JSON property `triggers`
653
- # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
654
- attr_accessor :triggers
503
+ # Name of the tag to build.
504
+ # Corresponds to the JSON property `tagName`
505
+ # @return [String]
506
+ attr_accessor :tag_name
655
507
 
656
- def initialize(**args)
657
- update!(**args)
658
- end
508
+ # Explicit commit SHA to build.
509
+ # Corresponds to the JSON property `commitSha`
510
+ # @return [String]
511
+ attr_accessor :commit_sha
659
512
 
660
- # Update properties of this object
661
- def update!(**args)
662
- @triggers = args[:triggers] if args.key?(:triggers)
663
- end
664
- end
513
+ # ID of the project that owns the repo. If omitted, the project ID requesting
514
+ # the build is assumed.
515
+ # Corresponds to the JSON property `projectId`
516
+ # @return [String]
517
+ attr_accessor :project_id
665
518
 
666
- # Request to cancel an ongoing build.
667
- class CancelBuildRequest
668
- include Google::Apis::Core::Hashable
519
+ # Name of the repo. If omitted, the name "default" is assumed.
520
+ # Corresponds to the JSON property `repoName`
521
+ # @return [String]
522
+ attr_accessor :repo_name
523
+
524
+ # Name of the branch to build.
525
+ # Corresponds to the JSON property `branchName`
526
+ # @return [String]
527
+ attr_accessor :branch_name
669
528
 
670
529
  def initialize(**args)
671
530
  update!(**args)
@@ -673,22 +532,27 @@ module Google
673
532
 
674
533
  # Update properties of this object
675
534
  def update!(**args)
535
+ @tag_name = args[:tag_name] if args.key?(:tag_name)
536
+ @commit_sha = args[:commit_sha] if args.key?(:commit_sha)
537
+ @project_id = args[:project_id] if args.key?(:project_id)
538
+ @repo_name = args[:repo_name] if args.key?(:repo_name)
539
+ @branch_name = args[:branch_name] if args.key?(:branch_name)
676
540
  end
677
541
  end
678
542
 
679
- # The response message for Operations.ListOperations.
680
- class ListOperationsResponse
543
+ # Container message for hash values.
544
+ class HashProp
681
545
  include Google::Apis::Core::Hashable
682
546
 
683
- # The standard List next-page token.
684
- # Corresponds to the JSON property `nextPageToken`
547
+ # The type of hash that was performed.
548
+ # Corresponds to the JSON property `type`
685
549
  # @return [String]
686
- attr_accessor :next_page_token
550
+ attr_accessor :type
687
551
 
688
- # A list of operations that matches the specified filter in the request.
689
- # Corresponds to the JSON property `operations`
690
- # @return [Array<Google::Apis::CloudbuildV1::Operation>]
691
- attr_accessor :operations
552
+ # The hash value.
553
+ # Corresponds to the JSON property `value`
554
+ # @return [String]
555
+ attr_accessor :value
692
556
 
693
557
  def initialize(**args)
694
558
  update!(**args)
@@ -696,8 +560,8 @@ module Google
696
560
 
697
561
  # Update properties of this object
698
562
  def update!(**args)
699
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
700
- @operations = args[:operations] if args.key?(:operations)
563
+ @type = args[:type] if args.key?(:type)
564
+ @value = args[:value] if args.key?(:value)
701
565
  end
702
566
  end
703
567
 
@@ -721,36 +585,87 @@ module Google
721
585
  end
722
586
  end
723
587
 
724
- # RepoSource describes the location of the source in a Google Cloud Source
725
- # Repository.
726
- class RepoSource
588
+ # The `Status` type defines a logical error model that is suitable for different
589
+ # programming environments, including REST APIs and RPC APIs. It is used by
590
+ # [gRPC](https://github.com/grpc). The error model is designed to be:
591
+ # - Simple to use and understand for most users
592
+ # - Flexible enough to meet unexpected needs
593
+ # # Overview
594
+ # The `Status` message contains three pieces of data: error code, error message,
595
+ # and error details. The error code should be an enum value of
596
+ # google.rpc.Code, but it may accept additional error codes if needed. The
597
+ # error message should be a developer-facing English message that helps
598
+ # developers *understand* and *resolve* the error. If a localized user-facing
599
+ # error message is needed, put the localized message in the error details or
600
+ # localize it in the client. The optional error details may contain arbitrary
601
+ # information about the error. There is a predefined set of error detail types
602
+ # in the package `google.rpc` which can be used for common error conditions.
603
+ # # Language mapping
604
+ # The `Status` message is the logical representation of the error model, but it
605
+ # is not necessarily the actual wire format. When the `Status` message is
606
+ # exposed in different client libraries and different wire protocols, it can be
607
+ # mapped differently. For example, it will likely be mapped to some exceptions
608
+ # in Java, but more likely mapped to some error codes in C.
609
+ # # Other uses
610
+ # The error model and the `Status` message can be used in a variety of
611
+ # environments, either with or without APIs, to provide a
612
+ # consistent developer experience across different environments.
613
+ # Example uses of this error model include:
614
+ # - Partial errors. If a service needs to return partial errors to the client,
615
+ # it may embed the `Status` in the normal response to indicate the partial
616
+ # errors.
617
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
618
+ # have a `Status` message for error reporting purpose.
619
+ # - Batch operations. If a client uses batch request and batch response, the
620
+ # `Status` message should be used directly inside batch response, one for
621
+ # each error sub-response.
622
+ # - Asynchronous operations. If an API call embeds asynchronous operation
623
+ # results in its response, the status of those operations should be
624
+ # represented directly using the `Status` message.
625
+ # - Logging. If some API errors are stored in logs, the message `Status` could
626
+ # be used directly after any stripping needed for security/privacy reasons.
627
+ class Status
727
628
  include Google::Apis::Core::Hashable
728
629
 
729
- # Name of the repo. If omitted, the name "default" is assumed.
730
- # Corresponds to the JSON property `repoName`
630
+ # A developer-facing error message, which should be in English. Any
631
+ # user-facing error message should be localized and sent in the
632
+ # google.rpc.Status.details field, or localized by the client.
633
+ # Corresponds to the JSON property `message`
731
634
  # @return [String]
732
- attr_accessor :repo_name
635
+ attr_accessor :message
733
636
 
734
- # Name of the tag to build.
735
- # Corresponds to the JSON property `tagName`
736
- # @return [String]
737
- attr_accessor :tag_name
637
+ # A list of messages that carry the error details. There will be a
638
+ # common set of message types for APIs to use.
639
+ # Corresponds to the JSON property `details`
640
+ # @return [Array<Hash<String,Object>>]
641
+ attr_accessor :details
738
642
 
739
- # ID of the project that owns the repo. If omitted, the project ID requesting
740
- # the build is assumed.
741
- # Corresponds to the JSON property `projectId`
742
- # @return [String]
743
- attr_accessor :project_id
643
+ # The status code, which should be an enum value of google.rpc.Code.
644
+ # Corresponds to the JSON property `code`
645
+ # @return [Fixnum]
646
+ attr_accessor :code
744
647
 
745
- # Name of the branch to build.
746
- # Corresponds to the JSON property `branchName`
747
- # @return [String]
748
- attr_accessor :branch_name
648
+ def initialize(**args)
649
+ update!(**args)
650
+ end
749
651
 
750
- # Explicit commit SHA to build.
751
- # Corresponds to the JSON property `commitSha`
752
- # @return [String]
753
- attr_accessor :commit_sha
652
+ # Update properties of this object
653
+ def update!(**args)
654
+ @message = args[:message] if args.key?(:message)
655
+ @details = args[:details] if args.key?(:details)
656
+ @code = args[:code] if args.key?(:code)
657
+ end
658
+ end
659
+
660
+ # A generic empty message that you can re-use to avoid defining duplicated
661
+ # empty messages in your APIs. A typical example is to use it as the request
662
+ # or the response type of an API method. For instance:
663
+ # service Foo `
664
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
665
+ # `
666
+ # The JSON representation for `Empty` is empty JSON object ````.
667
+ class Empty
668
+ include Google::Apis::Core::Hashable
754
669
 
755
670
  def initialize(**args)
756
671
  update!(**args)
@@ -758,77 +673,65 @@ module Google
758
673
 
759
674
  # Update properties of this object
760
675
  def update!(**args)
761
- @repo_name = args[:repo_name] if args.key?(:repo_name)
762
- @tag_name = args[:tag_name] if args.key?(:tag_name)
763
- @project_id = args[:project_id] if args.key?(:project_id)
764
- @branch_name = args[:branch_name] if args.key?(:branch_name)
765
- @commit_sha = args[:commit_sha] if args.key?(:commit_sha)
766
676
  end
767
677
  end
768
678
 
769
- # BuildStep describes a step to perform in the build pipeline.
770
- class BuildStep
679
+ # Configuration for an automated build in response to source repository
680
+ # changes.
681
+ class BuildTrigger
771
682
  include Google::Apis::Core::Hashable
772
683
 
773
- # Optional unique identifier for this build step, used in wait_for to
774
- # reference this build step as a dependency.
775
- # Corresponds to the JSON property `id`
684
+ # Time when the trigger was created.
685
+ # @OutputOnly
686
+ # Corresponds to the JSON property `createTime`
776
687
  # @return [String]
777
- attr_accessor :id
778
-
779
- # A list of environment variable definitions to be used when running a step.
780
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
781
- # being given the value "VALUE".
782
- # Corresponds to the JSON property `env`
783
- # @return [Array<String>]
784
- attr_accessor :env
688
+ attr_accessor :create_time
785
689
 
786
- # The ID(s) of the step(s) that this build step depends on.
787
- # This build step will not start until all the build steps in wait_for
788
- # have completed successfully. If wait_for is empty, this build step will
789
- # start when all previous build steps in the Build.Steps list have completed
790
- # successfully.
791
- # Corresponds to the JSON property `waitFor`
792
- # @return [Array<String>]
793
- attr_accessor :wait_for
690
+ # If true, the trigger will never result in a build.
691
+ # Corresponds to the JSON property `disabled`
692
+ # @return [Boolean]
693
+ attr_accessor :disabled
694
+ alias_method :disabled?, :disabled
794
695
 
795
- # A list of arguments that will be presented to the step when it is started.
796
- # If the image used to run the step's container has an entrypoint, these args
797
- # will be used as arguments to that entrypoint. If the image does not define
798
- # an entrypoint, the first element in args will be used as the entrypoint,
799
- # and the remainder will be used as arguments.
800
- # Corresponds to the JSON property `args`
801
- # @return [Array<String>]
802
- attr_accessor :args
696
+ # RepoSource describes the location of the source in a Google Cloud Source
697
+ # Repository.
698
+ # Corresponds to the JSON property `triggerTemplate`
699
+ # @return [Google::Apis::CloudbuildV1::RepoSource]
700
+ attr_accessor :trigger_template
803
701
 
804
- # Optional entrypoint to be used instead of the build step image's default
805
- # If unset, the image's default will be used.
806
- # Corresponds to the JSON property `entrypoint`
702
+ # Path, from the source root, to a file whose contents is used for the
703
+ # template.
704
+ # Corresponds to the JSON property `filename`
807
705
  # @return [String]
808
- attr_accessor :entrypoint
706
+ attr_accessor :filename
809
707
 
810
- # The name of the container image that will run this particular build step.
811
- # If the image is already available in the host's Docker daemon's cache, it
812
- # will be run directly. If not, the host will attempt to pull the image
813
- # first, using the builder service account's credentials if necessary.
814
- # The Docker daemon's cache will already have the latest versions of all of
815
- # the officially supported build steps
816
- # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
817
- # will also have cached many of the layers for some popular images, like
818
- # "ubuntu", "debian", but they will be refreshed at the time you attempt to
819
- # use them.
820
- # If you built an image in a previous build step, it will be stored in the
821
- # host's Docker daemon's cache and is available to use as the name for a
822
- # later build step.
823
- # Corresponds to the JSON property `name`
708
+ # Unique identifier of the trigger.
709
+ # @OutputOnly
710
+ # Corresponds to the JSON property `id`
824
711
  # @return [String]
825
- attr_accessor :name
712
+ attr_accessor :id
826
713
 
827
- # Working directory (relative to project source root) to use when running
828
- # this operation's container.
829
- # Corresponds to the JSON property `dir`
714
+ # A build resource in the Container Builder API.
715
+ # At a high level, a Build describes where to find source code, how to build
716
+ # it (for example, the builder image to run on the source), and what tag to
717
+ # apply to the built image when it is pushed to Google Container Registry.
718
+ # Fields can include the following variables which will be expanded when the
719
+ # build is created:
720
+ # - $PROJECT_ID: the project ID of the build.
721
+ # - $BUILD_ID: the autogenerated ID of the build.
722
+ # - $REPO_NAME: the source repository name specified by RepoSource.
723
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
724
+ # - $TAG_NAME: the tag name specified by RepoSource.
725
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
726
+ # resolved from the specified branch or tag.
727
+ # Corresponds to the JSON property `build`
728
+ # @return [Google::Apis::CloudbuildV1::Build]
729
+ attr_accessor :build
730
+
731
+ # Human-readable description of this trigger.
732
+ # Corresponds to the JSON property `description`
830
733
  # @return [String]
831
- attr_accessor :dir
734
+ attr_accessor :description
832
735
 
833
736
  def initialize(**args)
834
737
  update!(**args)
@@ -836,48 +739,142 @@ module Google
836
739
 
837
740
  # Update properties of this object
838
741
  def update!(**args)
742
+ @create_time = args[:create_time] if args.key?(:create_time)
743
+ @disabled = args[:disabled] if args.key?(:disabled)
744
+ @trigger_template = args[:trigger_template] if args.key?(:trigger_template)
745
+ @filename = args[:filename] if args.key?(:filename)
839
746
  @id = args[:id] if args.key?(:id)
840
- @env = args[:env] if args.key?(:env)
841
- @wait_for = args[:wait_for] if args.key?(:wait_for)
842
- @args = args[:args] if args.key?(:args)
843
- @entrypoint = args[:entrypoint] if args.key?(:entrypoint)
844
- @name = args[:name] if args.key?(:name)
845
- @dir = args[:dir] if args.key?(:dir)
747
+ @build = args[:build] if args.key?(:build)
748
+ @description = args[:description] if args.key?(:description)
846
749
  end
847
750
  end
848
751
 
849
- # A generic empty message that you can re-use to avoid defining duplicated
850
- # empty messages in your APIs. A typical example is to use it as the request
851
- # or the response type of an API method. For instance:
852
- # service Foo `
853
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
854
- # `
855
- # The JSON representation for `Empty` is empty JSON object ````.
856
- class Empty
752
+ # A build resource in the Container Builder API.
753
+ # At a high level, a Build describes where to find source code, how to build
754
+ # it (for example, the builder image to run on the source), and what tag to
755
+ # apply to the built image when it is pushed to Google Container Registry.
756
+ # Fields can include the following variables which will be expanded when the
757
+ # build is created:
758
+ # - $PROJECT_ID: the project ID of the build.
759
+ # - $BUILD_ID: the autogenerated ID of the build.
760
+ # - $REPO_NAME: the source repository name specified by RepoSource.
761
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
762
+ # - $TAG_NAME: the tag name specified by RepoSource.
763
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
764
+ # resolved from the specified branch or tag.
765
+ class Build
857
766
  include Google::Apis::Core::Hashable
858
767
 
859
- def initialize(**args)
860
- update!(**args)
861
- end
862
-
863
- # Update properties of this object
864
- def update!(**args)
865
- end
866
- end
768
+ # Time at which the request to create the build was received.
769
+ # @OutputOnly
770
+ # Corresponds to the JSON property `createTime`
771
+ # @return [String]
772
+ attr_accessor :create_time
867
773
 
868
- # Optional arguments to enable specific features of builds.
869
- class BuildOptions
870
- include Google::Apis::Core::Hashable
774
+ # Provenance of the source. Ways to find the original source, or verify that
775
+ # some source was used for this build.
776
+ # Corresponds to the JSON property `sourceProvenance`
777
+ # @return [Google::Apis::CloudbuildV1::SourceProvenance]
778
+ attr_accessor :source_provenance
871
779
 
872
- # Requested hash for SourceProvenance.
873
- # Corresponds to the JSON property `sourceProvenanceHash`
780
+ # A list of images to be pushed upon the successful completion of all build
781
+ # steps.
782
+ # The images will be pushed using the builder service account's credentials.
783
+ # The digests of the pushed images will be stored in the Build resource's
784
+ # results field.
785
+ # If any of the images fail to be pushed, the build is marked FAILURE.
786
+ # Corresponds to the JSON property `images`
874
787
  # @return [Array<String>]
875
- attr_accessor :source_provenance_hash
788
+ attr_accessor :images
876
789
 
877
- # Requested verifiability options.
878
- # Corresponds to the JSON property `requestedVerifyOption`
790
+ # ID of the project.
791
+ # @OutputOnly.
792
+ # Corresponds to the JSON property `projectId`
879
793
  # @return [String]
880
- attr_accessor :requested_verify_option
794
+ attr_accessor :project_id
795
+
796
+ # URL to logs for this build in Google Cloud Logging.
797
+ # @OutputOnly
798
+ # Corresponds to the JSON property `logUrl`
799
+ # @return [String]
800
+ attr_accessor :log_url
801
+
802
+ # Time at which execution of the build was finished.
803
+ # The difference between finish_time and start_time is the duration of the
804
+ # build's execution.
805
+ # @OutputOnly
806
+ # Corresponds to the JSON property `finishTime`
807
+ # @return [String]
808
+ attr_accessor :finish_time
809
+
810
+ # Source describes the location of the source in a supported storage
811
+ # service.
812
+ # Corresponds to the JSON property `source`
813
+ # @return [Google::Apis::CloudbuildV1::Source]
814
+ attr_accessor :source
815
+
816
+ # Optional arguments to enable specific features of builds.
817
+ # Corresponds to the JSON property `options`
818
+ # @return [Google::Apis::CloudbuildV1::BuildOptions]
819
+ attr_accessor :options
820
+
821
+ # Customer-readable message about the current status.
822
+ # @OutputOnly
823
+ # Corresponds to the JSON property `statusDetail`
824
+ # @return [String]
825
+ attr_accessor :status_detail
826
+
827
+ # Status of the build.
828
+ # @OutputOnly
829
+ # Corresponds to the JSON property `status`
830
+ # @return [String]
831
+ attr_accessor :status
832
+
833
+ # Amount of time that this build should be allowed to run, to second
834
+ # granularity. If this amount of time elapses, work on the build will cease
835
+ # and the build status will be TIMEOUT.
836
+ # Default time is ten minutes.
837
+ # Corresponds to the JSON property `timeout`
838
+ # @return [String]
839
+ attr_accessor :timeout
840
+
841
+ # Results describes the artifacts created by the build pipeline.
842
+ # Corresponds to the JSON property `results`
843
+ # @return [Google::Apis::CloudbuildV1::Results]
844
+ attr_accessor :results
845
+
846
+ # Google Cloud Storage bucket where logs should be written (see
847
+ # [Bucket Name
848
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
849
+ # ).
850
+ # Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
851
+ # Corresponds to the JSON property `logsBucket`
852
+ # @return [String]
853
+ attr_accessor :logs_bucket
854
+
855
+ # Describes the operations to be performed on the workspace.
856
+ # Corresponds to the JSON property `steps`
857
+ # @return [Array<Google::Apis::CloudbuildV1::BuildStep>]
858
+ attr_accessor :steps
859
+
860
+ # The ID of the BuildTrigger that triggered this build, if it was
861
+ # triggered automatically.
862
+ # @OutputOnly
863
+ # Corresponds to the JSON property `buildTriggerId`
864
+ # @return [String]
865
+ attr_accessor :build_trigger_id
866
+
867
+ # Unique identifier of the build.
868
+ # @OutputOnly
869
+ # Corresponds to the JSON property `id`
870
+ # @return [String]
871
+ attr_accessor :id
872
+
873
+ # Time at which execution of the build was started.
874
+ # @OutputOnly
875
+ # Corresponds to the JSON property `startTime`
876
+ # @return [String]
877
+ attr_accessor :start_time
881
878
 
882
879
  def initialize(**args)
883
880
  update!(**args)
@@ -885,33 +882,36 @@ module Google
885
882
 
886
883
  # Update properties of this object
887
884
  def update!(**args)
888
- @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash)
889
- @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option)
885
+ @create_time = args[:create_time] if args.key?(:create_time)
886
+ @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
887
+ @images = args[:images] if args.key?(:images)
888
+ @project_id = args[:project_id] if args.key?(:project_id)
889
+ @log_url = args[:log_url] if args.key?(:log_url)
890
+ @finish_time = args[:finish_time] if args.key?(:finish_time)
891
+ @source = args[:source] if args.key?(:source)
892
+ @options = args[:options] if args.key?(:options)
893
+ @status_detail = args[:status_detail] if args.key?(:status_detail)
894
+ @status = args[:status] if args.key?(:status)
895
+ @timeout = args[:timeout] if args.key?(:timeout)
896
+ @results = args[:results] if args.key?(:results)
897
+ @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
898
+ @steps = args[:steps] if args.key?(:steps)
899
+ @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
900
+ @id = args[:id] if args.key?(:id)
901
+ @start_time = args[:start_time] if args.key?(:start_time)
890
902
  end
891
903
  end
892
904
 
893
- # Response including listed builds.
894
- class ListBuildsResponse
905
+ # Request to cancel an ongoing build.
906
+ class CancelBuildRequest
895
907
  include Google::Apis::Core::Hashable
896
908
 
897
- # Token to receive the next page of results.
898
- # Corresponds to the JSON property `nextPageToken`
899
- # @return [String]
900
- attr_accessor :next_page_token
901
-
902
- # Builds will be sorted by create_time, descending.
903
- # Corresponds to the JSON property `builds`
904
- # @return [Array<Google::Apis::CloudbuildV1::Build>]
905
- attr_accessor :builds
906
-
907
909
  def initialize(**args)
908
910
  update!(**args)
909
911
  end
910
912
 
911
913
  # Update properties of this object
912
914
  def update!(**args)
913
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
914
- @builds = args[:builds] if args.key?(:builds)
915
915
  end
916
916
  end
917
917
  end