0.2.3

Features

BigQuery

• Add support for the BYTES datatype. A field of type BYTES can be created by using Field.Value.bytes(). The byte[] bytesValue() method is added to FieldValue to return the value of a field as a byte array.
• A Job waitFor(WaitForOption... waitOptions) method is added to Job class. This method waits for the job to complete and returns job's updated information:

Job completedJob = job.waitFor();
if (completedJob == null) {
  // job no longer exists
} else if (completedJob.status().error() != null) {
  // job failed, handle error
} else {
  // job completed successfully
}

By default, the job status is checked every 500 milliseconds, to configure this value WaitForOption.checkEvery(long, TimeUnit) can be used. WaitForOption.timeout(long, TimeUnit), instead, sets the maximum time to wait.

Core

• AuthCredentials.createFor(String) and AuthCredentials.createFor(String, Date) methods have been added to create AuthCredentials objects given an OAuth2 access token (and possibly its expiration date).

Compute

• A Operation waitFor(WaitForOption... waitOptions) method is added to Operation class. This method waits for the operation to complete and returns operation's updated information:

Operation completedOperation = operation.waitFor();
if (completedOperation == null) {
  // operation no longer exists
} else if (completedOperation.errors() != null) {
  // operation failed, handle error
} else {
  // operation completed successfully
}

By default, the operation status is checked every 500 milliseconds, to configure this value WaitForOption.checkEvery(long, TimeUnit) can be used. WaitForOption.timeout(long, TimeUnit), instead, sets the maximum time to wait.

Datastore

• Datastore.put and DatastoreBatchWriter.put now support entities with incomplete keys. Both put methods return the just updated/created entities. A putWithDeferredIdAllocation method has been also added to DatastoreBatchWriter.

Fixes

Storage

• StorageExample now contains examples on how to add ACLs to blobs and buckets (#1033).
• BlobInfo.createTime() getter has been added. This method returns the time at which a blob was created (#1034).