com.google.api.services.storage.Storage Maven / Gradle / Ivy
/*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
* in compliance with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License
* is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
* or implied. See the License for the specific language governing permissions and limitations under
* the License.
*/
/*
* This code was generated by https://github.com/googleapis/google-api-java-client-services/
* Modify at your own risk.
*/
package com.google.api.services.storage;
/**
* Service definition for Storage (v1).
*
*
* Stores and retrieves potentially large, immutable data objects.
*
*
*
* For more information about this service, see the
* API Documentation
*
*
*
* This service uses {@link StorageRequestInitializer} to initialize global parameters via its
* {@link Builder}.
*
*
* @since 1.3
* @author Google, Inc.
*/
@SuppressWarnings("javadoc")
public class Storage extends com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient {
// Note: Leave this static initializer at the top of the file.
static {
com.google.api.client.util.Preconditions.checkState(
(com.google.api.client.googleapis.GoogleUtils.MAJOR_VERSION == 1 &&
(com.google.api.client.googleapis.GoogleUtils.MINOR_VERSION >= 32 ||
(com.google.api.client.googleapis.GoogleUtils.MINOR_VERSION == 31 &&
com.google.api.client.googleapis.GoogleUtils.BUGFIX_VERSION >= 1))) ||
com.google.api.client.googleapis.GoogleUtils.MAJOR_VERSION >= 2,
"You are currently running with version %s of google-api-client. " +
"You need at least version 1.31.1 of google-api-client to run version " +
"2.0.0 of the Cloud Storage JSON API library.", com.google.api.client.googleapis.GoogleUtils.VERSION);
}
/**
* The default encoded root URL of the service. This is determined when the library is generated
* and normally should not be changed.
*
* @since 1.7
*/
public static final String DEFAULT_ROOT_URL = "https://storage.googleapis.com/";
/**
* The default encoded mTLS root URL of the service. This is determined when the library is generated
* and normally should not be changed.
*
* @since 1.31
*/
public static final String DEFAULT_MTLS_ROOT_URL = "https://storage.mtls.googleapis.com/";
/**
* The default encoded service path of the service. This is determined when the library is
* generated and normally should not be changed.
*
* @since 1.7
*/
public static final String DEFAULT_SERVICE_PATH = "storage/v1/";
/**
* The default encoded batch path of the service. This is determined when the library is
* generated and normally should not be changed.
*
* @since 1.23
*/
public static final String DEFAULT_BATCH_PATH = "batch/storage/v1";
/**
* The default encoded base URL of the service. This is determined when the library is generated
* and normally should not be changed.
*/
public static final String DEFAULT_BASE_URL = DEFAULT_ROOT_URL + DEFAULT_SERVICE_PATH;
/**
* Constructor.
*
*
* Use {@link Builder} if you need to specify any of the optional parameters.
*
*
* @param transport HTTP transport, which should normally be:
*
* - Google App Engine:
* {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport}
* - Android: {@code newCompatibleTransport} from
* {@code com.google.api.client.extensions.android.http.AndroidHttp}
* - Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()}
*
*
* @param jsonFactory JSON factory, which may be:
*
* - Jackson: {@code com.google.api.client.json.jackson2.JacksonFactory}
* - Google GSON: {@code com.google.api.client.json.gson.GsonFactory}
* - Android Honeycomb or higher:
* {@code com.google.api.client.extensions.android.json.AndroidJsonFactory}
*
* @param httpRequestInitializer HTTP request initializer or {@code null} for none
* @since 1.7
*/
public Storage(com.google.api.client.http.HttpTransport transport, com.google.api.client.json.JsonFactory jsonFactory,
com.google.api.client.http.HttpRequestInitializer httpRequestInitializer) {
this(new Builder(transport, jsonFactory, httpRequestInitializer));
}
/**
* @param builder builder
*/
Storage(Builder builder) {
super(builder);
}
@Override
protected void initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest> httpClientRequest) throws java.io.IOException {
super.initialize(httpClientRequest);
}
/**
* An accessor for creating requests from the AnywhereCaches collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.AnywhereCaches.List request = storage.anywhereCaches().list(parameters ...)}
*
*
* @return the resource collection
*/
public AnywhereCaches anywhereCaches() {
return new AnywhereCaches();
}
/**
* The "anywhereCaches" collection of methods.
*/
public class AnywhereCaches {
/**
* Disables an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.disable".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Disable#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @return the request
*/
public Disable disable(java.lang.String bucket, java.lang.String anywhereCacheId) throws java.io.IOException {
Disable result = new Disable(bucket, anywhereCacheId);
initialize(result);
return result;
}
public class Disable extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches/{anywhereCacheId}/disable";
/**
* Disables an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.disable".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Disable#execute()} method to invoke the remote operation.
* {@link
* Disable#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @since 1.13
*/
protected Disable(java.lang.String bucket, java.lang.String anywhereCacheId) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.AnywhereCache.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.anywhereCacheId = com.google.api.client.util.Preconditions.checkNotNull(anywhereCacheId, "Required parameter anywhereCacheId must be specified.");
}
@Override
public Disable setAlt(java.lang.String alt) {
return (Disable) super.setAlt(alt);
}
@Override
public Disable setFields(java.lang.String fields) {
return (Disable) super.setFields(fields);
}
@Override
public Disable setKey(java.lang.String key) {
return (Disable) super.setKey(key);
}
@Override
public Disable setOauthToken(java.lang.String oauthToken) {
return (Disable) super.setOauthToken(oauthToken);
}
@Override
public Disable setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Disable) super.setPrettyPrint(prettyPrint);
}
@Override
public Disable setQuotaUser(java.lang.String quotaUser) {
return (Disable) super.setQuotaUser(quotaUser);
}
@Override
public Disable setUploadType(java.lang.String uploadType) {
return (Disable) super.setUploadType(uploadType);
}
@Override
public Disable setUserIp(java.lang.String userIp) {
return (Disable) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Disable setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of requested Anywhere Cache instance. */
@com.google.api.client.util.Key
private java.lang.String anywhereCacheId;
/** The ID of requested Anywhere Cache instance.
*/
public java.lang.String getAnywhereCacheId() {
return anywhereCacheId;
}
/** The ID of requested Anywhere Cache instance. */
public Disable setAnywhereCacheId(java.lang.String anywhereCacheId) {
this.anywhereCacheId = anywhereCacheId;
return this;
}
@Override
public Disable set(String parameterName, Object value) {
return (Disable) super.set(parameterName, value);
}
}
/**
* Returns the metadata of an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String anywhereCacheId) throws java.io.IOException {
Get result = new Get(bucket, anywhereCacheId);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches/{anywhereCacheId}";
/**
* Returns the metadata of an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String anywhereCacheId) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.AnywhereCache.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.anywhereCacheId = com.google.api.client.util.Preconditions.checkNotNull(anywhereCacheId, "Required parameter anywhereCacheId must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of requested Anywhere Cache instance. */
@com.google.api.client.util.Key
private java.lang.String anywhereCacheId;
/** The ID of requested Anywhere Cache instance.
*/
public java.lang.String getAnywhereCacheId() {
return anywhereCacheId;
}
/** The ID of requested Anywhere Cache instance. */
public Get setAnywhereCacheId(java.lang.String anywhereCacheId) {
this.anywhereCacheId = anywhereCacheId;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param content the {@link com.google.api.services.storage.model.AnywhereCache}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.AnywhereCache content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches";
/**
* Creates an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param content the {@link com.google.api.services.storage.model.AnywhereCache}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.AnywhereCache content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.GoogleLongrunningOperation.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Returns a list of Anywhere Cache instances of the bucket matching the criteria.
*
* Create a request for the method "anywhereCaches.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches";
/**
* Returns a list of Anywhere Cache instances of the bucket matching the criteria.
*
* Create a request for the method "anywhereCaches.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.AnywhereCaches.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Maximum number of items to return in a single page of responses. Maximum 1000. */
@com.google.api.client.util.Key
private java.lang.Integer pageSize;
/** Maximum number of items to return in a single page of responses. Maximum 1000.
[minimum: 0]
*/
public java.lang.Integer getPageSize() {
return pageSize;
}
/** Maximum number of items to return in a single page of responses. Maximum 1000. */
public List setPageSize(java.lang.Integer pageSize) {
this.pageSize = pageSize;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Pauses an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.pause".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Pause#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @return the request
*/
public Pause pause(java.lang.String bucket, java.lang.String anywhereCacheId) throws java.io.IOException {
Pause result = new Pause(bucket, anywhereCacheId);
initialize(result);
return result;
}
public class Pause extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches/{anywhereCacheId}/pause";
/**
* Pauses an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.pause".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Pause#execute()} method to invoke the remote operation. {@link
* Pause#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @since 1.13
*/
protected Pause(java.lang.String bucket, java.lang.String anywhereCacheId) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.AnywhereCache.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.anywhereCacheId = com.google.api.client.util.Preconditions.checkNotNull(anywhereCacheId, "Required parameter anywhereCacheId must be specified.");
}
@Override
public Pause setAlt(java.lang.String alt) {
return (Pause) super.setAlt(alt);
}
@Override
public Pause setFields(java.lang.String fields) {
return (Pause) super.setFields(fields);
}
@Override
public Pause setKey(java.lang.String key) {
return (Pause) super.setKey(key);
}
@Override
public Pause setOauthToken(java.lang.String oauthToken) {
return (Pause) super.setOauthToken(oauthToken);
}
@Override
public Pause setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Pause) super.setPrettyPrint(prettyPrint);
}
@Override
public Pause setQuotaUser(java.lang.String quotaUser) {
return (Pause) super.setQuotaUser(quotaUser);
}
@Override
public Pause setUploadType(java.lang.String uploadType) {
return (Pause) super.setUploadType(uploadType);
}
@Override
public Pause setUserIp(java.lang.String userIp) {
return (Pause) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Pause setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of requested Anywhere Cache instance. */
@com.google.api.client.util.Key
private java.lang.String anywhereCacheId;
/** The ID of requested Anywhere Cache instance.
*/
public java.lang.String getAnywhereCacheId() {
return anywhereCacheId;
}
/** The ID of requested Anywhere Cache instance. */
public Pause setAnywhereCacheId(java.lang.String anywhereCacheId) {
this.anywhereCacheId = anywhereCacheId;
return this;
}
@Override
public Pause set(String parameterName, Object value) {
return (Pause) super.set(parameterName, value);
}
}
/**
* Resumes a paused or disabled Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.resume".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Resume#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @return the request
*/
public Resume resume(java.lang.String bucket, java.lang.String anywhereCacheId) throws java.io.IOException {
Resume result = new Resume(bucket, anywhereCacheId);
initialize(result);
return result;
}
public class Resume extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches/{anywhereCacheId}/resume";
/**
* Resumes a paused or disabled Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.resume".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Resume#execute()} method to invoke the remote operation. {@link
* Resume#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @since 1.13
*/
protected Resume(java.lang.String bucket, java.lang.String anywhereCacheId) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.AnywhereCache.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.anywhereCacheId = com.google.api.client.util.Preconditions.checkNotNull(anywhereCacheId, "Required parameter anywhereCacheId must be specified.");
}
@Override
public Resume setAlt(java.lang.String alt) {
return (Resume) super.setAlt(alt);
}
@Override
public Resume setFields(java.lang.String fields) {
return (Resume) super.setFields(fields);
}
@Override
public Resume setKey(java.lang.String key) {
return (Resume) super.setKey(key);
}
@Override
public Resume setOauthToken(java.lang.String oauthToken) {
return (Resume) super.setOauthToken(oauthToken);
}
@Override
public Resume setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Resume) super.setPrettyPrint(prettyPrint);
}
@Override
public Resume setQuotaUser(java.lang.String quotaUser) {
return (Resume) super.setQuotaUser(quotaUser);
}
@Override
public Resume setUploadType(java.lang.String uploadType) {
return (Resume) super.setUploadType(uploadType);
}
@Override
public Resume setUserIp(java.lang.String userIp) {
return (Resume) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Resume setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of requested Anywhere Cache instance. */
@com.google.api.client.util.Key
private java.lang.String anywhereCacheId;
/** The ID of requested Anywhere Cache instance.
*/
public java.lang.String getAnywhereCacheId() {
return anywhereCacheId;
}
/** The ID of requested Anywhere Cache instance. */
public Resume setAnywhereCacheId(java.lang.String anywhereCacheId) {
this.anywhereCacheId = anywhereCacheId;
return this;
}
@Override
public Resume set(String parameterName, Object value) {
return (Resume) super.set(parameterName, value);
}
}
/**
* Updates the config(ttl and admissionPolicy) of an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @param content the {@link com.google.api.services.storage.model.AnywhereCache}
* @return the request
*/
public Update update(java.lang.String bucket, java.lang.String anywhereCacheId, com.google.api.services.storage.model.AnywhereCache content) throws java.io.IOException {
Update result = new Update(bucket, anywhereCacheId, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/anywhereCaches/{anywhereCacheId}";
/**
* Updates the config(ttl and admissionPolicy) of an Anywhere Cache instance.
*
* Create a request for the method "anywhereCaches.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the parent bucket.
* @param anywhereCacheId The ID of requested Anywhere Cache instance.
* @param content the {@link com.google.api.services.storage.model.AnywhereCache}
* @since 1.13
*/
protected Update(java.lang.String bucket, java.lang.String anywhereCacheId, com.google.api.services.storage.model.AnywhereCache content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.GoogleLongrunningOperation.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.anywhereCacheId = com.google.api.client.util.Preconditions.checkNotNull(anywhereCacheId, "Required parameter anywhereCacheId must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of the parent bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the parent bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the parent bucket. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of requested Anywhere Cache instance. */
@com.google.api.client.util.Key
private java.lang.String anywhereCacheId;
/** The ID of requested Anywhere Cache instance.
*/
public java.lang.String getAnywhereCacheId() {
return anywhereCacheId;
}
/** The ID of requested Anywhere Cache instance. */
public Update setAnywhereCacheId(java.lang.String anywhereCacheId) {
this.anywhereCacheId = anywhereCacheId;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the BucketAccessControls collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.BucketAccessControls.List request = storage.bucketAccessControls().list(parameters ...)}
*
*
* @return the resource collection
*/
public BucketAccessControls bucketAccessControls() {
return new BucketAccessControls();
}
/**
* The "bucketAccessControls" collection of methods.
*/
public class BucketAccessControls {
/**
* Permanently deletes the ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "bucketAccessControls.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String entity) throws java.io.IOException {
Delete result = new Delete(bucket, entity);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl/{entity}";
/**
* Permanently deletes the ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "bucketAccessControls.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String entity) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Delete setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns the ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "bucketAccessControls.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String entity) throws java.io.IOException {
Get result = new Get(bucket, entity);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl/{entity}";
/**
* Returns the ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "bucketAccessControls.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String entity) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.BucketAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Get setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates a new ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.BucketAccessControl content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl";
/**
* Creates a new ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.BucketAccessControl content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.BucketAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getEntity(), "BucketAccessControl.getEntity()");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getRole(), "BucketAccessControl.getRole()");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves ACL entries on the specified bucket.
*
* Create a request for the method "bucketAccessControls.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl";
/**
* Retrieves ACL entries on the specified bucket.
*
* Create a request for the method "bucketAccessControls.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.BucketAccessControls.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Patches an ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.patch".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @return the request
*/
public Patch patch(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.BucketAccessControl content) throws java.io.IOException {
Patch result = new Patch(bucket, entity, content);
initialize(result);
return result;
}
public class Patch extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl/{entity}";
/**
* Patches an ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.patch".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation. {@link
* Patch#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @since 1.13
*/
protected Patch(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.BucketAccessControl content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.BucketAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Patch setAlt(java.lang.String alt) {
return (Patch) super.setAlt(alt);
}
@Override
public Patch setFields(java.lang.String fields) {
return (Patch) super.setFields(fields);
}
@Override
public Patch setKey(java.lang.String key) {
return (Patch) super.setKey(key);
}
@Override
public Patch setOauthToken(java.lang.String oauthToken) {
return (Patch) super.setOauthToken(oauthToken);
}
@Override
public Patch setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Patch) super.setPrettyPrint(prettyPrint);
}
@Override
public Patch setQuotaUser(java.lang.String quotaUser) {
return (Patch) super.setQuotaUser(quotaUser);
}
@Override
public Patch setUploadType(java.lang.String uploadType) {
return (Patch) super.setUploadType(uploadType);
}
@Override
public Patch setUserIp(java.lang.String userIp) {
return (Patch) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Patch setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Patch setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Patch setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Patch set(String parameterName, Object value) {
return (Patch) super.set(parameterName, value);
}
}
/**
* Updates an ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @return the request
*/
public Update update(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.BucketAccessControl content) throws java.io.IOException {
Update result = new Update(bucket, entity, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/acl/{entity}";
/**
* Updates an ACL entry on the specified bucket.
*
* Create a request for the method "bucketAccessControls.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.BucketAccessControl}
* @since 1.13
*/
protected Update(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.BucketAccessControl content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.BucketAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Update setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Buckets collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Buckets.List request = storage.buckets().list(parameters ...)}
*
*
* @return the resource collection
*/
public Buckets buckets() {
return new Buckets();
}
/**
* The "buckets" collection of methods.
*/
public class Buckets {
/**
* Permanently deletes an empty bucket.
*
* Create a request for the method "buckets.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public Delete delete(java.lang.String bucket) throws java.io.IOException {
Delete result = new Delete(bucket);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}";
/**
* Permanently deletes an empty bucket.
*
* Create a request for the method "buckets.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected Delete(java.lang.String bucket) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** If set, only deletes the bucket if its metageneration matches this value. */
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** If set, only deletes the bucket if its metageneration matches this value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/** If set, only deletes the bucket if its metageneration matches this value. */
public Delete setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/** If set, only deletes the bucket if its metageneration does not match this value. */
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** If set, only deletes the bucket if its metageneration does not match this value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/** If set, only deletes the bucket if its metageneration does not match this value. */
public Delete setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns metadata for the specified bucket.
*
* Create a request for the method "buckets.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public Get get(java.lang.String bucket) throws java.io.IOException {
Get result = new Get(bucket);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}";
/**
* Returns metadata for the specified bucket.
*
* Create a request for the method "buckets.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected Get(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Bucket.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
public Get setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
does not match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
public Get setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** Set of properties to return. Defaults to noAcl. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to noAcl. */
public Get setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Returns an IAM policy for the specified bucket.
*
* Create a request for the method "buckets.getIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public GetIamPolicy getIamPolicy(java.lang.String bucket) throws java.io.IOException {
GetIamPolicy result = new GetIamPolicy(bucket);
initialize(result);
return result;
}
public class GetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/iam";
/**
* Returns an IAM policy for the specified bucket.
*
* Create a request for the method "buckets.getIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* GetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected GetIamPolicy(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public GetIamPolicy setAlt(java.lang.String alt) {
return (GetIamPolicy) super.setAlt(alt);
}
@Override
public GetIamPolicy setFields(java.lang.String fields) {
return (GetIamPolicy) super.setFields(fields);
}
@Override
public GetIamPolicy setKey(java.lang.String key) {
return (GetIamPolicy) super.setKey(key);
}
@Override
public GetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (GetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public GetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (GetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public GetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (GetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public GetIamPolicy setUploadType(java.lang.String uploadType) {
return (GetIamPolicy) super.setUploadType(uploadType);
}
@Override
public GetIamPolicy setUserIp(java.lang.String userIp) {
return (GetIamPolicy) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public GetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for
* an older version that doesn't support part of the requested IAM policy, the request fails.
*/
@com.google.api.client.util.Key
private java.lang.Integer optionsRequestedPolicyVersion;
/** The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for an older
version that doesn't support part of the requested IAM policy, the request fails.
[minimum: 1]
*/
public java.lang.Integer getOptionsRequestedPolicyVersion() {
return optionsRequestedPolicyVersion;
}
/**
* The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for
* an older version that doesn't support part of the requested IAM policy, the request fails.
*/
public GetIamPolicy setOptionsRequestedPolicyVersion(java.lang.Integer optionsRequestedPolicyVersion) {
this.optionsRequestedPolicyVersion = optionsRequestedPolicyVersion;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public GetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public GetIamPolicy set(String parameterName, Object value) {
return (GetIamPolicy) super.set(parameterName, value);
}
}
/**
* Returns the storage layout configuration for the specified bucket. Note that this operation
* requires storage.objects.list permission.
*
* Create a request for the method "buckets.getStorageLayout".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link GetStorageLayout#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public GetStorageLayout getStorageLayout(java.lang.String bucket) throws java.io.IOException {
GetStorageLayout result = new GetStorageLayout(bucket);
initialize(result);
return result;
}
public class GetStorageLayout extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/storageLayout";
/**
* Returns the storage layout configuration for the specified bucket. Note that this operation
* requires storage.objects.list permission.
*
* Create a request for the method "buckets.getStorageLayout".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link GetStorageLayout#execute()} method to invoke the remote operation.
* {@link GetStorageLayout#initialize(com.google.api.client.googleapis.services.AbstractGoogle
* ClientRequest)} must be called to initialize this instance immediately after invoking the
* constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected GetStorageLayout(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.BucketStorageLayout.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public GetStorageLayout setAlt(java.lang.String alt) {
return (GetStorageLayout) super.setAlt(alt);
}
@Override
public GetStorageLayout setFields(java.lang.String fields) {
return (GetStorageLayout) super.setFields(fields);
}
@Override
public GetStorageLayout setKey(java.lang.String key) {
return (GetStorageLayout) super.setKey(key);
}
@Override
public GetStorageLayout setOauthToken(java.lang.String oauthToken) {
return (GetStorageLayout) super.setOauthToken(oauthToken);
}
@Override
public GetStorageLayout setPrettyPrint(java.lang.Boolean prettyPrint) {
return (GetStorageLayout) super.setPrettyPrint(prettyPrint);
}
@Override
public GetStorageLayout setQuotaUser(java.lang.String quotaUser) {
return (GetStorageLayout) super.setQuotaUser(quotaUser);
}
@Override
public GetStorageLayout setUploadType(java.lang.String uploadType) {
return (GetStorageLayout) super.setUploadType(uploadType);
}
@Override
public GetStorageLayout setUserIp(java.lang.String userIp) {
return (GetStorageLayout) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public GetStorageLayout setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* An optional prefix used for permission check. It is useful when the caller only has
* storage.objects.list permission under a specific prefix.
*/
@com.google.api.client.util.Key
private java.lang.String prefix;
/** An optional prefix used for permission check. It is useful when the caller only has
storage.objects.list permission under a specific prefix.
*/
public java.lang.String getPrefix() {
return prefix;
}
/**
* An optional prefix used for permission check. It is useful when the caller only has
* storage.objects.list permission under a specific prefix.
*/
public GetStorageLayout setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
@Override
public GetStorageLayout set(String parameterName, Object value) {
return (GetStorageLayout) super.set(parameterName, value);
}
}
/**
* Creates a new bucket.
*
* Create a request for the method "buckets.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param project A valid API project identifier.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @return the request
*/
public Insert insert(java.lang.String project, com.google.api.services.storage.model.Bucket content) throws java.io.IOException {
Insert result = new Insert(project, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b";
/**
* Creates a new bucket.
*
* Create a request for the method "buckets.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param project A valid API project identifier.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @since 1.13
*/
protected Insert(java.lang.String project, com.google.api.services.storage.model.Bucket content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.Bucket.class);
this.project = com.google.api.client.util.Preconditions.checkNotNull(project, "Required parameter project must be specified.");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getName(), "Bucket.getName()");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** A valid API project identifier. */
@com.google.api.client.util.Key
private java.lang.String project;
/** A valid API project identifier.
*/
public java.lang.String getProject() {
return project;
}
/** A valid API project identifier. */
public Insert setProject(java.lang.String project) {
this.project = project;
return this;
}
/** When set to true, object retention is enabled for this bucket. */
@com.google.api.client.util.Key
private java.lang.Boolean enableObjectRetention;
/** When set to true, object retention is enabled for this bucket. [default: false]
*/
public java.lang.Boolean getEnableObjectRetention() {
return enableObjectRetention;
}
/** When set to true, object retention is enabled for this bucket. */
public Insert setEnableObjectRetention(java.lang.Boolean enableObjectRetention) {
this.enableObjectRetention = enableObjectRetention;
return this;
}
/**
* Convenience method that returns only {@link Boolean#TRUE} or {@link Boolean#FALSE}.
*
*
* Boolean properties can have four possible values:
* {@code null}, {@link com.google.api.client.util.Data#NULL_BOOLEAN}, {@link Boolean#TRUE}
* or {@link Boolean#FALSE}.
*
*
*
* This method returns {@link Boolean#TRUE} if the default of the property is {@link Boolean#TRUE}
* and it is {@code null} or {@link com.google.api.client.util.Data#NULL_BOOLEAN}.
* {@link Boolean#FALSE} is returned if the default of the property is {@link Boolean#FALSE} and
* it is {@code null} or {@link com.google.api.client.util.Data#NULL_BOOLEAN}.
*
*
*
* When set to true, object retention is enabled for this bucket.
*
*/
public boolean isEnableObjectRetention() {
if (enableObjectRetention == null || enableObjectRetention == com.google.api.client.util.Data.NULL_BOOLEAN) {
return false;
}
return enableObjectRetention;
}
/** Apply a predefined set of access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this bucket.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this bucket. */
public Insert setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/** Apply a predefined set of default object access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedDefaultObjectAcl;
/** Apply a predefined set of default object access controls to this bucket.
*/
public java.lang.String getPredefinedDefaultObjectAcl() {
return predefinedDefaultObjectAcl;
}
/** Apply a predefined set of default object access controls to this bucket. */
public Insert setPredefinedDefaultObjectAcl(java.lang.String predefinedDefaultObjectAcl) {
this.predefinedDefaultObjectAcl = predefinedDefaultObjectAcl;
return this;
}
/**
* Set of properties to return. Defaults to noAcl, unless the bucket resource specifies acl or
* defaultObjectAcl properties, when it defaults to full.
*/
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl, unless the bucket resource specifies acl or
defaultObjectAcl properties, when it defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/**
* Set of properties to return. Defaults to noAcl, unless the bucket resource specifies acl or
* defaultObjectAcl properties, when it defaults to full.
*/
public Insert setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves a list of buckets for a given project.
*
* Create a request for the method "buckets.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param project A valid API project identifier.
* @return the request
*/
public List list(java.lang.String project) throws java.io.IOException {
List result = new List(project);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b";
/**
* Retrieves a list of buckets for a given project.
*
* Create a request for the method "buckets.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param project A valid API project identifier.
* @since 1.13
*/
protected List(java.lang.String project) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Buckets.class);
this.project = com.google.api.client.util.Preconditions.checkNotNull(project, "Required parameter project must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** A valid API project identifier. */
@com.google.api.client.util.Key
private java.lang.String project;
/** A valid API project identifier.
*/
public java.lang.String getProject() {
return project;
}
/** A valid API project identifier. */
public List setProject(java.lang.String project) {
this.project = project;
return this;
}
/**
* Maximum number of buckets to return in a single response. The service will use this
* parameter or 1,000 items, whichever is smaller.
*/
@com.google.api.client.util.Key
private java.lang.Long maxResults;
/** Maximum number of buckets to return in a single response. The service will use this parameter or
1,000 items, whichever is smaller. [default: 1000] [minimum: 0]
*/
public java.lang.Long getMaxResults() {
return maxResults;
}
/**
* Maximum number of buckets to return in a single response. The service will use this
* parameter or 1,000 items, whichever is smaller.
*/
public List setMaxResults(java.lang.Long maxResults) {
this.maxResults = maxResults;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/** Filter results to buckets whose names begin with this prefix. */
@com.google.api.client.util.Key
private java.lang.String prefix;
/** Filter results to buckets whose names begin with this prefix.
*/
public java.lang.String getPrefix() {
return prefix;
}
/** Filter results to buckets whose names begin with this prefix. */
public List setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
/** Set of properties to return. Defaults to noAcl. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to noAcl. */
public List setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Locks retention policy on a bucket.
*
* Create a request for the method "buckets.lockRetentionPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link LockRetentionPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param ifMetagenerationMatch Makes the operation conditional on whether bucket's current metageneration matches the given value.
* @return the request
*/
public LockRetentionPolicy lockRetentionPolicy(java.lang.String bucket, java.lang.Long ifMetagenerationMatch) throws java.io.IOException {
LockRetentionPolicy result = new LockRetentionPolicy(bucket, ifMetagenerationMatch);
initialize(result);
return result;
}
public class LockRetentionPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/lockRetentionPolicy";
/**
* Locks retention policy on a bucket.
*
* Create a request for the method "buckets.lockRetentionPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link LockRetentionPolicy#execute()} method to invoke the remote
* operation. {@link LockRetentionPolicy#initialize(com.google.api.client.googleapis.services.
* AbstractGoogleClientRequest)} must be called to initialize this instance immediately after
* invoking the constructor.
*
* @param bucket Name of a bucket.
* @param ifMetagenerationMatch Makes the operation conditional on whether bucket's current metageneration matches the given value.
* @since 1.13
*/
protected LockRetentionPolicy(java.lang.String bucket, java.lang.Long ifMetagenerationMatch) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.Bucket.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.ifMetagenerationMatch = com.google.api.client.util.Preconditions.checkNotNull(ifMetagenerationMatch, "Required parameter ifMetagenerationMatch must be specified.");
}
@Override
public LockRetentionPolicy setAlt(java.lang.String alt) {
return (LockRetentionPolicy) super.setAlt(alt);
}
@Override
public LockRetentionPolicy setFields(java.lang.String fields) {
return (LockRetentionPolicy) super.setFields(fields);
}
@Override
public LockRetentionPolicy setKey(java.lang.String key) {
return (LockRetentionPolicy) super.setKey(key);
}
@Override
public LockRetentionPolicy setOauthToken(java.lang.String oauthToken) {
return (LockRetentionPolicy) super.setOauthToken(oauthToken);
}
@Override
public LockRetentionPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (LockRetentionPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public LockRetentionPolicy setQuotaUser(java.lang.String quotaUser) {
return (LockRetentionPolicy) super.setQuotaUser(quotaUser);
}
@Override
public LockRetentionPolicy setUploadType(java.lang.String uploadType) {
return (LockRetentionPolicy) super.setUploadType(uploadType);
}
@Override
public LockRetentionPolicy setUserIp(java.lang.String userIp) {
return (LockRetentionPolicy) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public LockRetentionPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Makes the operation conditional on whether bucket's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether bucket's current metageneration matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether bucket's current metageneration matches the
* given value.
*/
public LockRetentionPolicy setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public LockRetentionPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public LockRetentionPolicy set(String parameterName, Object value) {
return (LockRetentionPolicy) super.set(parameterName, value);
}
}
/**
* Patches a bucket. Changes to the bucket will be readable immediately after writing, but
* configuration changes may take time to propagate.
*
* Create a request for the method "buckets.patch".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @return the request
*/
public Patch patch(java.lang.String bucket, com.google.api.services.storage.model.Bucket content) throws java.io.IOException {
Patch result = new Patch(bucket, content);
initialize(result);
return result;
}
public class Patch extends StorageRequest {
private static final String REST_PATH = "b/{bucket}";
/**
* Patches a bucket. Changes to the bucket will be readable immediately after writing, but
* configuration changes may take time to propagate.
*
* Create a request for the method "buckets.patch".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation. {@link
* Patch#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @since 1.13
*/
protected Patch(java.lang.String bucket, com.google.api.services.storage.model.Bucket content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.Bucket.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Patch setAlt(java.lang.String alt) {
return (Patch) super.setAlt(alt);
}
@Override
public Patch setFields(java.lang.String fields) {
return (Patch) super.setFields(fields);
}
@Override
public Patch setKey(java.lang.String key) {
return (Patch) super.setKey(key);
}
@Override
public Patch setOauthToken(java.lang.String oauthToken) {
return (Patch) super.setOauthToken(oauthToken);
}
@Override
public Patch setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Patch) super.setPrettyPrint(prettyPrint);
}
@Override
public Patch setQuotaUser(java.lang.String quotaUser) {
return (Patch) super.setQuotaUser(quotaUser);
}
@Override
public Patch setUploadType(java.lang.String uploadType) {
return (Patch) super.setUploadType(uploadType);
}
@Override
public Patch setUserIp(java.lang.String userIp) {
return (Patch) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Patch setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
public Patch setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
does not match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
public Patch setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** Apply a predefined set of access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this bucket.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this bucket. */
public Patch setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/** Apply a predefined set of default object access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedDefaultObjectAcl;
/** Apply a predefined set of default object access controls to this bucket.
*/
public java.lang.String getPredefinedDefaultObjectAcl() {
return predefinedDefaultObjectAcl;
}
/** Apply a predefined set of default object access controls to this bucket. */
public Patch setPredefinedDefaultObjectAcl(java.lang.String predefinedDefaultObjectAcl) {
this.predefinedDefaultObjectAcl = predefinedDefaultObjectAcl;
return this;
}
/** Set of properties to return. Defaults to full. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to full. */
public Patch setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Patch setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Patch set(String parameterName, Object value) {
return (Patch) super.set(parameterName, value);
}
}
/**
* Updates an IAM policy for the specified bucket.
*
* Create a request for the method "buckets.setIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Policy}
* @return the request
*/
public SetIamPolicy setIamPolicy(java.lang.String bucket, com.google.api.services.storage.model.Policy content) throws java.io.IOException {
SetIamPolicy result = new SetIamPolicy(bucket, content);
initialize(result);
return result;
}
public class SetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/iam";
/**
* Updates an IAM policy for the specified bucket.
*
* Create a request for the method "buckets.setIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* SetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Policy}
* @since 1.13
*/
protected SetIamPolicy(java.lang.String bucket, com.google.api.services.storage.model.Policy content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public SetIamPolicy setAlt(java.lang.String alt) {
return (SetIamPolicy) super.setAlt(alt);
}
@Override
public SetIamPolicy setFields(java.lang.String fields) {
return (SetIamPolicy) super.setFields(fields);
}
@Override
public SetIamPolicy setKey(java.lang.String key) {
return (SetIamPolicy) super.setKey(key);
}
@Override
public SetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (SetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public SetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (SetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public SetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (SetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public SetIamPolicy setUploadType(java.lang.String uploadType) {
return (SetIamPolicy) super.setUploadType(uploadType);
}
@Override
public SetIamPolicy setUserIp(java.lang.String userIp) {
return (SetIamPolicy) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public SetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public SetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public SetIamPolicy set(String parameterName, Object value) {
return (SetIamPolicy) super.set(parameterName, value);
}
}
/**
* Tests a set of permissions on the given bucket to see which, if any, are held by the caller.
*
* Create a request for the method "buckets.testIamPermissions".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param permissions Permissions to test.
* @return the request
*/
public TestIamPermissions testIamPermissions(java.lang.String bucket, java.util.List permissions) throws java.io.IOException {
TestIamPermissions result = new TestIamPermissions(bucket, permissions);
initialize(result);
return result;
}
public class TestIamPermissions extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/iam/testPermissions";
/**
* Tests a set of permissions on the given bucket to see which, if any, are held by the caller.
*
* Create a request for the method "buckets.testIamPermissions".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote
* operation. {@link TestIamPermissions#initialize(com.google.api.client.googleapis.services.A
* bstractGoogleClientRequest)} must be called to initialize this instance immediately after
* invoking the constructor.
*
* @param bucket Name of a bucket.
* @param permissions Permissions to test.
* @since 1.13
*/
protected TestIamPermissions(java.lang.String bucket, java.util.List permissions) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.TestIamPermissionsResponse.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.permissions = com.google.api.client.util.Preconditions.checkNotNull(permissions, "Required parameter permissions must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public TestIamPermissions setAlt(java.lang.String alt) {
return (TestIamPermissions) super.setAlt(alt);
}
@Override
public TestIamPermissions setFields(java.lang.String fields) {
return (TestIamPermissions) super.setFields(fields);
}
@Override
public TestIamPermissions setKey(java.lang.String key) {
return (TestIamPermissions) super.setKey(key);
}
@Override
public TestIamPermissions setOauthToken(java.lang.String oauthToken) {
return (TestIamPermissions) super.setOauthToken(oauthToken);
}
@Override
public TestIamPermissions setPrettyPrint(java.lang.Boolean prettyPrint) {
return (TestIamPermissions) super.setPrettyPrint(prettyPrint);
}
@Override
public TestIamPermissions setQuotaUser(java.lang.String quotaUser) {
return (TestIamPermissions) super.setQuotaUser(quotaUser);
}
@Override
public TestIamPermissions setUploadType(java.lang.String uploadType) {
return (TestIamPermissions) super.setUploadType(uploadType);
}
@Override
public TestIamPermissions setUserIp(java.lang.String userIp) {
return (TestIamPermissions) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public TestIamPermissions setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Permissions to test. */
@com.google.api.client.util.Key
private java.util.List permissions;
/** Permissions to test.
*/
public java.util.List getPermissions() {
return permissions;
}
/** Permissions to test. */
public TestIamPermissions setPermissions(java.util.List permissions) {
this.permissions = permissions;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public TestIamPermissions setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public TestIamPermissions set(String parameterName, Object value) {
return (TestIamPermissions) super.set(parameterName, value);
}
}
/**
* Updates a bucket. Changes to the bucket will be readable immediately after writing, but
* configuration changes may take time to propagate.
*
* Create a request for the method "buckets.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @return the request
*/
public Update update(java.lang.String bucket, com.google.api.services.storage.model.Bucket content) throws java.io.IOException {
Update result = new Update(bucket, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}";
/**
* Updates a bucket. Changes to the bucket will be readable immediately after writing, but
* configuration changes may take time to propagate.
*
* Create a request for the method "buckets.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.Bucket}
* @since 1.13
*/
protected Update(java.lang.String bucket, com.google.api.services.storage.model.Bucket content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.Bucket.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration matches the given value.
*/
public Update setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the return of the bucket metadata conditional on whether the bucket's current metageneration
does not match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the return of the bucket metadata conditional on whether the bucket's current
* metageneration does not match the given value.
*/
public Update setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** Apply a predefined set of access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this bucket.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this bucket. */
public Update setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/** Apply a predefined set of default object access controls to this bucket. */
@com.google.api.client.util.Key
private java.lang.String predefinedDefaultObjectAcl;
/** Apply a predefined set of default object access controls to this bucket.
*/
public java.lang.String getPredefinedDefaultObjectAcl() {
return predefinedDefaultObjectAcl;
}
/** Apply a predefined set of default object access controls to this bucket. */
public Update setPredefinedDefaultObjectAcl(java.lang.String predefinedDefaultObjectAcl) {
this.predefinedDefaultObjectAcl = predefinedDefaultObjectAcl;
return this;
}
/** Set of properties to return. Defaults to full. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to full. */
public Update setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Channels collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Channels.List request = storage.channels().list(parameters ...)}
*
*
* @return the resource collection
*/
public Channels channels() {
return new Channels();
}
/**
* The "channels" collection of methods.
*/
public class Channels {
/**
* Stop watching resources through this channel
*
* Create a request for the method "channels.stop".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Stop#execute()} method to invoke the remote operation.
*
* @param content the {@link com.google.api.services.storage.model.Channel}
* @return the request
*/
public Stop stop(com.google.api.services.storage.model.Channel content) throws java.io.IOException {
Stop result = new Stop(content);
initialize(result);
return result;
}
public class Stop extends StorageRequest {
private static final String REST_PATH = "channels/stop";
/**
* Stop watching resources through this channel
*
* Create a request for the method "channels.stop".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Stop#execute()} method to invoke the remote operation. {@link
* Stop#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param content the {@link com.google.api.services.storage.model.Channel}
* @since 1.13
*/
protected Stop(com.google.api.services.storage.model.Channel content) {
super(Storage.this, "POST", REST_PATH, content, Void.class);
}
@Override
public Stop setAlt(java.lang.String alt) {
return (Stop) super.setAlt(alt);
}
@Override
public Stop setFields(java.lang.String fields) {
return (Stop) super.setFields(fields);
}
@Override
public Stop setKey(java.lang.String key) {
return (Stop) super.setKey(key);
}
@Override
public Stop setOauthToken(java.lang.String oauthToken) {
return (Stop) super.setOauthToken(oauthToken);
}
@Override
public Stop setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Stop) super.setPrettyPrint(prettyPrint);
}
@Override
public Stop setQuotaUser(java.lang.String quotaUser) {
return (Stop) super.setQuotaUser(quotaUser);
}
@Override
public Stop setUploadType(java.lang.String uploadType) {
return (Stop) super.setUploadType(uploadType);
}
@Override
public Stop setUserIp(java.lang.String userIp) {
return (Stop) super.setUserIp(userIp);
}
@Override
public Stop set(String parameterName, Object value) {
return (Stop) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the DefaultObjectAccessControls collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.DefaultObjectAccessControls.List request = storage.defaultObjectAccessControls().list(parameters ...)}
*
*
* @return the resource collection
*/
public DefaultObjectAccessControls defaultObjectAccessControls() {
return new DefaultObjectAccessControls();
}
/**
* The "defaultObjectAccessControls" collection of methods.
*/
public class DefaultObjectAccessControls {
/**
* Permanently deletes the default object ACL entry for the specified entity on the specified
* bucket.
*
* Create a request for the method "defaultObjectAccessControls.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String entity) throws java.io.IOException {
Delete result = new Delete(bucket, entity);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl/{entity}";
/**
* Permanently deletes the default object ACL entry for the specified entity on the specified
* bucket.
*
* Create a request for the method "defaultObjectAccessControls.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String entity) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Delete setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns the default object ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String entity) throws java.io.IOException {
Get result = new Get(bucket, entity);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl/{entity}";
/**
* Returns the default object ACL entry for the specified entity on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String entity) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Get setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates a new default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl";
/**
* Creates a new default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getEntity(), "ObjectAccessControl.getEntity()");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getRole(), "ObjectAccessControl.getRole()");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves default object ACL entries on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl";
/**
* Retrieves default object ACL entries on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ObjectAccessControls.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* If present, only return default ACL listing if the bucket's current metageneration matches
* this value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** If present, only return default ACL listing if the bucket's current metageneration matches this
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* If present, only return default ACL listing if the bucket's current metageneration matches
* this value.
*/
public List setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* If present, only return default ACL listing if the bucket's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** If present, only return default ACL listing if the bucket's current metageneration does not match
the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* If present, only return default ACL listing if the bucket's current metageneration does not
* match the given value.
*/
public List setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Patches a default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.patch".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Patch patch(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Patch result = new Patch(bucket, entity, content);
initialize(result);
return result;
}
public class Patch extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl/{entity}";
/**
* Patches a default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.patch".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation. {@link
* Patch#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Patch(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Patch setAlt(java.lang.String alt) {
return (Patch) super.setAlt(alt);
}
@Override
public Patch setFields(java.lang.String fields) {
return (Patch) super.setFields(fields);
}
@Override
public Patch setKey(java.lang.String key) {
return (Patch) super.setKey(key);
}
@Override
public Patch setOauthToken(java.lang.String oauthToken) {
return (Patch) super.setOauthToken(oauthToken);
}
@Override
public Patch setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Patch) super.setPrettyPrint(prettyPrint);
}
@Override
public Patch setQuotaUser(java.lang.String quotaUser) {
return (Patch) super.setQuotaUser(quotaUser);
}
@Override
public Patch setUploadType(java.lang.String uploadType) {
return (Patch) super.setUploadType(uploadType);
}
@Override
public Patch setUserIp(java.lang.String userIp) {
return (Patch) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Patch setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Patch setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Patch setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Patch set(String parameterName, Object value) {
return (Patch) super.set(parameterName, value);
}
}
/**
* Updates a default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Update update(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Update result = new Update(bucket, entity, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/defaultObjectAcl/{entity}";
/**
* Updates a default object ACL entry on the specified bucket.
*
* Create a request for the method "defaultObjectAccessControls.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Update(java.lang.String bucket, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Update setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Folders collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Folders.List request = storage.folders().list(parameters ...)}
*
*
* @return the resource collection
*/
public Folders folders() {
return new Folders();
}
/**
* The "folders" collection of methods.
*/
public class Folders {
/**
* Permanently deletes a folder. Only applicable to buckets with hierarchical namespace enabled.
*
* Create a request for the method "folders.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the folder resides.
* @param folder Name of a folder.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String folder) throws java.io.IOException {
Delete result = new Delete(bucket, folder);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/folders/{folder}";
/**
* Permanently deletes a folder. Only applicable to buckets with hierarchical namespace enabled.
*
* Create a request for the method "folders.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the folder resides.
* @param folder Name of a folder.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String folder) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.folder = com.google.api.client.util.Preconditions.checkNotNull(folder, "Required parameter folder must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of the bucket in which the folder resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the folder resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the folder resides. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Name of a folder. */
@com.google.api.client.util.Key
private java.lang.String folder;
/** Name of a folder.
*/
public java.lang.String getFolder() {
return folder;
}
/** Name of a folder. */
public Delete setFolder(java.lang.String folder) {
this.folder = folder;
return this;
}
/** If set, only deletes the folder if its metageneration matches this value. */
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** If set, only deletes the folder if its metageneration matches this value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/** If set, only deletes the folder if its metageneration matches this value. */
public Delete setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/** If set, only deletes the folder if its metageneration does not match this value. */
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** If set, only deletes the folder if its metageneration does not match this value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/** If set, only deletes the folder if its metageneration does not match this value. */
public Delete setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns metadata for the specified folder. Only applicable to buckets with hierarchical namespace
* enabled.
*
* Create a request for the method "folders.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the folder resides.
* @param folder Name of a folder.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String folder) throws java.io.IOException {
Get result = new Get(bucket, folder);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/folders/{folder}";
/**
* Returns metadata for the specified folder. Only applicable to buckets with hierarchical
* namespace enabled.
*
* Create a request for the method "folders.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the folder resides.
* @param folder Name of a folder.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String folder) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Folder.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.folder = com.google.api.client.util.Preconditions.checkNotNull(folder, "Required parameter folder must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of the bucket in which the folder resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the folder resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the folder resides. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Name of a folder. */
@com.google.api.client.util.Key
private java.lang.String folder;
/** Name of a folder.
*/
public java.lang.String getFolder() {
return folder;
}
/** Name of a folder. */
public Get setFolder(java.lang.String folder) {
this.folder = folder;
return this;
}
/**
* Makes the return of the folder metadata conditional on whether the folder's current
* metageneration matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the return of the folder metadata conditional on whether the folder's current metageneration
matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the return of the folder metadata conditional on whether the folder's current
* metageneration matches the given value.
*/
public Get setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the return of the folder metadata conditional on whether the folder's current
* metageneration does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the return of the folder metadata conditional on whether the folder's current metageneration
does not match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the return of the folder metadata conditional on whether the folder's current
* metageneration does not match the given value.
*/
public Get setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates a new folder. Only applicable to buckets with hierarchical namespace enabled.
*
* Create a request for the method "folders.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the folder resides.
* @param content the {@link com.google.api.services.storage.model.Folder}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.Folder content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/folders";
/**
* Creates a new folder. Only applicable to buckets with hierarchical namespace enabled.
*
* Create a request for the method "folders.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the folder resides.
* @param content the {@link com.google.api.services.storage.model.Folder}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.Folder content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.Folder.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of the bucket in which the folder resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the folder resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the folder resides. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** If true, any parent folder which doesn’t exist will be created automatically. */
@com.google.api.client.util.Key
private java.lang.Boolean recursive;
/** If true, any parent folder which doesn’t exist will be created automatically.
*/
public java.lang.Boolean getRecursive() {
return recursive;
}
/** If true, any parent folder which doesn’t exist will be created automatically. */
public Insert setRecursive(java.lang.Boolean recursive) {
this.recursive = recursive;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves a list of folders matching the criteria. Only applicable to buckets with hierarchical
* namespace enabled.
*
* Create a request for the method "folders.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which to look for folders.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/folders";
/**
* Retrieves a list of folders matching the criteria. Only applicable to buckets with hierarchical
* namespace enabled.
*
* Create a request for the method "folders.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which to look for folders.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Folders.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the bucket in which to look for folders. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which to look for folders.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which to look for folders. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Returns results in a directory-like mode. The only supported value is '/'. If set, items
* will only contain folders that either exactly match the prefix, or are one level below the
* prefix.
*/
@com.google.api.client.util.Key
private java.lang.String delimiter;
/** Returns results in a directory-like mode. The only supported value is '/'. If set, items will only
contain folders that either exactly match the prefix, or are one level below the prefix.
*/
public java.lang.String getDelimiter() {
return delimiter;
}
/**
* Returns results in a directory-like mode. The only supported value is '/'. If set, items
* will only contain folders that either exactly match the prefix, or are one level below the
* prefix.
*/
public List setDelimiter(java.lang.String delimiter) {
this.delimiter = delimiter;
return this;
}
/**
* Filter results to folders whose names are lexicographically before endOffset. If
* startOffset is also set, the folders listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String endOffset;
/** Filter results to folders whose names are lexicographically before endOffset. If startOffset is
also set, the folders listed will have names between startOffset (inclusive) and endOffset
(exclusive).
*/
public java.lang.String getEndOffset() {
return endOffset;
}
/**
* Filter results to folders whose names are lexicographically before endOffset. If
* startOffset is also set, the folders listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
public List setEndOffset(java.lang.String endOffset) {
this.endOffset = endOffset;
return this;
}
/** Maximum number of items to return in a single page of responses. */
@com.google.api.client.util.Key
private java.lang.Integer pageSize;
/** Maximum number of items to return in a single page of responses.
[minimum: 0]
*/
public java.lang.Integer getPageSize() {
return pageSize;
}
/** Maximum number of items to return in a single page of responses. */
public List setPageSize(java.lang.Integer pageSize) {
this.pageSize = pageSize;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/**
* Filter results to folders whose paths begin with this prefix. If set, the value must either
* be an empty string or end with a '/'.
*/
@com.google.api.client.util.Key
private java.lang.String prefix;
/** Filter results to folders whose paths begin with this prefix. If set, the value must either be an
empty string or end with a '/'.
*/
public java.lang.String getPrefix() {
return prefix;
}
/**
* Filter results to folders whose paths begin with this prefix. If set, the value must either
* be an empty string or end with a '/'.
*/
public List setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
/**
* Filter results to folders whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the folders listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String startOffset;
/** Filter results to folders whose names are lexicographically equal to or after startOffset. If
endOffset is also set, the folders listed will have names between startOffset (inclusive) and
endOffset (exclusive).
*/
public java.lang.String getStartOffset() {
return startOffset;
}
/**
* Filter results to folders whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the folders listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
public List setStartOffset(java.lang.String startOffset) {
this.startOffset = startOffset;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Renames a source folder to a destination folder. Only applicable to buckets with hierarchical
* namespace enabled.
*
* Create a request for the method "folders.rename".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Rename#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the folders are in.
* @param sourceFolder Name of the source folder.
* @param destinationFolder Name of the destination folder.
* @return the request
*/
public Rename rename(java.lang.String bucket, java.lang.String sourceFolder, java.lang.String destinationFolder) throws java.io.IOException {
Rename result = new Rename(bucket, sourceFolder, destinationFolder);
initialize(result);
return result;
}
public class Rename extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/folders/{sourceFolder}/renameTo/folders/{destinationFolder}";
/**
* Renames a source folder to a destination folder. Only applicable to buckets with hierarchical
* namespace enabled.
*
* Create a request for the method "folders.rename".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Rename#execute()} method to invoke the remote operation. {@link
* Rename#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the folders are in.
* @param sourceFolder Name of the source folder.
* @param destinationFolder Name of the destination folder.
* @since 1.13
*/
protected Rename(java.lang.String bucket, java.lang.String sourceFolder, java.lang.String destinationFolder) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.GoogleLongrunningOperation.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.sourceFolder = com.google.api.client.util.Preconditions.checkNotNull(sourceFolder, "Required parameter sourceFolder must be specified.");
this.destinationFolder = com.google.api.client.util.Preconditions.checkNotNull(destinationFolder, "Required parameter destinationFolder must be specified.");
}
@Override
public Rename setAlt(java.lang.String alt) {
return (Rename) super.setAlt(alt);
}
@Override
public Rename setFields(java.lang.String fields) {
return (Rename) super.setFields(fields);
}
@Override
public Rename setKey(java.lang.String key) {
return (Rename) super.setKey(key);
}
@Override
public Rename setOauthToken(java.lang.String oauthToken) {
return (Rename) super.setOauthToken(oauthToken);
}
@Override
public Rename setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Rename) super.setPrettyPrint(prettyPrint);
}
@Override
public Rename setQuotaUser(java.lang.String quotaUser) {
return (Rename) super.setQuotaUser(quotaUser);
}
@Override
public Rename setUploadType(java.lang.String uploadType) {
return (Rename) super.setUploadType(uploadType);
}
@Override
public Rename setUserIp(java.lang.String userIp) {
return (Rename) super.setUserIp(userIp);
}
/** Name of the bucket in which the folders are in. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the folders are in.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the folders are in. */
public Rename setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Name of the source folder. */
@com.google.api.client.util.Key
private java.lang.String sourceFolder;
/** Name of the source folder.
*/
public java.lang.String getSourceFolder() {
return sourceFolder;
}
/** Name of the source folder. */
public Rename setSourceFolder(java.lang.String sourceFolder) {
this.sourceFolder = sourceFolder;
return this;
}
/** Name of the destination folder. */
@com.google.api.client.util.Key
private java.lang.String destinationFolder;
/** Name of the destination folder.
*/
public java.lang.String getDestinationFolder() {
return destinationFolder;
}
/** Name of the destination folder. */
public Rename setDestinationFolder(java.lang.String destinationFolder) {
this.destinationFolder = destinationFolder;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationMatch;
/** Makes the operation conditional on whether the source object's current metageneration matches the
given value.
*/
public java.lang.Long getIfSourceMetagenerationMatch() {
return ifSourceMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
public Rename setIfSourceMetagenerationMatch(java.lang.Long ifSourceMetagenerationMatch) {
this.ifSourceMetagenerationMatch = ifSourceMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationNotMatch;
/** Makes the operation conditional on whether the source object's current metageneration does not
match the given value.
*/
public java.lang.Long getIfSourceMetagenerationNotMatch() {
return ifSourceMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
public Rename setIfSourceMetagenerationNotMatch(java.lang.Long ifSourceMetagenerationNotMatch) {
this.ifSourceMetagenerationNotMatch = ifSourceMetagenerationNotMatch;
return this;
}
@Override
public Rename set(String parameterName, Object value) {
return (Rename) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the ManagedFolders collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.ManagedFolders.List request = storage.managedFolders().list(parameters ...)}
*
*
* @return the resource collection
*/
public ManagedFolders managedFolders() {
return new ManagedFolders();
}
/**
* The "managedFolders" collection of methods.
*/
public class ManagedFolders {
/**
* Permanently deletes a managed folder.
*
* Create a request for the method "managedFolders.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String managedFolder) throws java.io.IOException {
Delete result = new Delete(bucket, managedFolder);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders/{managedFolder}";
/**
* Permanently deletes a managed folder.
*
* Create a request for the method "managedFolders.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String managedFolder) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.managedFolder = com.google.api.client.util.Preconditions.checkNotNull(managedFolder, "Required parameter managedFolder must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The managed folder name/path. */
@com.google.api.client.util.Key
private java.lang.String managedFolder;
/** The managed folder name/path.
*/
public java.lang.String getManagedFolder() {
return managedFolder;
}
/** The managed folder name/path. */
public Delete setManagedFolder(java.lang.String managedFolder) {
this.managedFolder = managedFolder;
return this;
}
/**
* Allows the deletion of a managed folder even if it is not empty. A managed folder is empty
* if there are no objects or managed folders that it applies to. Callers must have
* storage.managedFolders.setIamPolicy permission.
*/
@com.google.api.client.util.Key
private java.lang.Boolean allowNonEmpty;
/** Allows the deletion of a managed folder even if it is not empty. A managed folder is empty if there
are no objects or managed folders that it applies to. Callers must have
storage.managedFolders.setIamPolicy permission.
*/
public java.lang.Boolean getAllowNonEmpty() {
return allowNonEmpty;
}
/**
* Allows the deletion of a managed folder even if it is not empty. A managed folder is empty
* if there are no objects or managed folders that it applies to. Callers must have
* storage.managedFolders.setIamPolicy permission.
*/
public Delete setAllowNonEmpty(java.lang.Boolean allowNonEmpty) {
this.allowNonEmpty = allowNonEmpty;
return this;
}
/** If set, only deletes the managed folder if its metageneration matches this value. */
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** If set, only deletes the managed folder if its metageneration matches this value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/** If set, only deletes the managed folder if its metageneration matches this value. */
public Delete setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* If set, only deletes the managed folder if its metageneration does not match this value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** If set, only deletes the managed folder if its metageneration does not match this value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* If set, only deletes the managed folder if its metageneration does not match this value.
*/
public Delete setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns metadata of the specified managed folder.
*
* Create a request for the method "managedFolders.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String managedFolder) throws java.io.IOException {
Get result = new Get(bucket, managedFolder);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders/{managedFolder}";
/**
* Returns metadata of the specified managed folder.
*
* Create a request for the method "managedFolders.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String managedFolder) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ManagedFolder.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.managedFolder = com.google.api.client.util.Preconditions.checkNotNull(managedFolder, "Required parameter managedFolder must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The managed folder name/path. */
@com.google.api.client.util.Key
private java.lang.String managedFolder;
/** The managed folder name/path.
*/
public java.lang.String getManagedFolder() {
return managedFolder;
}
/** The managed folder name/path. */
public Get setManagedFolder(java.lang.String managedFolder) {
this.managedFolder = managedFolder;
return this;
}
/**
* Makes the return of the managed folder metadata conditional on whether the managed folder's
* current metageneration matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the return of the managed folder metadata conditional on whether the managed folder's current
metageneration matches the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the return of the managed folder metadata conditional on whether the managed folder's
* current metageneration matches the given value.
*/
public Get setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the return of the managed folder metadata conditional on whether the managed folder's
* current metageneration does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the return of the managed folder metadata conditional on whether the managed folder's current
metageneration does not match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the return of the managed folder metadata conditional on whether the managed folder's
* current metageneration does not match the given value.
*/
public Get setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Returns an IAM policy for the specified managed folder.
*
* Create a request for the method "managedFolders.getIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @return the request
*/
public GetIamPolicy getIamPolicy(java.lang.String bucket, java.lang.String managedFolder) throws java.io.IOException {
GetIamPolicy result = new GetIamPolicy(bucket, managedFolder);
initialize(result);
return result;
}
public class GetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders/{managedFolder}/iam";
/**
* Returns an IAM policy for the specified managed folder.
*
* Create a request for the method "managedFolders.getIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* GetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @since 1.13
*/
protected GetIamPolicy(java.lang.String bucket, java.lang.String managedFolder) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.managedFolder = com.google.api.client.util.Preconditions.checkNotNull(managedFolder, "Required parameter managedFolder must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public GetIamPolicy setAlt(java.lang.String alt) {
return (GetIamPolicy) super.setAlt(alt);
}
@Override
public GetIamPolicy setFields(java.lang.String fields) {
return (GetIamPolicy) super.setFields(fields);
}
@Override
public GetIamPolicy setKey(java.lang.String key) {
return (GetIamPolicy) super.setKey(key);
}
@Override
public GetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (GetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public GetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (GetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public GetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (GetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public GetIamPolicy setUploadType(java.lang.String uploadType) {
return (GetIamPolicy) super.setUploadType(uploadType);
}
@Override
public GetIamPolicy setUserIp(java.lang.String userIp) {
return (GetIamPolicy) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public GetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The managed folder name/path. */
@com.google.api.client.util.Key
private java.lang.String managedFolder;
/** The managed folder name/path.
*/
public java.lang.String getManagedFolder() {
return managedFolder;
}
/** The managed folder name/path. */
public GetIamPolicy setManagedFolder(java.lang.String managedFolder) {
this.managedFolder = managedFolder;
return this;
}
/**
* The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for
* an older version that doesn't support part of the requested IAM policy, the request fails.
*/
@com.google.api.client.util.Key
private java.lang.Integer optionsRequestedPolicyVersion;
/** The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for an older
version that doesn't support part of the requested IAM policy, the request fails.
[minimum: 1]
*/
public java.lang.Integer getOptionsRequestedPolicyVersion() {
return optionsRequestedPolicyVersion;
}
/**
* The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for
* an older version that doesn't support part of the requested IAM policy, the request fails.
*/
public GetIamPolicy setOptionsRequestedPolicyVersion(java.lang.Integer optionsRequestedPolicyVersion) {
this.optionsRequestedPolicyVersion = optionsRequestedPolicyVersion;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public GetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public GetIamPolicy set(String parameterName, Object value) {
return (GetIamPolicy) super.set(parameterName, value);
}
}
/**
* Creates a new managed folder.
*
* Create a request for the method "managedFolders.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param content the {@link com.google.api.services.storage.model.ManagedFolder}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.ManagedFolder content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders";
/**
* Creates a new managed folder.
*
* Create a request for the method "managedFolders.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param content the {@link com.google.api.services.storage.model.ManagedFolder}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.ManagedFolder content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.ManagedFolder.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Lists managed folders in the given bucket.
*
* Create a request for the method "managedFolders.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders";
/**
* Lists managed folders in the given bucket.
*
* Create a request for the method "managedFolders.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ManagedFolders.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Maximum number of items to return in a single page of responses. */
@com.google.api.client.util.Key
private java.lang.Integer pageSize;
/** Maximum number of items to return in a single page of responses.
[minimum: 0]
*/
public java.lang.Integer getPageSize() {
return pageSize;
}
/** Maximum number of items to return in a single page of responses. */
public List setPageSize(java.lang.Integer pageSize) {
this.pageSize = pageSize;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/** The managed folder name/path prefix to filter the output list of results. */
@com.google.api.client.util.Key
private java.lang.String prefix;
/** The managed folder name/path prefix to filter the output list of results.
*/
public java.lang.String getPrefix() {
return prefix;
}
/** The managed folder name/path prefix to filter the output list of results. */
public List setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Updates an IAM policy for the specified managed folder.
*
* Create a request for the method "managedFolders.setIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @param content the {@link com.google.api.services.storage.model.Policy}
* @return the request
*/
public SetIamPolicy setIamPolicy(java.lang.String bucket, java.lang.String managedFolder, com.google.api.services.storage.model.Policy content) throws java.io.IOException {
SetIamPolicy result = new SetIamPolicy(bucket, managedFolder, content);
initialize(result);
return result;
}
public class SetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders/{managedFolder}/iam";
/**
* Updates an IAM policy for the specified managed folder.
*
* Create a request for the method "managedFolders.setIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* SetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @param content the {@link com.google.api.services.storage.model.Policy}
* @since 1.13
*/
protected SetIamPolicy(java.lang.String bucket, java.lang.String managedFolder, com.google.api.services.storage.model.Policy content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.managedFolder = com.google.api.client.util.Preconditions.checkNotNull(managedFolder, "Required parameter managedFolder must be specified.");
}
@Override
public SetIamPolicy setAlt(java.lang.String alt) {
return (SetIamPolicy) super.setAlt(alt);
}
@Override
public SetIamPolicy setFields(java.lang.String fields) {
return (SetIamPolicy) super.setFields(fields);
}
@Override
public SetIamPolicy setKey(java.lang.String key) {
return (SetIamPolicy) super.setKey(key);
}
@Override
public SetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (SetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public SetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (SetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public SetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (SetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public SetIamPolicy setUploadType(java.lang.String uploadType) {
return (SetIamPolicy) super.setUploadType(uploadType);
}
@Override
public SetIamPolicy setUserIp(java.lang.String userIp) {
return (SetIamPolicy) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public SetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The managed folder name/path. */
@com.google.api.client.util.Key
private java.lang.String managedFolder;
/** The managed folder name/path.
*/
public java.lang.String getManagedFolder() {
return managedFolder;
}
/** The managed folder name/path. */
public SetIamPolicy setManagedFolder(java.lang.String managedFolder) {
this.managedFolder = managedFolder;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public SetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public SetIamPolicy set(String parameterName, Object value) {
return (SetIamPolicy) super.set(parameterName, value);
}
}
/**
* Tests a set of permissions on the given managed folder to see which, if any, are held by the
* caller.
*
* Create a request for the method "managedFolders.testIamPermissions".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @param permissions Permissions to test.
* @return the request
*/
public TestIamPermissions testIamPermissions(java.lang.String bucket, java.lang.String managedFolder, java.util.List permissions) throws java.io.IOException {
TestIamPermissions result = new TestIamPermissions(bucket, managedFolder, permissions);
initialize(result);
return result;
}
public class TestIamPermissions extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/managedFolders/{managedFolder}/iam/testPermissions";
/**
* Tests a set of permissions on the given managed folder to see which, if any, are held by the
* caller.
*
* Create a request for the method "managedFolders.testIamPermissions".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote
* operation. {@link TestIamPermissions#initialize(com.google.api.client.googleapis.services.A
* bstractGoogleClientRequest)} must be called to initialize this instance immediately after
* invoking the constructor.
*
* @param bucket Name of the bucket containing the managed folder.
* @param managedFolder The managed folder name/path.
* @param permissions Permissions to test.
* @since 1.13
*/
protected TestIamPermissions(java.lang.String bucket, java.lang.String managedFolder, java.util.List permissions) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.TestIamPermissionsResponse.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.managedFolder = com.google.api.client.util.Preconditions.checkNotNull(managedFolder, "Required parameter managedFolder must be specified.");
this.permissions = com.google.api.client.util.Preconditions.checkNotNull(permissions, "Required parameter permissions must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public TestIamPermissions setAlt(java.lang.String alt) {
return (TestIamPermissions) super.setAlt(alt);
}
@Override
public TestIamPermissions setFields(java.lang.String fields) {
return (TestIamPermissions) super.setFields(fields);
}
@Override
public TestIamPermissions setKey(java.lang.String key) {
return (TestIamPermissions) super.setKey(key);
}
@Override
public TestIamPermissions setOauthToken(java.lang.String oauthToken) {
return (TestIamPermissions) super.setOauthToken(oauthToken);
}
@Override
public TestIamPermissions setPrettyPrint(java.lang.Boolean prettyPrint) {
return (TestIamPermissions) super.setPrettyPrint(prettyPrint);
}
@Override
public TestIamPermissions setQuotaUser(java.lang.String quotaUser) {
return (TestIamPermissions) super.setQuotaUser(quotaUser);
}
@Override
public TestIamPermissions setUploadType(java.lang.String uploadType) {
return (TestIamPermissions) super.setUploadType(uploadType);
}
@Override
public TestIamPermissions setUserIp(java.lang.String userIp) {
return (TestIamPermissions) super.setUserIp(userIp);
}
/** Name of the bucket containing the managed folder. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket containing the managed folder.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket containing the managed folder. */
public TestIamPermissions setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The managed folder name/path. */
@com.google.api.client.util.Key
private java.lang.String managedFolder;
/** The managed folder name/path.
*/
public java.lang.String getManagedFolder() {
return managedFolder;
}
/** The managed folder name/path. */
public TestIamPermissions setManagedFolder(java.lang.String managedFolder) {
this.managedFolder = managedFolder;
return this;
}
/** Permissions to test. */
@com.google.api.client.util.Key
private java.util.List permissions;
/** Permissions to test.
*/
public java.util.List getPermissions() {
return permissions;
}
/** Permissions to test. */
public TestIamPermissions setPermissions(java.util.List permissions) {
this.permissions = permissions;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public TestIamPermissions setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public TestIamPermissions set(String parameterName, Object value) {
return (TestIamPermissions) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Notifications collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Notifications.List request = storage.notifications().list(parameters ...)}
*
*
* @return the resource collection
*/
public Notifications notifications() {
return new Notifications();
}
/**
* The "notifications" collection of methods.
*/
public class Notifications {
/**
* Permanently deletes a notification subscription.
*
* Create a request for the method "notifications.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket The parent bucket of the notification.
* @param notification ID of the notification to delete.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String notification) throws java.io.IOException {
Delete result = new Delete(bucket, notification);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/notificationConfigs/{notification}";
/**
* Permanently deletes a notification subscription.
*
* Create a request for the method "notifications.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket The parent bucket of the notification.
* @param notification ID of the notification to delete.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String notification) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.notification = com.google.api.client.util.Preconditions.checkNotNull(notification, "Required parameter notification must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** The parent bucket of the notification. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** The parent bucket of the notification.
*/
public java.lang.String getBucket() {
return bucket;
}
/** The parent bucket of the notification. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** ID of the notification to delete. */
@com.google.api.client.util.Key
private java.lang.String notification;
/** ID of the notification to delete.
*/
public java.lang.String getNotification() {
return notification;
}
/** ID of the notification to delete. */
public Delete setNotification(java.lang.String notification) {
this.notification = notification;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* View a notification configuration.
*
* Create a request for the method "notifications.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket The parent bucket of the notification.
* @param notification Notification ID
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String notification) throws java.io.IOException {
Get result = new Get(bucket, notification);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/notificationConfigs/{notification}";
/**
* View a notification configuration.
*
* Create a request for the method "notifications.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket The parent bucket of the notification.
* @param notification Notification ID
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String notification) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Notification.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.notification = com.google.api.client.util.Preconditions.checkNotNull(notification, "Required parameter notification must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** The parent bucket of the notification. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** The parent bucket of the notification.
*/
public java.lang.String getBucket() {
return bucket;
}
/** The parent bucket of the notification. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** Notification ID */
@com.google.api.client.util.Key
private java.lang.String notification;
/** Notification ID
*/
public java.lang.String getNotification() {
return notification;
}
/** Notification ID */
public Get setNotification(java.lang.String notification) {
this.notification = notification;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates a notification subscription for a given bucket.
*
* Create a request for the method "notifications.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket The parent bucket of the notification.
* @param content the {@link com.google.api.services.storage.model.Notification}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.Notification content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/notificationConfigs";
/**
* Creates a notification subscription for a given bucket.
*
* Create a request for the method "notifications.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket The parent bucket of the notification.
* @param content the {@link com.google.api.services.storage.model.Notification}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.Notification content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.Notification.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getPayloadFormat(), "Notification.getPayloadFormat()");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getTopic(), "Notification.getTopic()");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** The parent bucket of the notification. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** The parent bucket of the notification.
*/
public java.lang.String getBucket() {
return bucket;
}
/** The parent bucket of the notification. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves a list of notification subscriptions for a given bucket.
*
* Create a request for the method "notifications.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of a Google Cloud Storage bucket.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/notificationConfigs";
/**
* Retrieves a list of notification subscriptions for a given bucket.
*
* Create a request for the method "notifications.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a Google Cloud Storage bucket.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Notifications.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of a Google Cloud Storage bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a Google Cloud Storage bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a Google Cloud Storage bucket. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the ObjectAccessControls collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.ObjectAccessControls.List request = storage.objectAccessControls().list(parameters ...)}
*
*
* @return the resource collection
*/
public ObjectAccessControls objectAccessControls() {
return new ObjectAccessControls();
}
/**
* The "objectAccessControls" collection of methods.
*/
public class ObjectAccessControls {
/**
* Permanently deletes the ACL entry for the specified entity on the specified object.
*
* Create a request for the method "objectAccessControls.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String object__, java.lang.String entity) throws java.io.IOException {
Delete result = new Delete(bucket, object__, entity);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl/{entity}";
/**
* Permanently deletes the ACL entry for the specified entity on the specified object.
*
* Create a request for the method "objectAccessControls.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String object__, java.lang.String entity) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Delete setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Delete setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Delete setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Returns the ACL entry for the specified entity on the specified object.
*
* Create a request for the method "objectAccessControls.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String object__, java.lang.String entity) throws java.io.IOException {
Get result = new Get(bucket, object__, entity);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl/{entity}";
/**
* Returns the ACL entry for the specified entity on the specified object.
*
* Create a request for the method "objectAccessControls.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String object__, java.lang.String entity) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Get setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Get setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Get setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Creates a new ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Insert insert(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Insert result = new Insert(bucket, object__, content);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl";
/**
* Creates a new ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Insert(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getEntity(), "ObjectAccessControl.getEntity()");
checkRequiredParameter(content, "content");
checkRequiredParameter(content.getRole(), "ObjectAccessControl.getRole()");
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Insert setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Insert setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves ACL entries on the specified object.
*
* Create a request for the method "objectAccessControls.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @return the request
*/
public List list(java.lang.String bucket, java.lang.String object__) throws java.io.IOException {
List result = new List(bucket, object__);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl";
/**
* Retrieves ACL entries on the specified object.
*
* Create a request for the method "objectAccessControls.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @since 1.13
*/
protected List(java.lang.String bucket, java.lang.String object__) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ObjectAccessControls.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public List setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public List setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Patches an ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.patch".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Patch patch(java.lang.String bucket, java.lang.String object__, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Patch result = new Patch(bucket, object__, entity, content);
initialize(result);
return result;
}
public class Patch extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl/{entity}";
/**
* Patches an ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.patch".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation. {@link
* Patch#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Patch(java.lang.String bucket, java.lang.String object__, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Patch setAlt(java.lang.String alt) {
return (Patch) super.setAlt(alt);
}
@Override
public Patch setFields(java.lang.String fields) {
return (Patch) super.setFields(fields);
}
@Override
public Patch setKey(java.lang.String key) {
return (Patch) super.setKey(key);
}
@Override
public Patch setOauthToken(java.lang.String oauthToken) {
return (Patch) super.setOauthToken(oauthToken);
}
@Override
public Patch setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Patch) super.setPrettyPrint(prettyPrint);
}
@Override
public Patch setQuotaUser(java.lang.String quotaUser) {
return (Patch) super.setQuotaUser(quotaUser);
}
@Override
public Patch setUploadType(java.lang.String uploadType) {
return (Patch) super.setUploadType(uploadType);
}
@Override
public Patch setUserIp(java.lang.String userIp) {
return (Patch) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Patch setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Patch setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Patch setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Patch setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Patch setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Patch set(String parameterName, Object value) {
return (Patch) super.set(parameterName, value);
}
}
/**
* Updates an ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @return the request
*/
public Update update(java.lang.String bucket, java.lang.String object__, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) throws java.io.IOException {
Update result = new Update(bucket, object__, entity, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/acl/{entity}";
/**
* Updates an ACL entry on the specified object.
*
* Create a request for the method "objectAccessControls.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of a bucket.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param entity The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
* emailAddress, allUsers, or allAuthenticatedUsers.
* @param content the {@link com.google.api.services.storage.model.ObjectAccessControl}
* @since 1.13
*/
protected Update(java.lang.String bucket, java.lang.String object__, java.lang.String entity, com.google.api.services.storage.model.ObjectAccessControl content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.ObjectAccessControl.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.entity = com.google.api.client.util.Preconditions.checkNotNull(entity, "Required parameter entity must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of a bucket. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of a bucket.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of a bucket. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Update setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
@com.google.api.client.util.Key
private java.lang.String entity;
/** The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-
emailAddress, allUsers, or allAuthenticatedUsers.
*/
public java.lang.String getEntity() {
return entity;
}
/**
* The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId,
* group-emailAddress, allUsers, or allAuthenticatedUsers.
*/
public Update setEntity(java.lang.String entity) {
this.entity = entity;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Update setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Objects collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Objects.List request = storage.objects().list(parameters ...)}
*
*
* @return the resource collection
*/
public Objects objects() {
return new Objects();
}
/**
* The "objects" collection of methods.
*/
public class Objects {
/**
* Initiates a long-running bulk restore operation on the specified bucket.
*
* Create a request for the method "objects.bulkRestore".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link BulkRestore#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param content the {@link com.google.api.services.storage.model.BulkRestoreObjectsRequest}
* @return the request
*/
public BulkRestore bulkRestore(java.lang.String bucket, com.google.api.services.storage.model.BulkRestoreObjectsRequest content) throws java.io.IOException {
BulkRestore result = new BulkRestore(bucket, content);
initialize(result);
return result;
}
public class BulkRestore extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/bulkRestore";
/**
* Initiates a long-running bulk restore operation on the specified bucket.
*
* Create a request for the method "objects.bulkRestore".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link BulkRestore#execute()} method to invoke the remote operation.
* {@link
* BulkRestore#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param content the {@link com.google.api.services.storage.model.BulkRestoreObjectsRequest}
* @since 1.13
*/
protected BulkRestore(java.lang.String bucket, com.google.api.services.storage.model.BulkRestoreObjectsRequest content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.GoogleLongrunningOperation.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public BulkRestore setAlt(java.lang.String alt) {
return (BulkRestore) super.setAlt(alt);
}
@Override
public BulkRestore setFields(java.lang.String fields) {
return (BulkRestore) super.setFields(fields);
}
@Override
public BulkRestore setKey(java.lang.String key) {
return (BulkRestore) super.setKey(key);
}
@Override
public BulkRestore setOauthToken(java.lang.String oauthToken) {
return (BulkRestore) super.setOauthToken(oauthToken);
}
@Override
public BulkRestore setPrettyPrint(java.lang.Boolean prettyPrint) {
return (BulkRestore) super.setPrettyPrint(prettyPrint);
}
@Override
public BulkRestore setQuotaUser(java.lang.String quotaUser) {
return (BulkRestore) super.setQuotaUser(quotaUser);
}
@Override
public BulkRestore setUploadType(java.lang.String uploadType) {
return (BulkRestore) super.setUploadType(uploadType);
}
@Override
public BulkRestore setUserIp(java.lang.String userIp) {
return (BulkRestore) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public BulkRestore setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
@Override
public BulkRestore set(String parameterName, Object value) {
return (BulkRestore) super.set(parameterName, value);
}
}
/**
* Concatenates a list of existing objects into a new object in the same bucket.
*
* Create a request for the method "objects.compose".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Compose#execute()} method to invoke the remote operation.
*
* @param destinationBucket Name of the bucket containing the source objects. The destination object is stored in this bucket.
* @param destinationObject Name of the new object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.ComposeRequest}
* @return the request
*/
public Compose compose(java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.ComposeRequest content) throws java.io.IOException {
Compose result = new Compose(destinationBucket, destinationObject, content);
initialize(result);
return result;
}
public class Compose extends StorageRequest {
private static final String REST_PATH = "b/{destinationBucket}/o/{destinationObject}/compose";
/**
* Concatenates a list of existing objects into a new object in the same bucket.
*
* Create a request for the method "objects.compose".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Compose#execute()} method to invoke the remote operation.
* {@link
* Compose#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param destinationBucket Name of the bucket containing the source objects. The destination object is stored in this bucket.
* @param destinationObject Name of the new object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.ComposeRequest}
* @since 1.13
*/
protected Compose(java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.ComposeRequest content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.destinationBucket = com.google.api.client.util.Preconditions.checkNotNull(destinationBucket, "Required parameter destinationBucket must be specified.");
this.destinationObject = com.google.api.client.util.Preconditions.checkNotNull(destinationObject, "Required parameter destinationObject must be specified.");
}
@Override
public Compose setAlt(java.lang.String alt) {
return (Compose) super.setAlt(alt);
}
@Override
public Compose setFields(java.lang.String fields) {
return (Compose) super.setFields(fields);
}
@Override
public Compose setKey(java.lang.String key) {
return (Compose) super.setKey(key);
}
@Override
public Compose setOauthToken(java.lang.String oauthToken) {
return (Compose) super.setOauthToken(oauthToken);
}
@Override
public Compose setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Compose) super.setPrettyPrint(prettyPrint);
}
@Override
public Compose setQuotaUser(java.lang.String quotaUser) {
return (Compose) super.setQuotaUser(quotaUser);
}
@Override
public Compose setUploadType(java.lang.String uploadType) {
return (Compose) super.setUploadType(uploadType);
}
@Override
public Compose setUserIp(java.lang.String userIp) {
return (Compose) super.setUserIp(userIp);
}
/**
* Name of the bucket containing the source objects. The destination object is stored in this
* bucket.
*/
@com.google.api.client.util.Key
private java.lang.String destinationBucket;
/** Name of the bucket containing the source objects. The destination object is stored in this bucket.
*/
public java.lang.String getDestinationBucket() {
return destinationBucket;
}
/**
* Name of the bucket containing the source objects. The destination object is stored in this
* bucket.
*/
public Compose setDestinationBucket(java.lang.String destinationBucket) {
this.destinationBucket = destinationBucket;
return this;
}
/**
* Name of the new object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String destinationObject;
/** Name of the new object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getDestinationObject() {
return destinationObject;
}
/**
* Name of the new object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Compose setDestinationObject(java.lang.String destinationObject) {
this.destinationObject = destinationObject;
return this;
}
/** Apply a predefined set of access controls to the destination object. */
@com.google.api.client.util.Key
private java.lang.String destinationPredefinedAcl;
/** Apply a predefined set of access controls to the destination object.
*/
public java.lang.String getDestinationPredefinedAcl() {
return destinationPredefinedAcl;
}
/** Apply a predefined set of access controls to the destination object. */
public Compose setDestinationPredefinedAcl(java.lang.String destinationPredefinedAcl) {
this.destinationPredefinedAcl = destinationPredefinedAcl;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Compose setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Compose setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String kmsKeyName;
/** Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-
kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
*/
public java.lang.String getKmsKeyName() {
return kmsKeyName;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
public Compose setKmsKeyName(java.lang.String kmsKeyName) {
this.kmsKeyName = kmsKeyName;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Compose setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Compose set(String parameterName, Object value) {
return (Compose) super.set(parameterName, value);
}
}
/**
* Copies a source object to a destination object. Optionally overrides metadata.
*
* Create a request for the method "objects.copy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Copy#execute()} method to invoke the remote operation.
*
* @param sourceBucket Name of the bucket in which to find the source object.
* @param sourceObject Name of the source object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationBucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationObject Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
* object metadata's name value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @return the request
*/
public Copy copy(java.lang.String sourceBucket, java.lang.String sourceObject, java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.StorageObject content) throws java.io.IOException {
Copy result = new Copy(sourceBucket, sourceObject, destinationBucket, destinationObject, content);
initialize(result);
return result;
}
public class Copy extends StorageRequest {
private static final String REST_PATH = "b/{sourceBucket}/o/{sourceObject}/copyTo/b/{destinationBucket}/o/{destinationObject}";
/**
* Copies a source object to a destination object. Optionally overrides metadata.
*
* Create a request for the method "objects.copy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Copy#execute()} method to invoke the remote operation. {@link
* Copy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param sourceBucket Name of the bucket in which to find the source object.
* @param sourceObject Name of the source object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationBucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationObject Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
* object metadata's name value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @since 1.13
*/
protected Copy(java.lang.String sourceBucket, java.lang.String sourceObject, java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.StorageObject content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.sourceBucket = com.google.api.client.util.Preconditions.checkNotNull(sourceBucket, "Required parameter sourceBucket must be specified.");
this.sourceObject = com.google.api.client.util.Preconditions.checkNotNull(sourceObject, "Required parameter sourceObject must be specified.");
this.destinationBucket = com.google.api.client.util.Preconditions.checkNotNull(destinationBucket, "Required parameter destinationBucket must be specified.");
this.destinationObject = com.google.api.client.util.Preconditions.checkNotNull(destinationObject, "Required parameter destinationObject must be specified.");
}
@Override
public Copy setAlt(java.lang.String alt) {
return (Copy) super.setAlt(alt);
}
@Override
public Copy setFields(java.lang.String fields) {
return (Copy) super.setFields(fields);
}
@Override
public Copy setKey(java.lang.String key) {
return (Copy) super.setKey(key);
}
@Override
public Copy setOauthToken(java.lang.String oauthToken) {
return (Copy) super.setOauthToken(oauthToken);
}
@Override
public Copy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Copy) super.setPrettyPrint(prettyPrint);
}
@Override
public Copy setQuotaUser(java.lang.String quotaUser) {
return (Copy) super.setQuotaUser(quotaUser);
}
@Override
public Copy setUploadType(java.lang.String uploadType) {
return (Copy) super.setUploadType(uploadType);
}
@Override
public Copy setUserIp(java.lang.String userIp) {
return (Copy) super.setUserIp(userIp);
}
/** Name of the bucket in which to find the source object. */
@com.google.api.client.util.Key
private java.lang.String sourceBucket;
/** Name of the bucket in which to find the source object.
*/
public java.lang.String getSourceBucket() {
return sourceBucket;
}
/** Name of the bucket in which to find the source object. */
public Copy setSourceBucket(java.lang.String sourceBucket) {
this.sourceBucket = sourceBucket;
return this;
}
/**
* Name of the source object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String sourceObject;
/** Name of the source object. For information about how to URL encode object names to be path safe,
see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getSourceObject() {
return sourceObject;
}
/**
* Name of the source object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Copy setSourceObject(java.lang.String sourceObject) {
this.sourceObject = sourceObject;
return this;
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.For information about how to URL encode object names to be
* path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String destinationBucket;
/** Name of the bucket in which to store the new object. Overrides the provided object metadata's
bucket value, if any.For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getDestinationBucket() {
return destinationBucket;
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.For information about how to URL encode object names to be
* path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Copy setDestinationBucket(java.lang.String destinationBucket) {
this.destinationBucket = destinationBucket;
return this;
}
/**
* Name of the new object. Required when the object metadata is not otherwise provided.
* Overrides the object metadata's name value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String destinationObject;
/** Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
object metadata's name value, if any.
*/
public java.lang.String getDestinationObject() {
return destinationObject;
}
/**
* Name of the new object. Required when the object metadata is not otherwise provided.
* Overrides the object metadata's name value, if any.
*/
public Copy setDestinationObject(java.lang.String destinationObject) {
this.destinationObject = destinationObject;
return this;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String destinationKmsKeyName;
/** Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-
kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
*/
public java.lang.String getDestinationKmsKeyName() {
return destinationKmsKeyName;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
public Copy setDestinationKmsKeyName(java.lang.String destinationKmsKeyName) {
this.destinationKmsKeyName = destinationKmsKeyName;
return this;
}
/** Apply a predefined set of access controls to the destination object. */
@com.google.api.client.util.Key
private java.lang.String destinationPredefinedAcl;
/** Apply a predefined set of access controls to the destination object.
*/
public java.lang.String getDestinationPredefinedAcl() {
return destinationPredefinedAcl;
}
/** Apply a predefined set of access controls to the destination object. */
public Copy setDestinationPredefinedAcl(java.lang.String destinationPredefinedAcl) {
this.destinationPredefinedAcl = destinationPredefinedAcl;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current generation
* matches the given value. Setting to 0 makes the operation succeed only if there are no live
* versions of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the destination object's current generation matches the
given value. Setting to 0 makes the operation succeed only if there are no live versions of the
object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the destination object's current generation
* matches the given value. Setting to 0 makes the operation succeed only if there are no live
* versions of the object.
*/
public Copy setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current generation does
* not match the given value. If no live object exists, the precondition fails. Setting to 0
* makes the operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the destination object's current generation does not
match the given value. If no live object exists, the precondition fails. Setting to 0 makes the
operation succeed only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the destination object's current generation does
* not match the given value. If no live object exists, the precondition fails. Setting to 0
* makes the operation succeed only if there is a live version of the object.
*/
public Copy setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the destination object's current metageneration matches
the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* matches the given value.
*/
public Copy setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the destination object's current metageneration does not
match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* does not match the given value.
*/
public Copy setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current generation matches
* the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceGenerationMatch;
/** Makes the operation conditional on whether the source object's current generation matches the given
value.
*/
public java.lang.Long getIfSourceGenerationMatch() {
return ifSourceGenerationMatch;
}
/**
* Makes the operation conditional on whether the source object's current generation matches
* the given value.
*/
public Copy setIfSourceGenerationMatch(java.lang.Long ifSourceGenerationMatch) {
this.ifSourceGenerationMatch = ifSourceGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current generation does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceGenerationNotMatch;
/** Makes the operation conditional on whether the source object's current generation does not match
the given value.
*/
public java.lang.Long getIfSourceGenerationNotMatch() {
return ifSourceGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the source object's current generation does not
* match the given value.
*/
public Copy setIfSourceGenerationNotMatch(java.lang.Long ifSourceGenerationNotMatch) {
this.ifSourceGenerationNotMatch = ifSourceGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationMatch;
/** Makes the operation conditional on whether the source object's current metageneration matches the
given value.
*/
public java.lang.Long getIfSourceMetagenerationMatch() {
return ifSourceMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
public Copy setIfSourceMetagenerationMatch(java.lang.Long ifSourceMetagenerationMatch) {
this.ifSourceMetagenerationMatch = ifSourceMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationNotMatch;
/** Makes the operation conditional on whether the source object's current metageneration does not
match the given value.
*/
public java.lang.Long getIfSourceMetagenerationNotMatch() {
return ifSourceMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
public Copy setIfSourceMetagenerationNotMatch(java.lang.Long ifSourceMetagenerationNotMatch) {
this.ifSourceMetagenerationNotMatch = ifSourceMetagenerationNotMatch;
return this;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl
property, when it defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
public Copy setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/**
* If present, selects a specific revision of the source object (as opposed to the latest
* version, the default).
*/
@com.google.api.client.util.Key
private java.lang.Long sourceGeneration;
/** If present, selects a specific revision of the source object (as opposed to the latest version, the
default).
*/
public java.lang.Long getSourceGeneration() {
return sourceGeneration;
}
/**
* If present, selects a specific revision of the source object (as opposed to the latest
* version, the default).
*/
public Copy setSourceGeneration(java.lang.Long sourceGeneration) {
this.sourceGeneration = sourceGeneration;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Copy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Copy set(String parameterName, Object value) {
return (Copy) super.set(parameterName, value);
}
}
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the
* bucket, or if the generation parameter is used.
*
* Create a request for the method "objects.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @return the request
*/
public Delete delete(java.lang.String bucket, java.lang.String object__) throws java.io.IOException {
Delete result = new Delete(bucket, object__);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}";
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
* the bucket, or if the generation parameter is used.
*
* Create a request for the method "objects.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @since 1.13
*/
protected Delete(java.lang.String bucket, java.lang.String object__) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public Delete setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Delete setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, permanently deletes a specific revision of this object (as opposed to the
* latest version, the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, permanently deletes a specific revision of this object (as opposed to the latest
version, the default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, permanently deletes a specific revision of this object (as opposed to the
* latest version, the default).
*/
public Delete setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Delete setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Delete setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Delete setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the object's current metageneration does not match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
public Delete setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Retrieves an object or its metadata.
*
* Create a request for the method "objects.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String object__) throws java.io.IOException {
Get result = new Get(bucket, object__);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}";
/**
* Retrieves an object or its metadata.
*
* Create a request for the method "objects.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String object__) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
initializeMediaDownload();
}
@Override
public void executeMediaAndDownloadTo(java.io.OutputStream outputStream) throws java.io.IOException {
super.executeMediaAndDownloadTo(outputStream);
}
@Override
public java.io.InputStream executeMediaAsInputStream() throws java.io.IOException {
return super.executeMediaAsInputStream();
}
@Override
public com.google.api.client.http.HttpResponse executeMedia() throws java.io.IOException {
return super.executeMedia();
}
@Override
public com.google.api.client.http.GenericUrl buildHttpRequestUrl() {
java.lang.String baseUrl = ("media".equals(get("alt")) && getMediaHttpUploader() == null)
? getRootUrl() + "download/" + getServicePath() : getBaseUrl();
return new com.google.api.client.http.GenericUrl(
com.google.api.client.http.UriTemplate.expand(baseUrl, getUriTemplate(), this, true));
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Get setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Get setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Get setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Get setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Get setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the object's current metageneration does not match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
public Get setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** Set of properties to return. Defaults to noAcl. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to noAcl. */
public Get setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/**
* If true, only soft-deleted object versions will be listed. The default is false. For more
* information, see Soft Delete.
*/
@com.google.api.client.util.Key
private java.lang.Boolean softDeleted;
/** If true, only soft-deleted object versions will be listed. The default is false. For more
information, see Soft Delete.
*/
public java.lang.Boolean getSoftDeleted() {
return softDeleted;
}
/**
* If true, only soft-deleted object versions will be listed. The default is false. For more
* information, see Soft Delete.
*/
public Get setSoftDeleted(java.lang.Boolean softDeleted) {
this.softDeleted = softDeleted;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Returns an IAM policy for the specified object.
*
* Create a request for the method "objects.getIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @return the request
*/
public GetIamPolicy getIamPolicy(java.lang.String bucket, java.lang.String object__) throws java.io.IOException {
GetIamPolicy result = new GetIamPolicy(bucket, object__);
initialize(result);
return result;
}
public class GetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/iam";
/**
* Returns an IAM policy for the specified object.
*
* Create a request for the method "objects.getIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* GetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @since 1.13
*/
protected GetIamPolicy(java.lang.String bucket, java.lang.String object__) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public GetIamPolicy setAlt(java.lang.String alt) {
return (GetIamPolicy) super.setAlt(alt);
}
@Override
public GetIamPolicy setFields(java.lang.String fields) {
return (GetIamPolicy) super.setFields(fields);
}
@Override
public GetIamPolicy setKey(java.lang.String key) {
return (GetIamPolicy) super.setKey(key);
}
@Override
public GetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (GetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public GetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (GetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public GetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (GetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public GetIamPolicy setUploadType(java.lang.String uploadType) {
return (GetIamPolicy) super.setUploadType(uploadType);
}
@Override
public GetIamPolicy setUserIp(java.lang.String userIp) {
return (GetIamPolicy) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public GetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public GetIamPolicy setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public GetIamPolicy setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public GetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public GetIamPolicy set(String parameterName, Object value) {
return (GetIamPolicy) super.set(parameterName, value);
}
}
/**
* Stores a new object and metadata.
*
* Create a request for the method "objects.insert".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @return the request
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.StorageObject content) throws java.io.IOException {
Insert result = new Insert(bucket, content);
initialize(result);
return result;
}
/**
* Stores a new object and metadata.
*
* Create a request for the method "objects.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation.
*
*
* This method should be used for uploading media content.
*
*
* @param bucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject} media metadata or {@code null} if none
* @param mediaContent The media HTTP content.
* @return the request
* @throws java.io.IOException if the initialization of the request fails
*/
public Insert insert(java.lang.String bucket, com.google.api.services.storage.model.StorageObject content, com.google.api.client.http.AbstractInputStreamContent mediaContent) throws java.io.IOException {
Insert result = new Insert(bucket, content, mediaContent);
initialize(result);
return result;
}
public class Insert extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o";
/**
* Stores a new object and metadata.
*
* Create a request for the method "objects.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.StorageObject content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
/**
* Stores a new object and metadata.
*
* Create a request for the method "objects.insert".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Insert#execute()} method to invoke the remote operation. {@link
* Insert#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
*
* This constructor should be used for uploading media content.
*
*
* @param bucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param content the {@link com.google.api.services.storage.model.StorageObject} media metadata or {@code null} if none
* @param mediaContent The media HTTP content.
* @since 1.13
*/
protected Insert(java.lang.String bucket, com.google.api.services.storage.model.StorageObject content, com.google.api.client.http.AbstractInputStreamContent mediaContent) {
super(Storage.this, "POST", "/upload/" + getServicePath() + REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
com.google.api.client.util.Preconditions.checkNotNull(mediaContent, "Required parameter mediaContent must be specified.");
initializeMediaUpload(mediaContent);
}
@Override
public Insert setAlt(java.lang.String alt) {
return (Insert) super.setAlt(alt);
}
@Override
public Insert setFields(java.lang.String fields) {
return (Insert) super.setFields(fields);
}
@Override
public Insert setKey(java.lang.String key) {
return (Insert) super.setKey(key);
}
@Override
public Insert setOauthToken(java.lang.String oauthToken) {
return (Insert) super.setOauthToken(oauthToken);
}
@Override
public Insert setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Insert) super.setPrettyPrint(prettyPrint);
}
@Override
public Insert setQuotaUser(java.lang.String quotaUser) {
return (Insert) super.setQuotaUser(quotaUser);
}
@Override
public Insert setUploadType(java.lang.String uploadType) {
return (Insert) super.setUploadType(uploadType);
}
@Override
public Insert setUserIp(java.lang.String userIp) {
return (Insert) super.setUserIp(userIp);
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which to store the new object. Overrides the provided object metadata's
bucket value, if any.
*/
public java.lang.String getBucket() {
return bucket;
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.
*/
public Insert setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* If set, sets the contentEncoding property of the final object to this value. Setting this
* parameter is equivalent to setting the contentEncoding metadata property. This can be
* useful when uploading an object with uploadType=media to indicate the encoding of the
* content being uploaded.
*/
@com.google.api.client.util.Key
private java.lang.String contentEncoding;
/** If set, sets the contentEncoding property of the final object to this value. Setting this parameter
is equivalent to setting the contentEncoding metadata property. This can be useful when uploading
an object with uploadType=media to indicate the encoding of the content being uploaded.
*/
public java.lang.String getContentEncoding() {
return contentEncoding;
}
/**
* If set, sets the contentEncoding property of the final object to this value. Setting this
* parameter is equivalent to setting the contentEncoding metadata property. This can be
* useful when uploading an object with uploadType=media to indicate the encoding of the
* content being uploaded.
*/
public Insert setContentEncoding(java.lang.String contentEncoding) {
this.contentEncoding = contentEncoding;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Insert setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Insert setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Insert setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the object's current metageneration does not match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
public Insert setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String kmsKeyName;
/** Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-
kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
*/
public java.lang.String getKmsKeyName() {
return kmsKeyName;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
public Insert setKmsKeyName(java.lang.String kmsKeyName) {
this.kmsKeyName = kmsKeyName;
return this;
}
/**
* Name of the object. Required when the object metadata is not otherwise provided. Overrides
* the object metadata's name value, if any. For information about how to URL encode object
* names to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String name;
/** Name of the object. Required when the object metadata is not otherwise provided. Overrides the
object metadata's name value, if any. For information about how to URL encode object names to be
path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
endpoints#encoding).
*/
public java.lang.String getName() {
return name;
}
/**
* Name of the object. Required when the object metadata is not otherwise provided. Overrides
* the object metadata's name value, if any. For information about how to URL encode object
* names to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public Insert setName(java.lang.String name) {
this.name = name;
return this;
}
/** Apply a predefined set of access controls to this object. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this object.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this object. */
public Insert setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl
property, when it defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
public Insert setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Insert setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Insert set(String parameterName, Object value) {
return (Insert) super.set(parameterName, value);
}
}
/**
* Retrieves a list of objects matching the criteria.
*
* Create a request for the method "objects.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which to look for objects.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o";
/**
* Retrieves a list of objects matching the criteria.
*
* Create a request for the method "objects.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which to look for objects.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.Objects.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the bucket in which to look for objects. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which to look for objects.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which to look for objects. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Returns results in a directory-like mode. items will contain only objects whose names,
* aside from the prefix, do not contain delimiter. Objects whose names, aside from the
* prefix, contain delimiter will have their name, truncated after the delimiter, returned in
* prefixes. Duplicate prefixes are omitted.
*/
@com.google.api.client.util.Key
private java.lang.String delimiter;
/** Returns results in a directory-like mode. items will contain only objects whose names, aside from
the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter
will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are
omitted.
*/
public java.lang.String getDelimiter() {
return delimiter;
}
/**
* Returns results in a directory-like mode. items will contain only objects whose names,
* aside from the prefix, do not contain delimiter. Objects whose names, aside from the
* prefix, contain delimiter will have their name, truncated after the delimiter, returned in
* prefixes. Duplicate prefixes are omitted.
*/
public List setDelimiter(java.lang.String delimiter) {
this.delimiter = delimiter;
return this;
}
/**
* Filter results to objects whose names are lexicographically before endOffset. If
* startOffset is also set, the objects listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String endOffset;
/** Filter results to objects whose names are lexicographically before endOffset. If startOffset is
also set, the objects listed will have names between startOffset (inclusive) and endOffset
(exclusive).
*/
public java.lang.String getEndOffset() {
return endOffset;
}
/**
* Filter results to objects whose names are lexicographically before endOffset. If
* startOffset is also set, the objects listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
public List setEndOffset(java.lang.String endOffset) {
this.endOffset = endOffset;
return this;
}
/**
* Only applicable if delimiter is set to '/'. If true, will also include folders and managed
* folders (besides objects) in the returned prefixes.
*/
@com.google.api.client.util.Key
private java.lang.Boolean includeFoldersAsPrefixes;
/** Only applicable if delimiter is set to '/'. If true, will also include folders and managed folders
(besides objects) in the returned prefixes.
*/
public java.lang.Boolean getIncludeFoldersAsPrefixes() {
return includeFoldersAsPrefixes;
}
/**
* Only applicable if delimiter is set to '/'. If true, will also include folders and managed
* folders (besides objects) in the returned prefixes.
*/
public List setIncludeFoldersAsPrefixes(java.lang.Boolean includeFoldersAsPrefixes) {
this.includeFoldersAsPrefixes = includeFoldersAsPrefixes;
return this;
}
/**
* If true, objects that end in exactly one instance of delimiter will have their metadata
* included in items in addition to prefixes.
*/
@com.google.api.client.util.Key
private java.lang.Boolean includeTrailingDelimiter;
/** If true, objects that end in exactly one instance of delimiter will have their metadata included in
items in addition to prefixes.
*/
public java.lang.Boolean getIncludeTrailingDelimiter() {
return includeTrailingDelimiter;
}
/**
* If true, objects that end in exactly one instance of delimiter will have their metadata
* included in items in addition to prefixes.
*/
public List setIncludeTrailingDelimiter(java.lang.Boolean includeTrailingDelimiter) {
this.includeTrailingDelimiter = includeTrailingDelimiter;
return this;
}
/** Filter results to objects and prefixes that match this glob pattern. */
@com.google.api.client.util.Key
private java.lang.String matchGlob;
/** Filter results to objects and prefixes that match this glob pattern.
*/
public java.lang.String getMatchGlob() {
return matchGlob;
}
/** Filter results to objects and prefixes that match this glob pattern. */
public List setMatchGlob(java.lang.String matchGlob) {
this.matchGlob = matchGlob;
return this;
}
/**
* Maximum number of items plus prefixes to return in a single page of responses. As duplicate
* prefixes are omitted, fewer total results may be returned than requested. The service will
* use this parameter or 1,000 items, whichever is smaller.
*/
@com.google.api.client.util.Key
private java.lang.Long maxResults;
/** Maximum number of items plus prefixes to return in a single page of responses. As duplicate
prefixes are omitted, fewer total results may be returned than requested. The service will use this
parameter or 1,000 items, whichever is smaller. [default: 1000] [minimum: 0]
*/
public java.lang.Long getMaxResults() {
return maxResults;
}
/**
* Maximum number of items plus prefixes to return in a single page of responses. As duplicate
* prefixes are omitted, fewer total results may be returned than requested. The service will
* use this parameter or 1,000 items, whichever is smaller.
*/
public List setMaxResults(java.lang.Long maxResults) {
this.maxResults = maxResults;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/** Filter results to objects whose names begin with this prefix. */
@com.google.api.client.util.Key
private java.lang.String prefix;
/** Filter results to objects whose names begin with this prefix.
*/
public java.lang.String getPrefix() {
return prefix;
}
/** Filter results to objects whose names begin with this prefix. */
public List setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
/** Set of properties to return. Defaults to noAcl. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to noAcl. */
public List setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/**
* If true, only soft-deleted object versions will be listed. The default is false. For more
* information, see Soft Delete.
*/
@com.google.api.client.util.Key
private java.lang.Boolean softDeleted;
/** If true, only soft-deleted object versions will be listed. The default is false. For more
information, see Soft Delete.
*/
public java.lang.Boolean getSoftDeleted() {
return softDeleted;
}
/**
* If true, only soft-deleted object versions will be listed. The default is false. For more
* information, see Soft Delete.
*/
public List setSoftDeleted(java.lang.Boolean softDeleted) {
this.softDeleted = softDeleted;
return this;
}
/**
* Filter results to objects whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the objects listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String startOffset;
/** Filter results to objects whose names are lexicographically equal to or after startOffset. If
endOffset is also set, the objects listed will have names between startOffset (inclusive) and
endOffset (exclusive).
*/
public java.lang.String getStartOffset() {
return startOffset;
}
/**
* Filter results to objects whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the objects listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
public List setStartOffset(java.lang.String startOffset) {
this.startOffset = startOffset;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
/**
* If true, lists all versions of an object as distinct results. The default is false. For
* more information, see Object Versioning.
*/
@com.google.api.client.util.Key
private java.lang.Boolean versions;
/** If true, lists all versions of an object as distinct results. The default is false. For more
information, see Object Versioning.
*/
public java.lang.Boolean getVersions() {
return versions;
}
/**
* If true, lists all versions of an object as distinct results. The default is false. For
* more information, see Object Versioning.
*/
public List setVersions(java.lang.Boolean versions) {
this.versions = versions;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Patches an object's metadata.
*
* Create a request for the method "objects.patch".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @return the request
*/
public Patch patch(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.StorageObject content) throws java.io.IOException {
Patch result = new Patch(bucket, object__, content);
initialize(result);
return result;
}
public class Patch extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}";
/**
* Patches an object's metadata.
*
* Create a request for the method "objects.patch".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Patch#execute()} method to invoke the remote operation. {@link
* Patch#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @since 1.13
*/
protected Patch(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.StorageObject content) {
super(Storage.this, "PATCH", REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public Patch setAlt(java.lang.String alt) {
return (Patch) super.setAlt(alt);
}
@Override
public Patch setFields(java.lang.String fields) {
return (Patch) super.setFields(fields);
}
@Override
public Patch setKey(java.lang.String key) {
return (Patch) super.setKey(key);
}
@Override
public Patch setOauthToken(java.lang.String oauthToken) {
return (Patch) super.setOauthToken(oauthToken);
}
@Override
public Patch setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Patch) super.setPrettyPrint(prettyPrint);
}
@Override
public Patch setQuotaUser(java.lang.String quotaUser) {
return (Patch) super.setQuotaUser(quotaUser);
}
@Override
public Patch setUploadType(java.lang.String uploadType) {
return (Patch) super.setUploadType(uploadType);
}
@Override
public Patch setUserIp(java.lang.String userIp) {
return (Patch) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public Patch setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Patch setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Patch setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Patch setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Patch setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Patch setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the object's current metageneration does not match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
public Patch setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/**
* Must be true to remove the retention configuration, reduce its unlocked retention period,
* or change its mode from unlocked to locked.
*/
@com.google.api.client.util.Key
private java.lang.Boolean overrideUnlockedRetention;
/** Must be true to remove the retention configuration, reduce its unlocked retention period, or change
its mode from unlocked to locked.
*/
public java.lang.Boolean getOverrideUnlockedRetention() {
return overrideUnlockedRetention;
}
/**
* Must be true to remove the retention configuration, reduce its unlocked retention period,
* or change its mode from unlocked to locked.
*/
public Patch setOverrideUnlockedRetention(java.lang.Boolean overrideUnlockedRetention) {
this.overrideUnlockedRetention = overrideUnlockedRetention;
return this;
}
/** Apply a predefined set of access controls to this object. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this object.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this object. */
public Patch setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/** Set of properties to return. Defaults to full. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to full. */
public Patch setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request, for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request, for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request, for Requester Pays buckets. */
public Patch setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Patch set(String parameterName, Object value) {
return (Patch) super.set(parameterName, value);
}
}
/**
* Restores a soft-deleted object.
*
* Create a request for the method "objects.restore".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Restore#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* Encoding URI Path Parts.
* @param generation Selects a specific revision of this object.
* @return the request
*/
public Restore restore(java.lang.String bucket, java.lang.String object__, java.lang.Long generation) throws java.io.IOException {
Restore result = new Restore(bucket, object__, generation);
initialize(result);
return result;
}
public class Restore extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/restore";
/**
* Restores a soft-deleted object.
*
* Create a request for the method "objects.restore".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Restore#execute()} method to invoke the remote operation.
* {@link
* Restore#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* Encoding URI Path Parts.
* @param generation Selects a specific revision of this object.
* @since 1.13
*/
protected Restore(java.lang.String bucket, java.lang.String object__, java.lang.Long generation) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.generation = com.google.api.client.util.Preconditions.checkNotNull(generation, "Required parameter generation must be specified.");
}
@Override
public Restore setAlt(java.lang.String alt) {
return (Restore) super.setAlt(alt);
}
@Override
public Restore setFields(java.lang.String fields) {
return (Restore) super.setFields(fields);
}
@Override
public Restore setKey(java.lang.String key) {
return (Restore) super.setKey(key);
}
@Override
public Restore setOauthToken(java.lang.String oauthToken) {
return (Restore) super.setOauthToken(oauthToken);
}
@Override
public Restore setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Restore) super.setPrettyPrint(prettyPrint);
}
@Override
public Restore setQuotaUser(java.lang.String quotaUser) {
return (Restore) super.setQuotaUser(quotaUser);
}
@Override
public Restore setUploadType(java.lang.String uploadType) {
return (Restore) super.setUploadType(uploadType);
}
@Override
public Restore setUserIp(java.lang.String userIp) {
return (Restore) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public Restore setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see Encoding URI Path Parts.
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
Encoding URI Path Parts.
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see Encoding URI Path Parts.
*/
public Restore setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/** Selects a specific revision of this object. */
@com.google.api.client.util.Key
private java.lang.Long generation;
/** Selects a specific revision of this object.
*/
public java.lang.Long getGeneration() {
return generation;
}
/** Selects a specific revision of this object. */
public Restore setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/**
* If true, copies the source object's ACL; otherwise, uses the bucket's default object ACL.
* The default is false.
*/
@com.google.api.client.util.Key
private java.lang.Boolean copySourceAcl;
/** If true, copies the source object's ACL; otherwise, uses the bucket's default object ACL. The
default is false.
*/
public java.lang.Boolean getCopySourceAcl() {
return copySourceAcl;
}
/**
* If true, copies the source object's ACL; otherwise, uses the bucket's default object ACL.
* The default is false.
*/
public Restore setCopySourceAcl(java.lang.Boolean copySourceAcl) {
this.copySourceAcl = copySourceAcl;
return this;
}
/**
* Makes the operation conditional on whether the object's one live generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's one live generation matches the given
value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's one live generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Restore setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether none of the object's live generations match the
* given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether none of the object's live generations match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether none of the object's live generations match the
* given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Restore setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's one live metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's one live metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's one live metageneration matches the
* given value.
*/
public Restore setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether none of the object's live metagenerations match
* the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether none of the object's live metagenerations match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether none of the object's live metagenerations match
* the given value.
*/
public Restore setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/** Set of properties to return. Defaults to full. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to full. */
public Restore setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Restore setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Restore set(String parameterName, Object value) {
return (Restore) super.set(parameterName, value);
}
}
/**
* Rewrites a source object to a destination object. Optionally overrides metadata.
*
* Create a request for the method "objects.rewrite".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Rewrite#execute()} method to invoke the remote operation.
*
* @param sourceBucket Name of the bucket in which to find the source object.
* @param sourceObject Name of the source object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationBucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param destinationObject Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
* object metadata's name value, if any. For information about how to URL encode object names
* to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @return the request
*/
public Rewrite rewrite(java.lang.String sourceBucket, java.lang.String sourceObject, java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.StorageObject content) throws java.io.IOException {
Rewrite result = new Rewrite(sourceBucket, sourceObject, destinationBucket, destinationObject, content);
initialize(result);
return result;
}
public class Rewrite extends StorageRequest {
private static final String REST_PATH = "b/{sourceBucket}/o/{sourceObject}/rewriteTo/b/{destinationBucket}/o/{destinationObject}";
/**
* Rewrites a source object to a destination object. Optionally overrides metadata.
*
* Create a request for the method "objects.rewrite".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Rewrite#execute()} method to invoke the remote operation.
* {@link
* Rewrite#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param sourceBucket Name of the bucket in which to find the source object.
* @param sourceObject Name of the source object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param destinationBucket Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket
* value, if any.
* @param destinationObject Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
* object metadata's name value, if any. For information about how to URL encode object names
* to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @since 1.13
*/
protected Rewrite(java.lang.String sourceBucket, java.lang.String sourceObject, java.lang.String destinationBucket, java.lang.String destinationObject, com.google.api.services.storage.model.StorageObject content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.RewriteResponse.class);
this.sourceBucket = com.google.api.client.util.Preconditions.checkNotNull(sourceBucket, "Required parameter sourceBucket must be specified.");
this.sourceObject = com.google.api.client.util.Preconditions.checkNotNull(sourceObject, "Required parameter sourceObject must be specified.");
this.destinationBucket = com.google.api.client.util.Preconditions.checkNotNull(destinationBucket, "Required parameter destinationBucket must be specified.");
this.destinationObject = com.google.api.client.util.Preconditions.checkNotNull(destinationObject, "Required parameter destinationObject must be specified.");
}
@Override
public Rewrite setAlt(java.lang.String alt) {
return (Rewrite) super.setAlt(alt);
}
@Override
public Rewrite setFields(java.lang.String fields) {
return (Rewrite) super.setFields(fields);
}
@Override
public Rewrite setKey(java.lang.String key) {
return (Rewrite) super.setKey(key);
}
@Override
public Rewrite setOauthToken(java.lang.String oauthToken) {
return (Rewrite) super.setOauthToken(oauthToken);
}
@Override
public Rewrite setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Rewrite) super.setPrettyPrint(prettyPrint);
}
@Override
public Rewrite setQuotaUser(java.lang.String quotaUser) {
return (Rewrite) super.setQuotaUser(quotaUser);
}
@Override
public Rewrite setUploadType(java.lang.String uploadType) {
return (Rewrite) super.setUploadType(uploadType);
}
@Override
public Rewrite setUserIp(java.lang.String userIp) {
return (Rewrite) super.setUserIp(userIp);
}
/** Name of the bucket in which to find the source object. */
@com.google.api.client.util.Key
private java.lang.String sourceBucket;
/** Name of the bucket in which to find the source object.
*/
public java.lang.String getSourceBucket() {
return sourceBucket;
}
/** Name of the bucket in which to find the source object. */
public Rewrite setSourceBucket(java.lang.String sourceBucket) {
this.sourceBucket = sourceBucket;
return this;
}
/**
* Name of the source object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String sourceObject;
/** Name of the source object. For information about how to URL encode object names to be path safe,
see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getSourceObject() {
return sourceObject;
}
/**
* Name of the source object. For information about how to URL encode object names to be path
* safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Rewrite setSourceObject(java.lang.String sourceObject) {
this.sourceObject = sourceObject;
return this;
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String destinationBucket;
/** Name of the bucket in which to store the new object. Overrides the provided object metadata's
bucket value, if any.
*/
public java.lang.String getDestinationBucket() {
return destinationBucket;
}
/**
* Name of the bucket in which to store the new object. Overrides the provided object
* metadata's bucket value, if any.
*/
public Rewrite setDestinationBucket(java.lang.String destinationBucket) {
this.destinationBucket = destinationBucket;
return this;
}
/**
* Name of the new object. Required when the object metadata is not otherwise provided.
* Overrides the object metadata's name value, if any. For information about how to URL encode
* object names to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
@com.google.api.client.util.Key
private java.lang.String destinationObject;
/** Name of the new object. Required when the object metadata is not otherwise provided. Overrides the
object metadata's name value, if any. For information about how to URL encode object names to be
path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
endpoints#encoding).
*/
public java.lang.String getDestinationObject() {
return destinationObject;
}
/**
* Name of the new object. Required when the object metadata is not otherwise provided.
* Overrides the object metadata's name value, if any. For information about how to URL encode
* object names to be path safe, see [Encoding URI Path
* Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public Rewrite setDestinationObject(java.lang.String destinationObject) {
this.destinationObject = destinationObject;
return this;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
@com.google.api.client.util.Key
private java.lang.String destinationKmsKeyName;
/** Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-
kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
*/
public java.lang.String getDestinationKmsKeyName() {
return destinationKmsKeyName;
}
/**
* Resource name of the Cloud KMS key, of the form projects/my-
* project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
* object. Overrides the object metadata's kms_key_name value, if any.
*/
public Rewrite setDestinationKmsKeyName(java.lang.String destinationKmsKeyName) {
this.destinationKmsKeyName = destinationKmsKeyName;
return this;
}
/** Apply a predefined set of access controls to the destination object. */
@com.google.api.client.util.Key
private java.lang.String destinationPredefinedAcl;
/** Apply a predefined set of access controls to the destination object.
*/
public java.lang.String getDestinationPredefinedAcl() {
return destinationPredefinedAcl;
}
/** Apply a predefined set of access controls to the destination object. */
public Rewrite setDestinationPredefinedAcl(java.lang.String destinationPredefinedAcl) {
this.destinationPredefinedAcl = destinationPredefinedAcl;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Rewrite setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Rewrite setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the destination object's current metageneration matches
the given value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* matches the given value.
*/
public Rewrite setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* does not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the destination object's current metageneration does not
match the given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the destination object's current metageneration
* does not match the given value.
*/
public Rewrite setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current generation matches
* the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceGenerationMatch;
/** Makes the operation conditional on whether the source object's current generation matches the given
value.
*/
public java.lang.Long getIfSourceGenerationMatch() {
return ifSourceGenerationMatch;
}
/**
* Makes the operation conditional on whether the source object's current generation matches
* the given value.
*/
public Rewrite setIfSourceGenerationMatch(java.lang.Long ifSourceGenerationMatch) {
this.ifSourceGenerationMatch = ifSourceGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current generation does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceGenerationNotMatch;
/** Makes the operation conditional on whether the source object's current generation does not match
the given value.
*/
public java.lang.Long getIfSourceGenerationNotMatch() {
return ifSourceGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the source object's current generation does not
* match the given value.
*/
public Rewrite setIfSourceGenerationNotMatch(java.lang.Long ifSourceGenerationNotMatch) {
this.ifSourceGenerationNotMatch = ifSourceGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationMatch;
/** Makes the operation conditional on whether the source object's current metageneration matches the
given value.
*/
public java.lang.Long getIfSourceMetagenerationMatch() {
return ifSourceMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration
* matches the given value.
*/
public Rewrite setIfSourceMetagenerationMatch(java.lang.Long ifSourceMetagenerationMatch) {
this.ifSourceMetagenerationMatch = ifSourceMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifSourceMetagenerationNotMatch;
/** Makes the operation conditional on whether the source object's current metageneration does not
match the given value.
*/
public java.lang.Long getIfSourceMetagenerationNotMatch() {
return ifSourceMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the source object's current metageneration does
* not match the given value.
*/
public Rewrite setIfSourceMetagenerationNotMatch(java.lang.Long ifSourceMetagenerationNotMatch) {
this.ifSourceMetagenerationNotMatch = ifSourceMetagenerationNotMatch;
return this;
}
/**
* The maximum number of bytes that will be rewritten per rewrite request. Most callers
* shouldn't need to specify this parameter - it is primarily in place to support testing. If
* specified the value must be an integral multiple of 1 MiB (1048576). Also, this only
* applies to requests where the source and destination span locations and/or storage classes.
* Finally, this value must not change across rewrite calls else you'll get an error that the
* rewriteToken is invalid.
*/
@com.google.api.client.util.Key
private java.lang.Long maxBytesRewrittenPerCall;
/** The maximum number of bytes that will be rewritten per rewrite request. Most callers shouldn't need
to specify this parameter - it is primarily in place to support testing. If specified the value
must be an integral multiple of 1 MiB (1048576). Also, this only applies to requests where the
source and destination span locations and/or storage classes. Finally, this value must not change
across rewrite calls else you'll get an error that the rewriteToken is invalid.
*/
public java.lang.Long getMaxBytesRewrittenPerCall() {
return maxBytesRewrittenPerCall;
}
/**
* The maximum number of bytes that will be rewritten per rewrite request. Most callers
* shouldn't need to specify this parameter - it is primarily in place to support testing. If
* specified the value must be an integral multiple of 1 MiB (1048576). Also, this only
* applies to requests where the source and destination span locations and/or storage classes.
* Finally, this value must not change across rewrite calls else you'll get an error that the
* rewriteToken is invalid.
*/
public Rewrite setMaxBytesRewrittenPerCall(java.lang.Long maxBytesRewrittenPerCall) {
this.maxBytesRewrittenPerCall = maxBytesRewrittenPerCall;
return this;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl
property, when it defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/**
* Set of properties to return. Defaults to noAcl, unless the object resource specifies the
* acl property, when it defaults to full.
*/
public Rewrite setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/**
* Include this field (from the previous rewrite response) on each rewrite request after the
* first one, until the rewrite response 'done' flag is true. Calls that provide a
* rewriteToken can omit all other request fields, but if included those fields must match the
* values provided in the first rewrite request.
*/
@com.google.api.client.util.Key
private java.lang.String rewriteToken;
/** Include this field (from the previous rewrite response) on each rewrite request after the first
one, until the rewrite response 'done' flag is true. Calls that provide a rewriteToken can omit all
other request fields, but if included those fields must match the values provided in the first
rewrite request.
*/
public java.lang.String getRewriteToken() {
return rewriteToken;
}
/**
* Include this field (from the previous rewrite response) on each rewrite request after the
* first one, until the rewrite response 'done' flag is true. Calls that provide a
* rewriteToken can omit all other request fields, but if included those fields must match the
* values provided in the first rewrite request.
*/
public Rewrite setRewriteToken(java.lang.String rewriteToken) {
this.rewriteToken = rewriteToken;
return this;
}
/**
* If present, selects a specific revision of the source object (as opposed to the latest
* version, the default).
*/
@com.google.api.client.util.Key
private java.lang.Long sourceGeneration;
/** If present, selects a specific revision of the source object (as opposed to the latest version, the
default).
*/
public java.lang.Long getSourceGeneration() {
return sourceGeneration;
}
/**
* If present, selects a specific revision of the source object (as opposed to the latest
* version, the default).
*/
public Rewrite setSourceGeneration(java.lang.Long sourceGeneration) {
this.sourceGeneration = sourceGeneration;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Rewrite setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Rewrite set(String parameterName, Object value) {
return (Rewrite) super.set(parameterName, value);
}
}
/**
* Updates an IAM policy for the specified object.
*
* Create a request for the method "objects.setIamPolicy".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.Policy}
* @return the request
*/
public SetIamPolicy setIamPolicy(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.Policy content) throws java.io.IOException {
SetIamPolicy result = new SetIamPolicy(bucket, object__, content);
initialize(result);
return result;
}
public class SetIamPolicy extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/iam";
/**
* Updates an IAM policy for the specified object.
*
* Create a request for the method "objects.setIamPolicy".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation.
* {@link
* SetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.Policy}
* @since 1.13
*/
protected SetIamPolicy(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.Policy content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.Policy.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public SetIamPolicy setAlt(java.lang.String alt) {
return (SetIamPolicy) super.setAlt(alt);
}
@Override
public SetIamPolicy setFields(java.lang.String fields) {
return (SetIamPolicy) super.setFields(fields);
}
@Override
public SetIamPolicy setKey(java.lang.String key) {
return (SetIamPolicy) super.setKey(key);
}
@Override
public SetIamPolicy setOauthToken(java.lang.String oauthToken) {
return (SetIamPolicy) super.setOauthToken(oauthToken);
}
@Override
public SetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) {
return (SetIamPolicy) super.setPrettyPrint(prettyPrint);
}
@Override
public SetIamPolicy setQuotaUser(java.lang.String quotaUser) {
return (SetIamPolicy) super.setQuotaUser(quotaUser);
}
@Override
public SetIamPolicy setUploadType(java.lang.String uploadType) {
return (SetIamPolicy) super.setUploadType(uploadType);
}
@Override
public SetIamPolicy setUserIp(java.lang.String userIp) {
return (SetIamPolicy) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public SetIamPolicy setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public SetIamPolicy setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public SetIamPolicy setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public SetIamPolicy setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public SetIamPolicy set(String parameterName, Object value) {
return (SetIamPolicy) super.set(parameterName, value);
}
}
/**
* Tests a set of permissions on the given object to see which, if any, are held by the caller.
*
* Create a request for the method "objects.testIamPermissions".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param permissions Permissions to test.
* @return the request
*/
public TestIamPermissions testIamPermissions(java.lang.String bucket, java.lang.String object__, java.util.List permissions) throws java.io.IOException {
TestIamPermissions result = new TestIamPermissions(bucket, object__, permissions);
initialize(result);
return result;
}
public class TestIamPermissions extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}/iam/testPermissions";
/**
* Tests a set of permissions on the given object to see which, if any, are held by the caller.
*
* Create a request for the method "objects.testIamPermissions".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote
* operation. {@link TestIamPermissions#initialize(com.google.api.client.googleapis.services.A
* bstractGoogleClientRequest)} must be called to initialize this instance immediately after
* invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param permissions Permissions to test.
* @since 1.13
*/
protected TestIamPermissions(java.lang.String bucket, java.lang.String object__, java.util.List permissions) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.TestIamPermissionsResponse.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
this.permissions = com.google.api.client.util.Preconditions.checkNotNull(permissions, "Required parameter permissions must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public TestIamPermissions setAlt(java.lang.String alt) {
return (TestIamPermissions) super.setAlt(alt);
}
@Override
public TestIamPermissions setFields(java.lang.String fields) {
return (TestIamPermissions) super.setFields(fields);
}
@Override
public TestIamPermissions setKey(java.lang.String key) {
return (TestIamPermissions) super.setKey(key);
}
@Override
public TestIamPermissions setOauthToken(java.lang.String oauthToken) {
return (TestIamPermissions) super.setOauthToken(oauthToken);
}
@Override
public TestIamPermissions setPrettyPrint(java.lang.Boolean prettyPrint) {
return (TestIamPermissions) super.setPrettyPrint(prettyPrint);
}
@Override
public TestIamPermissions setQuotaUser(java.lang.String quotaUser) {
return (TestIamPermissions) super.setQuotaUser(quotaUser);
}
@Override
public TestIamPermissions setUploadType(java.lang.String uploadType) {
return (TestIamPermissions) super.setUploadType(uploadType);
}
@Override
public TestIamPermissions setUserIp(java.lang.String userIp) {
return (TestIamPermissions) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public TestIamPermissions setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public TestIamPermissions setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/** Permissions to test. */
@com.google.api.client.util.Key
private java.util.List permissions;
/** Permissions to test.
*/
public java.util.List getPermissions() {
return permissions;
}
/** Permissions to test. */
public TestIamPermissions setPermissions(java.util.List permissions) {
this.permissions = permissions;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public TestIamPermissions setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public TestIamPermissions setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public TestIamPermissions set(String parameterName, Object value) {
return (TestIamPermissions) super.set(parameterName, value);
}
}
/**
* Updates an object's metadata.
*
* Create a request for the method "objects.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @return the request
*/
public Update update(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.StorageObject content) throws java.io.IOException {
Update result = new Update(bucket, object__, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/{object}";
/**
* Updates an object's metadata.
*
* Create a request for the method "objects.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which the object resides.
* @param object__ Name of the object. For information about how to URL encode object names to be path safe, see
* [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
* @param content the {@link com.google.api.services.storage.model.StorageObject}
* @since 1.13
*/
protected Update(java.lang.String bucket, java.lang.String object__, com.google.api.services.storage.model.StorageObject content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.StorageObject.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.object__ = com.google.api.client.util.Preconditions.checkNotNull(object__, "Required parameter object__ must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Name of the bucket in which the object resides. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which the object resides.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which the object resides. */
public Update setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
@com.google.api.client.util.Key("object")
private java.lang.String object__;
/** Name of the object. For information about how to URL encode object names to be path safe, see
[Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
*/
public java.lang.String getObject() {
return object__;
}
/**
* Name of the object. For information about how to URL encode object names to be path safe,
* see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-
* endpoints#encoding).
*/
public Update setObject(java.lang.String object__) {
this.object__ = object__;
return this;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
@com.google.api.client.util.Key
private java.lang.Long generation;
/** If present, selects a specific revision of this object (as opposed to the latest version, the
default).
*/
public java.lang.Long getGeneration() {
return generation;
}
/**
* If present, selects a specific revision of this object (as opposed to the latest version,
* the default).
*/
public Update setGeneration(java.lang.Long generation) {
this.generation = generation;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationMatch;
/** Makes the operation conditional on whether the object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions of the object.
*/
public java.lang.Long getIfGenerationMatch() {
return ifGenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current generation matches the
* given value. Setting to 0 makes the operation succeed only if there are no live versions of
* the object.
*/
public Update setIfGenerationMatch(java.lang.Long ifGenerationMatch) {
this.ifGenerationMatch = ifGenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
@com.google.api.client.util.Key
private java.lang.Long ifGenerationNotMatch;
/** Makes the operation conditional on whether the object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed
only if there is a live version of the object.
*/
public java.lang.Long getIfGenerationNotMatch() {
return ifGenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current generation does not match
* the given value. If no live object exists, the precondition fails. Setting to 0 makes the
* operation succeed only if there is a live version of the object.
*/
public Update setIfGenerationNotMatch(java.lang.Long ifGenerationNotMatch) {
this.ifGenerationNotMatch = ifGenerationNotMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationMatch;
/** Makes the operation conditional on whether the object's current metageneration matches the given
value.
*/
public java.lang.Long getIfMetagenerationMatch() {
return ifMetagenerationMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration matches the
* given value.
*/
public Update setIfMetagenerationMatch(java.lang.Long ifMetagenerationMatch) {
this.ifMetagenerationMatch = ifMetagenerationMatch;
return this;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
@com.google.api.client.util.Key
private java.lang.Long ifMetagenerationNotMatch;
/** Makes the operation conditional on whether the object's current metageneration does not match the
given value.
*/
public java.lang.Long getIfMetagenerationNotMatch() {
return ifMetagenerationNotMatch;
}
/**
* Makes the operation conditional on whether the object's current metageneration does not
* match the given value.
*/
public Update setIfMetagenerationNotMatch(java.lang.Long ifMetagenerationNotMatch) {
this.ifMetagenerationNotMatch = ifMetagenerationNotMatch;
return this;
}
/**
* Must be true to remove the retention configuration, reduce its unlocked retention period,
* or change its mode from unlocked to locked.
*/
@com.google.api.client.util.Key
private java.lang.Boolean overrideUnlockedRetention;
/** Must be true to remove the retention configuration, reduce its unlocked retention period, or change
its mode from unlocked to locked.
*/
public java.lang.Boolean getOverrideUnlockedRetention() {
return overrideUnlockedRetention;
}
/**
* Must be true to remove the retention configuration, reduce its unlocked retention period,
* or change its mode from unlocked to locked.
*/
public Update setOverrideUnlockedRetention(java.lang.Boolean overrideUnlockedRetention) {
this.overrideUnlockedRetention = overrideUnlockedRetention;
return this;
}
/** Apply a predefined set of access controls to this object. */
@com.google.api.client.util.Key
private java.lang.String predefinedAcl;
/** Apply a predefined set of access controls to this object.
*/
public java.lang.String getPredefinedAcl() {
return predefinedAcl;
}
/** Apply a predefined set of access controls to this object. */
public Update setPredefinedAcl(java.lang.String predefinedAcl) {
this.predefinedAcl = predefinedAcl;
return this;
}
/** Set of properties to return. Defaults to full. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to full.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to full. */
public Update setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
/**
* Watch for changes on all objects in a bucket.
*
* Create a request for the method "objects.watchAll".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link WatchAll#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which to look for objects.
* @param content the {@link com.google.api.services.storage.model.Channel}
* @return the request
*/
public WatchAll watchAll(java.lang.String bucket, com.google.api.services.storage.model.Channel content) throws java.io.IOException {
WatchAll result = new WatchAll(bucket, content);
initialize(result);
return result;
}
public class WatchAll extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/o/watch";
/**
* Watch for changes on all objects in a bucket.
*
* Create a request for the method "objects.watchAll".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link WatchAll#execute()} method to invoke the remote operation.
* {@link
* WatchAll#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which to look for objects.
* @param content the {@link com.google.api.services.storage.model.Channel}
* @since 1.13
*/
protected WatchAll(java.lang.String bucket, com.google.api.services.storage.model.Channel content) {
super(Storage.this, "POST", REST_PATH, content, com.google.api.services.storage.model.Channel.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public WatchAll setAlt(java.lang.String alt) {
return (WatchAll) super.setAlt(alt);
}
@Override
public WatchAll setFields(java.lang.String fields) {
return (WatchAll) super.setFields(fields);
}
@Override
public WatchAll setKey(java.lang.String key) {
return (WatchAll) super.setKey(key);
}
@Override
public WatchAll setOauthToken(java.lang.String oauthToken) {
return (WatchAll) super.setOauthToken(oauthToken);
}
@Override
public WatchAll setPrettyPrint(java.lang.Boolean prettyPrint) {
return (WatchAll) super.setPrettyPrint(prettyPrint);
}
@Override
public WatchAll setQuotaUser(java.lang.String quotaUser) {
return (WatchAll) super.setQuotaUser(quotaUser);
}
@Override
public WatchAll setUploadType(java.lang.String uploadType) {
return (WatchAll) super.setUploadType(uploadType);
}
@Override
public WatchAll setUserIp(java.lang.String userIp) {
return (WatchAll) super.setUserIp(userIp);
}
/** Name of the bucket in which to look for objects. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which to look for objects.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which to look for objects. */
public WatchAll setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* Returns results in a directory-like mode. items will contain only objects whose names,
* aside from the prefix, do not contain delimiter. Objects whose names, aside from the
* prefix, contain delimiter will have their name, truncated after the delimiter, returned in
* prefixes. Duplicate prefixes are omitted.
*/
@com.google.api.client.util.Key
private java.lang.String delimiter;
/** Returns results in a directory-like mode. items will contain only objects whose names, aside from
the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter
will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are
omitted.
*/
public java.lang.String getDelimiter() {
return delimiter;
}
/**
* Returns results in a directory-like mode. items will contain only objects whose names,
* aside from the prefix, do not contain delimiter. Objects whose names, aside from the
* prefix, contain delimiter will have their name, truncated after the delimiter, returned in
* prefixes. Duplicate prefixes are omitted.
*/
public WatchAll setDelimiter(java.lang.String delimiter) {
this.delimiter = delimiter;
return this;
}
/**
* Filter results to objects whose names are lexicographically before endOffset. If
* startOffset is also set, the objects listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String endOffset;
/** Filter results to objects whose names are lexicographically before endOffset. If startOffset is
also set, the objects listed will have names between startOffset (inclusive) and endOffset
(exclusive).
*/
public java.lang.String getEndOffset() {
return endOffset;
}
/**
* Filter results to objects whose names are lexicographically before endOffset. If
* startOffset is also set, the objects listed will have names between startOffset (inclusive)
* and endOffset (exclusive).
*/
public WatchAll setEndOffset(java.lang.String endOffset) {
this.endOffset = endOffset;
return this;
}
/**
* If true, objects that end in exactly one instance of delimiter will have their metadata
* included in items in addition to prefixes.
*/
@com.google.api.client.util.Key
private java.lang.Boolean includeTrailingDelimiter;
/** If true, objects that end in exactly one instance of delimiter will have their metadata included in
items in addition to prefixes.
*/
public java.lang.Boolean getIncludeTrailingDelimiter() {
return includeTrailingDelimiter;
}
/**
* If true, objects that end in exactly one instance of delimiter will have their metadata
* included in items in addition to prefixes.
*/
public WatchAll setIncludeTrailingDelimiter(java.lang.Boolean includeTrailingDelimiter) {
this.includeTrailingDelimiter = includeTrailingDelimiter;
return this;
}
/**
* Maximum number of items plus prefixes to return in a single page of responses. As duplicate
* prefixes are omitted, fewer total results may be returned than requested. The service will
* use this parameter or 1,000 items, whichever is smaller.
*/
@com.google.api.client.util.Key
private java.lang.Long maxResults;
/** Maximum number of items plus prefixes to return in a single page of responses. As duplicate
prefixes are omitted, fewer total results may be returned than requested. The service will use this
parameter or 1,000 items, whichever is smaller. [default: 1000] [minimum: 0]
*/
public java.lang.Long getMaxResults() {
return maxResults;
}
/**
* Maximum number of items plus prefixes to return in a single page of responses. As duplicate
* prefixes are omitted, fewer total results may be returned than requested. The service will
* use this parameter or 1,000 items, whichever is smaller.
*/
public WatchAll setMaxResults(java.lang.Long maxResults) {
this.maxResults = maxResults;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public WatchAll setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/** Filter results to objects whose names begin with this prefix. */
@com.google.api.client.util.Key
private java.lang.String prefix;
/** Filter results to objects whose names begin with this prefix.
*/
public java.lang.String getPrefix() {
return prefix;
}
/** Filter results to objects whose names begin with this prefix. */
public WatchAll setPrefix(java.lang.String prefix) {
this.prefix = prefix;
return this;
}
/** Set of properties to return. Defaults to noAcl. */
@com.google.api.client.util.Key
private java.lang.String projection;
/** Set of properties to return. Defaults to noAcl.
*/
public java.lang.String getProjection() {
return projection;
}
/** Set of properties to return. Defaults to noAcl. */
public WatchAll setProjection(java.lang.String projection) {
this.projection = projection;
return this;
}
/**
* Filter results to objects whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the objects listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
@com.google.api.client.util.Key
private java.lang.String startOffset;
/** Filter results to objects whose names are lexicographically equal to or after startOffset. If
endOffset is also set, the objects listed will have names between startOffset (inclusive) and
endOffset (exclusive).
*/
public java.lang.String getStartOffset() {
return startOffset;
}
/**
* Filter results to objects whose names are lexicographically equal to or after startOffset.
* If endOffset is also set, the objects listed will have names between startOffset
* (inclusive) and endOffset (exclusive).
*/
public WatchAll setStartOffset(java.lang.String startOffset) {
this.startOffset = startOffset;
return this;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request. Required for Requester Pays buckets.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. Required for Requester Pays buckets. */
public WatchAll setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
/**
* If true, lists all versions of an object as distinct results. The default is false. For
* more information, see Object Versioning.
*/
@com.google.api.client.util.Key
private java.lang.Boolean versions;
/** If true, lists all versions of an object as distinct results. The default is false. For more
information, see Object Versioning.
*/
public java.lang.Boolean getVersions() {
return versions;
}
/**
* If true, lists all versions of an object as distinct results. The default is false. For
* more information, see Object Versioning.
*/
public WatchAll setVersions(java.lang.Boolean versions) {
this.versions = versions;
return this;
}
@Override
public WatchAll set(String parameterName, Object value) {
return (WatchAll) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Operations collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Operations.List request = storage.operations().list(parameters ...)}
*
*
* @return the resource collection
*/
public Operations operations() {
return new Operations();
}
/**
* The "operations" collection of methods.
*/
public class Operations {
/**
* Starts asynchronous cancellation on a long-running operation. The server makes a best effort to
* cancel the operation, but success is not guaranteed.
*
* Create a request for the method "operations.cancel".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Cancel#execute()} method to invoke the remote operation.
*
* @param bucket The parent bucket of the operation resource.
* @param operationId The ID of the operation resource.
* @return the request
*/
public Cancel cancel(java.lang.String bucket, java.lang.String operationId) throws java.io.IOException {
Cancel result = new Cancel(bucket, operationId);
initialize(result);
return result;
}
public class Cancel extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/operations/{operationId}/cancel";
/**
* Starts asynchronous cancellation on a long-running operation. The server makes a best effort to
* cancel the operation, but success is not guaranteed.
*
* Create a request for the method "operations.cancel".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Cancel#execute()} method to invoke the remote operation. {@link
* Cancel#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param bucket The parent bucket of the operation resource.
* @param operationId The ID of the operation resource.
* @since 1.13
*/
protected Cancel(java.lang.String bucket, java.lang.String operationId) {
super(Storage.this, "POST", REST_PATH, null, Void.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.operationId = com.google.api.client.util.Preconditions.checkNotNull(operationId, "Required parameter operationId must be specified.");
}
@Override
public Cancel setAlt(java.lang.String alt) {
return (Cancel) super.setAlt(alt);
}
@Override
public Cancel setFields(java.lang.String fields) {
return (Cancel) super.setFields(fields);
}
@Override
public Cancel setKey(java.lang.String key) {
return (Cancel) super.setKey(key);
}
@Override
public Cancel setOauthToken(java.lang.String oauthToken) {
return (Cancel) super.setOauthToken(oauthToken);
}
@Override
public Cancel setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Cancel) super.setPrettyPrint(prettyPrint);
}
@Override
public Cancel setQuotaUser(java.lang.String quotaUser) {
return (Cancel) super.setQuotaUser(quotaUser);
}
@Override
public Cancel setUploadType(java.lang.String uploadType) {
return (Cancel) super.setUploadType(uploadType);
}
@Override
public Cancel setUserIp(java.lang.String userIp) {
return (Cancel) super.setUserIp(userIp);
}
/** The parent bucket of the operation resource. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** The parent bucket of the operation resource.
*/
public java.lang.String getBucket() {
return bucket;
}
/** The parent bucket of the operation resource. */
public Cancel setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of the operation resource. */
@com.google.api.client.util.Key
private java.lang.String operationId;
/** The ID of the operation resource.
*/
public java.lang.String getOperationId() {
return operationId;
}
/** The ID of the operation resource. */
public Cancel setOperationId(java.lang.String operationId) {
this.operationId = operationId;
return this;
}
@Override
public Cancel set(String parameterName, Object value) {
return (Cancel) super.set(parameterName, value);
}
}
/**
* Gets the latest state of a long-running operation.
*
* Create a request for the method "operations.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param bucket The parent bucket of the operation resource.
* @param operationId The ID of the operation resource.
* @return the request
*/
public Get get(java.lang.String bucket, java.lang.String operationId) throws java.io.IOException {
Get result = new Get(bucket, operationId);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/operations/{operationId}";
/**
* Gets the latest state of a long-running operation.
*
* Create a request for the method "operations.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket The parent bucket of the operation resource.
* @param operationId The ID of the operation resource.
* @since 1.13
*/
protected Get(java.lang.String bucket, java.lang.String operationId) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.GoogleLongrunningOperation.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
this.operationId = com.google.api.client.util.Preconditions.checkNotNull(operationId, "Required parameter operationId must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** The parent bucket of the operation resource. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** The parent bucket of the operation resource.
*/
public java.lang.String getBucket() {
return bucket;
}
/** The parent bucket of the operation resource. */
public Get setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/** The ID of the operation resource. */
@com.google.api.client.util.Key
private java.lang.String operationId;
/** The ID of the operation resource.
*/
public java.lang.String getOperationId() {
return operationId;
}
/** The ID of the operation resource. */
public Get setOperationId(java.lang.String operationId) {
this.operationId = operationId;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Lists operations that match the specified filter in the request.
*
* Create a request for the method "operations.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param bucket Name of the bucket in which to look for operations.
* @return the request
*/
public List list(java.lang.String bucket) throws java.io.IOException {
List result = new List(bucket);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "b/{bucket}/operations";
/**
* Lists operations that match the specified filter in the request.
*
* Create a request for the method "operations.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param bucket Name of the bucket in which to look for operations.
* @since 1.13
*/
protected List(java.lang.String bucket) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.GoogleLongrunningListOperationsResponse.class);
this.bucket = com.google.api.client.util.Preconditions.checkNotNull(bucket, "Required parameter bucket must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the bucket in which to look for operations. */
@com.google.api.client.util.Key
private java.lang.String bucket;
/** Name of the bucket in which to look for operations.
*/
public java.lang.String getBucket() {
return bucket;
}
/** Name of the bucket in which to look for operations. */
public List setBucket(java.lang.String bucket) {
this.bucket = bucket;
return this;
}
/**
* A filter to narrow down results to a preferred subset. The filtering language is documented
* in more detail in [AIP-160](https://google.aip.dev/160).
*/
@com.google.api.client.util.Key
private java.lang.String filter;
/** A filter to narrow down results to a preferred subset. The filtering language is documented in more
detail in [AIP-160](https://google.aip.dev/160).
*/
public java.lang.String getFilter() {
return filter;
}
/**
* A filter to narrow down results to a preferred subset. The filtering language is documented
* in more detail in [AIP-160](https://google.aip.dev/160).
*/
public List setFilter(java.lang.String filter) {
this.filter = filter;
return this;
}
/**
* Maximum number of items to return in a single page of responses. Fewer total results may be
* returned than requested. The service uses this parameter or 100 items, whichever is
* smaller.
*/
@com.google.api.client.util.Key
private java.lang.Integer pageSize;
/** Maximum number of items to return in a single page of responses. Fewer total results may be
returned than requested. The service uses this parameter or 100 items, whichever is smaller.
[minimum: 0]
*/
public java.lang.Integer getPageSize() {
return pageSize;
}
/**
* Maximum number of items to return in a single page of responses. Fewer total results may be
* returned than requested. The service uses this parameter or 100 items, whichever is
* smaller.
*/
public List setPageSize(java.lang.Integer pageSize) {
this.pageSize = pageSize;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the Projects collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.Projects.List request = storage.projects().list(parameters ...)}
*
*
* @return the resource collection
*/
public Projects projects() {
return new Projects();
}
/**
* The "projects" collection of methods.
*/
public class Projects {
/**
* An accessor for creating requests from the HmacKeys collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.HmacKeys.List request = storage.hmacKeys().list(parameters ...)}
*
*
* @return the resource collection
*/
public HmacKeys hmacKeys() {
return new HmacKeys();
}
/**
* The "hmacKeys" collection of methods.
*/
public class HmacKeys {
/**
* Creates a new HMAC key for the specified service account.
*
* Create a request for the method "hmacKeys.create".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Create#execute()} method to invoke the remote operation.
*
* @param projectId Project ID owning the service account.
* @param serviceAccountEmail Email address of the service account.
* @return the request
*/
public Create create(java.lang.String projectId, java.lang.String serviceAccountEmail) throws java.io.IOException {
Create result = new Create(projectId, serviceAccountEmail);
initialize(result);
return result;
}
public class Create extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/hmacKeys";
/**
* Creates a new HMAC key for the specified service account.
*
* Create a request for the method "hmacKeys.create".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Create#execute()} method to invoke the remote operation. {@link
* Create#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Project ID owning the service account.
* @param serviceAccountEmail Email address of the service account.
* @since 1.13
*/
protected Create(java.lang.String projectId, java.lang.String serviceAccountEmail) {
super(Storage.this, "POST", REST_PATH, null, com.google.api.services.storage.model.HmacKey.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
this.serviceAccountEmail = com.google.api.client.util.Preconditions.checkNotNull(serviceAccountEmail, "Required parameter serviceAccountEmail must be specified.");
}
@Override
public Create setAlt(java.lang.String alt) {
return (Create) super.setAlt(alt);
}
@Override
public Create setFields(java.lang.String fields) {
return (Create) super.setFields(fields);
}
@Override
public Create setKey(java.lang.String key) {
return (Create) super.setKey(key);
}
@Override
public Create setOauthToken(java.lang.String oauthToken) {
return (Create) super.setOauthToken(oauthToken);
}
@Override
public Create setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Create) super.setPrettyPrint(prettyPrint);
}
@Override
public Create setQuotaUser(java.lang.String quotaUser) {
return (Create) super.setQuotaUser(quotaUser);
}
@Override
public Create setUploadType(java.lang.String uploadType) {
return (Create) super.setUploadType(uploadType);
}
@Override
public Create setUserIp(java.lang.String userIp) {
return (Create) super.setUserIp(userIp);
}
/** Project ID owning the service account. */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Project ID owning the service account.
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Project ID owning the service account. */
public Create setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/** Email address of the service account. */
@com.google.api.client.util.Key
private java.lang.String serviceAccountEmail;
/** Email address of the service account.
*/
public java.lang.String getServiceAccountEmail() {
return serviceAccountEmail;
}
/** Email address of the service account. */
public Create setServiceAccountEmail(java.lang.String serviceAccountEmail) {
this.serviceAccountEmail = serviceAccountEmail;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Create setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Create set(String parameterName, Object value) {
return (Create) super.set(parameterName, value);
}
}
/**
* Deletes an HMAC key.
*
* Create a request for the method "hmacKeys.delete".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation.
*
* @param projectId Project ID owning the requested key
* @param accessId Name of the HMAC key to be deleted.
* @return the request
*/
public Delete delete(java.lang.String projectId, java.lang.String accessId) throws java.io.IOException {
Delete result = new Delete(projectId, accessId);
initialize(result);
return result;
}
public class Delete extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/hmacKeys/{accessId}";
/**
* Deletes an HMAC key.
*
* Create a request for the method "hmacKeys.delete".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Delete#execute()} method to invoke the remote operation. {@link
* Delete#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Project ID owning the requested key
* @param accessId Name of the HMAC key to be deleted.
* @since 1.13
*/
protected Delete(java.lang.String projectId, java.lang.String accessId) {
super(Storage.this, "DELETE", REST_PATH, null, Void.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
this.accessId = com.google.api.client.util.Preconditions.checkNotNull(accessId, "Required parameter accessId must be specified.");
}
@Override
public Delete setAlt(java.lang.String alt) {
return (Delete) super.setAlt(alt);
}
@Override
public Delete setFields(java.lang.String fields) {
return (Delete) super.setFields(fields);
}
@Override
public Delete setKey(java.lang.String key) {
return (Delete) super.setKey(key);
}
@Override
public Delete setOauthToken(java.lang.String oauthToken) {
return (Delete) super.setOauthToken(oauthToken);
}
@Override
public Delete setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Delete) super.setPrettyPrint(prettyPrint);
}
@Override
public Delete setQuotaUser(java.lang.String quotaUser) {
return (Delete) super.setQuotaUser(quotaUser);
}
@Override
public Delete setUploadType(java.lang.String uploadType) {
return (Delete) super.setUploadType(uploadType);
}
@Override
public Delete setUserIp(java.lang.String userIp) {
return (Delete) super.setUserIp(userIp);
}
/** Project ID owning the requested key */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Project ID owning the requested key
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Project ID owning the requested key */
public Delete setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/** Name of the HMAC key to be deleted. */
@com.google.api.client.util.Key
private java.lang.String accessId;
/** Name of the HMAC key to be deleted.
*/
public java.lang.String getAccessId() {
return accessId;
}
/** Name of the HMAC key to be deleted. */
public Delete setAccessId(java.lang.String accessId) {
this.accessId = accessId;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Delete setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Delete set(String parameterName, Object value) {
return (Delete) super.set(parameterName, value);
}
}
/**
* Retrieves an HMAC key's metadata
*
* Create a request for the method "hmacKeys.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param projectId Project ID owning the service account of the requested key.
* @param accessId Name of the HMAC key.
* @return the request
*/
public Get get(java.lang.String projectId, java.lang.String accessId) throws java.io.IOException {
Get result = new Get(projectId, accessId);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/hmacKeys/{accessId}";
/**
* Retrieves an HMAC key's metadata
*
* Create a request for the method "hmacKeys.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Project ID owning the service account of the requested key.
* @param accessId Name of the HMAC key.
* @since 1.13
*/
protected Get(java.lang.String projectId, java.lang.String accessId) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.HmacKeyMetadata.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
this.accessId = com.google.api.client.util.Preconditions.checkNotNull(accessId, "Required parameter accessId must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Project ID owning the service account of the requested key. */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Project ID owning the service account of the requested key.
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Project ID owning the service account of the requested key. */
public Get setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/** Name of the HMAC key. */
@com.google.api.client.util.Key
private java.lang.String accessId;
/** Name of the HMAC key.
*/
public java.lang.String getAccessId() {
return accessId;
}
/** Name of the HMAC key. */
public Get setAccessId(java.lang.String accessId) {
this.accessId = accessId;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* Retrieves a list of HMAC keys matching the criteria.
*
* Create a request for the method "hmacKeys.list".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation.
*
* @param projectId Name of the project in which to look for HMAC keys.
* @return the request
*/
public List list(java.lang.String projectId) throws java.io.IOException {
List result = new List(projectId);
initialize(result);
return result;
}
public class List extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/hmacKeys";
/**
* Retrieves a list of HMAC keys matching the criteria.
*
* Create a request for the method "hmacKeys.list".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link List#execute()} method to invoke the remote operation. {@link
* List#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Name of the project in which to look for HMAC keys.
* @since 1.13
*/
protected List(java.lang.String projectId) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.HmacKeysMetadata.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public List setAlt(java.lang.String alt) {
return (List) super.setAlt(alt);
}
@Override
public List setFields(java.lang.String fields) {
return (List) super.setFields(fields);
}
@Override
public List setKey(java.lang.String key) {
return (List) super.setKey(key);
}
@Override
public List setOauthToken(java.lang.String oauthToken) {
return (List) super.setOauthToken(oauthToken);
}
@Override
public List setPrettyPrint(java.lang.Boolean prettyPrint) {
return (List) super.setPrettyPrint(prettyPrint);
}
@Override
public List setQuotaUser(java.lang.String quotaUser) {
return (List) super.setQuotaUser(quotaUser);
}
@Override
public List setUploadType(java.lang.String uploadType) {
return (List) super.setUploadType(uploadType);
}
@Override
public List setUserIp(java.lang.String userIp) {
return (List) super.setUserIp(userIp);
}
/** Name of the project in which to look for HMAC keys. */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Name of the project in which to look for HMAC keys.
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Name of the project in which to look for HMAC keys. */
public List setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/**
* Maximum number of items to return in a single page of responses. The service uses this
* parameter or 250 items, whichever is smaller. The max number of items per page will also
* be limited by the number of distinct service accounts in the response. If the number of
* service accounts in a single response is too high, the page will truncated and a next
* page token will be returned.
*/
@com.google.api.client.util.Key
private java.lang.Long maxResults;
/** Maximum number of items to return in a single page of responses. The service uses this parameter or
250 items, whichever is smaller. The max number of items per page will also be limited by the
number of distinct service accounts in the response. If the number of service accounts in a single
response is too high, the page will truncated and a next page token will be returned. [default:
250] [minimum: 0]
*/
public java.lang.Long getMaxResults() {
return maxResults;
}
/**
* Maximum number of items to return in a single page of responses. The service uses this
* parameter or 250 items, whichever is smaller. The max number of items per page will also
* be limited by the number of distinct service accounts in the response. If the number of
* service accounts in a single response is too high, the page will truncated and a next
* page token will be returned.
*/
public List setMaxResults(java.lang.Long maxResults) {
this.maxResults = maxResults;
return this;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
@com.google.api.client.util.Key
private java.lang.String pageToken;
/** A previously-returned page token representing part of the larger set of results to view.
*/
public java.lang.String getPageToken() {
return pageToken;
}
/**
* A previously-returned page token representing part of the larger set of results to view.
*/
public List setPageToken(java.lang.String pageToken) {
this.pageToken = pageToken;
return this;
}
/** If present, only keys for the given service account are returned. */
@com.google.api.client.util.Key
private java.lang.String serviceAccountEmail;
/** If present, only keys for the given service account are returned.
*/
public java.lang.String getServiceAccountEmail() {
return serviceAccountEmail;
}
/** If present, only keys for the given service account are returned. */
public List setServiceAccountEmail(java.lang.String serviceAccountEmail) {
this.serviceAccountEmail = serviceAccountEmail;
return this;
}
/** Whether or not to show keys in the DELETED state. */
@com.google.api.client.util.Key
private java.lang.Boolean showDeletedKeys;
/** Whether or not to show keys in the DELETED state.
*/
public java.lang.Boolean getShowDeletedKeys() {
return showDeletedKeys;
}
/** Whether or not to show keys in the DELETED state. */
public List setShowDeletedKeys(java.lang.Boolean showDeletedKeys) {
this.showDeletedKeys = showDeletedKeys;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public List setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public List set(String parameterName, Object value) {
return (List) super.set(parameterName, value);
}
}
/**
* Updates the state of an HMAC key. See the HMAC Key resource descriptor for valid states.
*
* Create a request for the method "hmacKeys.update".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation.
*
* @param projectId Project ID owning the service account of the updated key.
* @param accessId Name of the HMAC key being updated.
* @param content the {@link com.google.api.services.storage.model.HmacKeyMetadata}
* @return the request
*/
public Update update(java.lang.String projectId, java.lang.String accessId, com.google.api.services.storage.model.HmacKeyMetadata content) throws java.io.IOException {
Update result = new Update(projectId, accessId, content);
initialize(result);
return result;
}
public class Update extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/hmacKeys/{accessId}";
/**
* Updates the state of an HMAC key. See the HMAC Key resource descriptor for valid states.
*
* Create a request for the method "hmacKeys.update".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Update#execute()} method to invoke the remote operation. {@link
* Update#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
* be called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Project ID owning the service account of the updated key.
* @param accessId Name of the HMAC key being updated.
* @param content the {@link com.google.api.services.storage.model.HmacKeyMetadata}
* @since 1.13
*/
protected Update(java.lang.String projectId, java.lang.String accessId, com.google.api.services.storage.model.HmacKeyMetadata content) {
super(Storage.this, "PUT", REST_PATH, content, com.google.api.services.storage.model.HmacKeyMetadata.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
this.accessId = com.google.api.client.util.Preconditions.checkNotNull(accessId, "Required parameter accessId must be specified.");
}
@Override
public Update setAlt(java.lang.String alt) {
return (Update) super.setAlt(alt);
}
@Override
public Update setFields(java.lang.String fields) {
return (Update) super.setFields(fields);
}
@Override
public Update setKey(java.lang.String key) {
return (Update) super.setKey(key);
}
@Override
public Update setOauthToken(java.lang.String oauthToken) {
return (Update) super.setOauthToken(oauthToken);
}
@Override
public Update setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Update) super.setPrettyPrint(prettyPrint);
}
@Override
public Update setQuotaUser(java.lang.String quotaUser) {
return (Update) super.setQuotaUser(quotaUser);
}
@Override
public Update setUploadType(java.lang.String uploadType) {
return (Update) super.setUploadType(uploadType);
}
@Override
public Update setUserIp(java.lang.String userIp) {
return (Update) super.setUserIp(userIp);
}
/** Project ID owning the service account of the updated key. */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Project ID owning the service account of the updated key.
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Project ID owning the service account of the updated key. */
public Update setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/** Name of the HMAC key being updated. */
@com.google.api.client.util.Key
private java.lang.String accessId;
/** Name of the HMAC key being updated.
*/
public java.lang.String getAccessId() {
return accessId;
}
/** Name of the HMAC key being updated. */
public Update setAccessId(java.lang.String accessId) {
this.accessId = accessId;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Update setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Update set(String parameterName, Object value) {
return (Update) super.set(parameterName, value);
}
}
}
/**
* An accessor for creating requests from the ServiceAccount collection.
*
* The typical use is:
*
* {@code Storage storage = new Storage(...);}
* {@code Storage.ServiceAccount.List request = storage.serviceAccount().list(parameters ...)}
*
*
* @return the resource collection
*/
public ServiceAccount serviceAccount() {
return new ServiceAccount();
}
/**
* The "serviceAccount" collection of methods.
*/
public class ServiceAccount {
/**
* Get the email address of this project's Google Cloud Storage service account.
*
* Create a request for the method "serviceAccount.get".
*
* This request holds the parameters needed by the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param projectId Project ID
* @return the request
*/
public Get get(java.lang.String projectId) throws java.io.IOException {
Get result = new Get(projectId);
initialize(result);
return result;
}
public class Get extends StorageRequest {
private static final String REST_PATH = "projects/{projectId}/serviceAccount";
/**
* Get the email address of this project's Google Cloud Storage service account.
*
* Create a request for the method "serviceAccount.get".
*
* This request holds the parameters needed by the the storage server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation. {@link
* Get#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must be
* called to initialize this instance immediately after invoking the constructor.
*
* @param projectId Project ID
* @since 1.13
*/
protected Get(java.lang.String projectId) {
super(Storage.this, "GET", REST_PATH, null, com.google.api.services.storage.model.ServiceAccount.class);
this.projectId = com.google.api.client.util.Preconditions.checkNotNull(projectId, "Required parameter projectId must be specified.");
}
@Override
public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
return super.executeUsingHead();
}
@Override
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
return super.buildHttpRequestUsingHead();
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setFields(java.lang.String fields) {
return (Get) super.setFields(fields);
}
@Override
public Get setKey(java.lang.String key) {
return (Get) super.setKey(key);
}
@Override
public Get setOauthToken(java.lang.String oauthToken) {
return (Get) super.setOauthToken(oauthToken);
}
@Override
public Get setPrettyPrint(java.lang.Boolean prettyPrint) {
return (Get) super.setPrettyPrint(prettyPrint);
}
@Override
public Get setQuotaUser(java.lang.String quotaUser) {
return (Get) super.setQuotaUser(quotaUser);
}
@Override
public Get setUploadType(java.lang.String uploadType) {
return (Get) super.setUploadType(uploadType);
}
@Override
public Get setUserIp(java.lang.String userIp) {
return (Get) super.setUserIp(userIp);
}
/** Project ID */
@com.google.api.client.util.Key
private java.lang.String projectId;
/** Project ID
*/
public java.lang.String getProjectId() {
return projectId;
}
/** Project ID */
public Get setProjectId(java.lang.String projectId) {
this.projectId = projectId;
return this;
}
/** The project to be billed for this request. */
@com.google.api.client.util.Key
private java.lang.String userProject;
/** The project to be billed for this request.
*/
public java.lang.String getUserProject() {
return userProject;
}
/** The project to be billed for this request. */
public Get setUserProject(java.lang.String userProject) {
this.userProject = userProject;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
}
}
/**
* Builder for {@link Storage}.
*
*
* Implementation is not thread-safe.
*
*
* @since 1.3.0
*/
public static final class Builder extends com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient.Builder {
private static String chooseEndpoint(com.google.api.client.http.HttpTransport transport) {
// If the GOOGLE_API_USE_MTLS_ENDPOINT environment variable value is "always", use mTLS endpoint.
// If the env variable is "auto", use mTLS endpoint if and only if the transport is mTLS.
// Use the regular endpoint for all other cases.
String useMtlsEndpoint = System.getenv("GOOGLE_API_USE_MTLS_ENDPOINT");
useMtlsEndpoint = useMtlsEndpoint == null ? "auto" : useMtlsEndpoint;
if ("always".equals(useMtlsEndpoint) || ("auto".equals(useMtlsEndpoint) && transport != null && transport.isMtls())) {
return DEFAULT_MTLS_ROOT_URL;
}
return DEFAULT_ROOT_URL;
}
/**
* Returns an instance of a new builder.
*
* @param transport HTTP transport, which should normally be:
*
* - Google App Engine:
* {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport}
* - Android: {@code newCompatibleTransport} from
* {@code com.google.api.client.extensions.android.http.AndroidHttp}
* - Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()}
*
*
* @param jsonFactory JSON factory, which may be:
*
* - Jackson: {@code com.google.api.client.json.jackson2.JacksonFactory}
* - Google GSON: {@code com.google.api.client.json.gson.GsonFactory}
* - Android Honeycomb or higher:
* {@code com.google.api.client.extensions.android.json.AndroidJsonFactory}
*
* @param httpRequestInitializer HTTP request initializer or {@code null} for none
* @since 1.7
*/
public Builder(com.google.api.client.http.HttpTransport transport, com.google.api.client.json.JsonFactory jsonFactory,
com.google.api.client.http.HttpRequestInitializer httpRequestInitializer) {
super(
transport,
jsonFactory,
Builder.chooseEndpoint(transport),
DEFAULT_SERVICE_PATH,
httpRequestInitializer,
false);
setBatchPath(DEFAULT_BATCH_PATH);
}
/** Builds a new instance of {@link Storage}. */
@Override
public Storage build() {
return new Storage(this);
}
@Override
public Builder setRootUrl(String rootUrl) {
return (Builder) super.setRootUrl(rootUrl);
}
@Override
public Builder setServicePath(String servicePath) {
return (Builder) super.setServicePath(servicePath);
}
@Override
public Builder setBatchPath(String batchPath) {
return (Builder) super.setBatchPath(batchPath);
}
@Override
public Builder setHttpRequestInitializer(com.google.api.client.http.HttpRequestInitializer httpRequestInitializer) {
return (Builder) super.setHttpRequestInitializer(httpRequestInitializer);
}
@Override
public Builder setApplicationName(String applicationName) {
return (Builder) super.setApplicationName(applicationName);
}
@Override
public Builder setSuppressPatternChecks(boolean suppressPatternChecks) {
return (Builder) super.setSuppressPatternChecks(suppressPatternChecks);
}
@Override
public Builder setSuppressRequiredParameterChecks(boolean suppressRequiredParameterChecks) {
return (Builder) super.setSuppressRequiredParameterChecks(suppressRequiredParameterChecks);
}
@Override
public Builder setSuppressAllChecks(boolean suppressAllChecks) {
return (Builder) super.setSuppressAllChecks(suppressAllChecks);
}
/**
* Set the {@link StorageRequestInitializer}.
*
* @since 1.12
*/
public Builder setStorageRequestInitializer(
StorageRequestInitializer storageRequestInitializer) {
return (Builder) super.setGoogleClientRequestInitializer(storageRequestInitializer);
}
@Override
public Builder setGoogleClientRequestInitializer(
com.google.api.client.googleapis.services.GoogleClientRequestInitializer googleClientRequestInitializer) {
return (Builder) super.setGoogleClientRequestInitializer(googleClientRequestInitializer);
}
@Override
public Builder setUniverseDomain(String universeDomain) {
return (Builder) super.setUniverseDomain(universeDomain);
}
}
}