com.google.api.services.slides.v1.Slides Maven / Gradle / Ivy
/*
* Copyright 2010 Google Inc.
*
* 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/google/apis-client-generator/
* (build: 2017-01-11 18:31:16 UTC)
* on 2017-01-26 at 00:35:45 UTC
* Modify at your own risk.
*/
package com.google.api.services.slides.v1;
/**
* Service definition for Slides (v1).
*
*
* An API for creating and editing Google Slides presentations.
*
*
*
* For more information about this service, see the
* API Documentation
*
*
*
* This service uses {@link SlidesRequestInitializer} to initialize global parameters via its
* {@link Builder}.
*
*
* @since 1.3
* @author Google, Inc.
*/
@SuppressWarnings("javadoc")
public class Slides 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 >= 15,
"You are currently running with version %s of google-api-client. " +
"You need at least version 1.15 of google-api-client to run version " +
"1.21.0 of the Google Slides 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://slides.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 = "";
/**
* 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 Slides(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
*/
Slides(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 Presentations collection.
*
* The typical use is:
*
* {@code Slides slides = new Slides(...);}
* {@code Slides.Presentations.List request = slides.presentations().list(parameters ...)}
*
*
* @return the resource collection
*/
public Presentations presentations() {
return new Presentations();
}
/**
* The "presentations" collection of methods.
*/
public class Presentations {
/**
* Applies one or more updates to the presentation.
*
* Each request is validated before being applied. If any request is not valid, then the entire
* request will fail and nothing will be applied.
*
* Some requests have replies to give you some information about how they are applied. Other
* requests do not need to return information; these each return an empty reply. The order of
* replies matches that of the requests.
*
* For example, suppose you call batchUpdate with four updates, and only the third one returns
* information. The response would have two empty replies: the reply to the third request, and
* another empty reply, in that order.
*
* Because other users may be editing the presentation, the presentation might not exactly reflect
* your changes: your changes may be altered with respect to collaborator changes. If there are no
* collaborators, the presentation should reflect your changes. In any case, the updates in your
* request are guaranteed to be applied together atomically.
*
* Create a request for the method "presentations.batchUpdate".
*
* This request holds the parameters needed by the slides server. After setting any optional
* parameters, call the {@link BatchUpdate#execute()} method to invoke the remote operation.
*
* @param presentationId The presentation to apply the updates to.
* @param content the {@link com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest}
* @return the request
*/
public BatchUpdate batchUpdate(java.lang.String presentationId, com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest content) throws java.io.IOException {
BatchUpdate result = new BatchUpdate(presentationId, content);
initialize(result);
return result;
}
public class BatchUpdate extends SlidesRequest {
private static final String REST_PATH = "v1/presentations/{presentationId}:batchUpdate";
/**
* Applies one or more updates to the presentation.
*
* Each request is validated before being applied. If any request is not valid, then the entire
* request will fail and nothing will be applied.
*
* Some requests have replies to give you some information about how they are applied. Other
* requests do not need to return information; these each return an empty reply. The order of
* replies matches that of the requests.
*
* For example, suppose you call batchUpdate with four updates, and only the third one returns
* information. The response would have two empty replies: the reply to the third request, and
* another empty reply, in that order.
*
* Because other users may be editing the presentation, the presentation might not exactly reflect
* your changes: your changes may be altered with respect to collaborator changes. If there are no
* collaborators, the presentation should reflect your changes. In any case, the updates in your
* request are guaranteed to be applied together atomically.
*
* Create a request for the method "presentations.batchUpdate".
*
* This request holds the parameters needed by the the slides server. After setting any optional
* parameters, call the {@link BatchUpdate#execute()} method to invoke the remote operation.
* {@link
* BatchUpdate#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
* must be called to initialize this instance immediately after invoking the constructor.
*
* @param presentationId The presentation to apply the updates to.
* @param content the {@link com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest}
* @since 1.13
*/
protected BatchUpdate(java.lang.String presentationId, com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest content) {
super(Slides.this, "POST", REST_PATH, content, com.google.api.services.slides.v1.model.BatchUpdatePresentationResponse.class);
this.presentationId = com.google.api.client.util.Preconditions.checkNotNull(presentationId, "Required parameter presentationId must be specified.");
}
@Override
public BatchUpdate set$Xgafv(java.lang.String $Xgafv) {
return (BatchUpdate) super.set$Xgafv($Xgafv);
}
@Override
public BatchUpdate setAccessToken(java.lang.String accessToken) {
return (BatchUpdate) super.setAccessToken(accessToken);
}
@Override
public BatchUpdate setAlt(java.lang.String alt) {
return (BatchUpdate) super.setAlt(alt);
}
@Override
public BatchUpdate setBearerToken(java.lang.String bearerToken) {
return (BatchUpdate) super.setBearerToken(bearerToken);
}
@Override
public BatchUpdate setCallback(java.lang.String callback) {
return (BatchUpdate) super.setCallback(callback);
}
@Override
public BatchUpdate setFields(java.lang.String fields) {
return (BatchUpdate) super.setFields(fields);
}
@Override
public BatchUpdate setKey(java.lang.String key) {
return (BatchUpdate) super.setKey(key);
}
@Override
public BatchUpdate setOauthToken(java.lang.String oauthToken) {
return (BatchUpdate) super.setOauthToken(oauthToken);
}
@Override
public BatchUpdate setPp(java.lang.Boolean pp) {
return (BatchUpdate) super.setPp(pp);
}
@Override
public BatchUpdate setPrettyPrint(java.lang.Boolean prettyPrint) {
return (BatchUpdate) super.setPrettyPrint(prettyPrint);
}
@Override
public BatchUpdate setQuotaUser(java.lang.String quotaUser) {
return (BatchUpdate) super.setQuotaUser(quotaUser);
}
@Override
public BatchUpdate setUploadType(java.lang.String uploadType) {
return (BatchUpdate) super.setUploadType(uploadType);
}
@Override
public BatchUpdate setUploadProtocol(java.lang.String uploadProtocol) {
return (BatchUpdate) super.setUploadProtocol(uploadProtocol);
}
/** The presentation to apply the updates to. */
@com.google.api.client.util.Key
private java.lang.String presentationId;
/** The presentation to apply the updates to.
*/
public java.lang.String getPresentationId() {
return presentationId;
}
/** The presentation to apply the updates to. */
public BatchUpdate setPresentationId(java.lang.String presentationId) {
this.presentationId = presentationId;
return this;
}
@Override
public BatchUpdate set(String parameterName, Object value) {
return (BatchUpdate) super.set(parameterName, value);
}
}
/**
* Creates a new presentation using the title given in the request. Other fields in the request are
* ignored. Returns the created presentation.
*
* Create a request for the method "presentations.create".
*
* This request holds the parameters needed by the slides server. After setting any optional
* parameters, call the {@link Create#execute()} method to invoke the remote operation.
*
* @param content the {@link com.google.api.services.slides.v1.model.Presentation}
* @return the request
*/
public Create create(com.google.api.services.slides.v1.model.Presentation content) throws java.io.IOException {
Create result = new Create(content);
initialize(result);
return result;
}
public class Create extends SlidesRequest {
private static final String REST_PATH = "v1/presentations";
/**
* Creates a new presentation using the title given in the request. Other fields in the request
* are ignored. Returns the created presentation.
*
* Create a request for the method "presentations.create".
*
* This request holds the parameters needed by the the slides 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 content the {@link com.google.api.services.slides.v1.model.Presentation}
* @since 1.13
*/
protected Create(com.google.api.services.slides.v1.model.Presentation content) {
super(Slides.this, "POST", REST_PATH, content, com.google.api.services.slides.v1.model.Presentation.class);
}
@Override
public Create set$Xgafv(java.lang.String $Xgafv) {
return (Create) super.set$Xgafv($Xgafv);
}
@Override
public Create setAccessToken(java.lang.String accessToken) {
return (Create) super.setAccessToken(accessToken);
}
@Override
public Create setAlt(java.lang.String alt) {
return (Create) super.setAlt(alt);
}
@Override
public Create setBearerToken(java.lang.String bearerToken) {
return (Create) super.setBearerToken(bearerToken);
}
@Override
public Create setCallback(java.lang.String callback) {
return (Create) super.setCallback(callback);
}
@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 setPp(java.lang.Boolean pp) {
return (Create) super.setPp(pp);
}
@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 setUploadProtocol(java.lang.String uploadProtocol) {
return (Create) super.setUploadProtocol(uploadProtocol);
}
@Override
public Create set(String parameterName, Object value) {
return (Create) super.set(parameterName, value);
}
}
/**
* Gets the latest version of the specified presentation.
*
* Create a request for the method "presentations.get".
*
* This request holds the parameters needed by the slides server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param presentationId The ID of the presentation to retrieve.
* @return the request
*/
public Get get(java.lang.String presentationId) throws java.io.IOException {
Get result = new Get(presentationId);
initialize(result);
return result;
}
public class Get extends SlidesRequest {
private static final String REST_PATH = "v1/presentations/{+presentationId}";
private final java.util.regex.Pattern PRESENTATION_ID_PATTERN =
java.util.regex.Pattern.compile("^[^/]+$");
/**
* Gets the latest version of the specified presentation.
*
* Create a request for the method "presentations.get".
*
* This request holds the parameters needed by the the slides 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 presentationId The ID of the presentation to retrieve.
* @since 1.13
*/
protected Get(java.lang.String presentationId) {
super(Slides.this, "GET", REST_PATH, null, com.google.api.services.slides.v1.model.Presentation.class);
this.presentationId = com.google.api.client.util.Preconditions.checkNotNull(presentationId, "Required parameter presentationId must be specified.");
if (!getSuppressPatternChecks()) {
com.google.api.client.util.Preconditions.checkArgument(PRESENTATION_ID_PATTERN.matcher(presentationId).matches(),
"Parameter presentationId must conform to the pattern " +
"^[^/]+$");
}
}
@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 set$Xgafv(java.lang.String $Xgafv) {
return (Get) super.set$Xgafv($Xgafv);
}
@Override
public Get setAccessToken(java.lang.String accessToken) {
return (Get) super.setAccessToken(accessToken);
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setBearerToken(java.lang.String bearerToken) {
return (Get) super.setBearerToken(bearerToken);
}
@Override
public Get setCallback(java.lang.String callback) {
return (Get) super.setCallback(callback);
}
@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 setPp(java.lang.Boolean pp) {
return (Get) super.setPp(pp);
}
@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 setUploadProtocol(java.lang.String uploadProtocol) {
return (Get) super.setUploadProtocol(uploadProtocol);
}
/** The ID of the presentation to retrieve. */
@com.google.api.client.util.Key
private java.lang.String presentationId;
/** The ID of the presentation to retrieve.
*/
public java.lang.String getPresentationId() {
return presentationId;
}
/** The ID of the presentation to retrieve. */
public Get setPresentationId(java.lang.String presentationId) {
if (!getSuppressPatternChecks()) {
com.google.api.client.util.Preconditions.checkArgument(PRESENTATION_ID_PATTERN.matcher(presentationId).matches(),
"Parameter presentationId must conform to the pattern " +
"^[^/]+$");
}
this.presentationId = presentationId;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
/**
* An accessor for creating requests from the Pages collection.
*
* The typical use is:
*
* {@code Slides slides = new Slides(...);}
* {@code Slides.Pages.List request = slides.pages().list(parameters ...)}
*
*
* @return the resource collection
*/
public Pages pages() {
return new Pages();
}
/**
* The "pages" collection of methods.
*/
public class Pages {
/**
* Gets the latest version of the specified page in the presentation.
*
* Create a request for the method "pages.get".
*
* This request holds the parameters needed by the slides server. After setting any optional
* parameters, call the {@link Get#execute()} method to invoke the remote operation.
*
* @param presentationId The ID of the presentation to retrieve.
* @param pageObjectId The object ID of the page to retrieve.
* @return the request
*/
public Get get(java.lang.String presentationId, java.lang.String pageObjectId) throws java.io.IOException {
Get result = new Get(presentationId, pageObjectId);
initialize(result);
return result;
}
public class Get extends SlidesRequest {
private static final String REST_PATH = "v1/presentations/{presentationId}/pages/{pageObjectId}";
/**
* Gets the latest version of the specified page in the presentation.
*
* Create a request for the method "pages.get".
*
* This request holds the parameters needed by the the slides 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 presentationId The ID of the presentation to retrieve.
* @param pageObjectId The object ID of the page to retrieve.
* @since 1.13
*/
protected Get(java.lang.String presentationId, java.lang.String pageObjectId) {
super(Slides.this, "GET", REST_PATH, null, com.google.api.services.slides.v1.model.Page.class);
this.presentationId = com.google.api.client.util.Preconditions.checkNotNull(presentationId, "Required parameter presentationId must be specified.");
this.pageObjectId = com.google.api.client.util.Preconditions.checkNotNull(pageObjectId, "Required parameter pageObjectId 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 set$Xgafv(java.lang.String $Xgafv) {
return (Get) super.set$Xgafv($Xgafv);
}
@Override
public Get setAccessToken(java.lang.String accessToken) {
return (Get) super.setAccessToken(accessToken);
}
@Override
public Get setAlt(java.lang.String alt) {
return (Get) super.setAlt(alt);
}
@Override
public Get setBearerToken(java.lang.String bearerToken) {
return (Get) super.setBearerToken(bearerToken);
}
@Override
public Get setCallback(java.lang.String callback) {
return (Get) super.setCallback(callback);
}
@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 setPp(java.lang.Boolean pp) {
return (Get) super.setPp(pp);
}
@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 setUploadProtocol(java.lang.String uploadProtocol) {
return (Get) super.setUploadProtocol(uploadProtocol);
}
/** The ID of the presentation to retrieve. */
@com.google.api.client.util.Key
private java.lang.String presentationId;
/** The ID of the presentation to retrieve.
*/
public java.lang.String getPresentationId() {
return presentationId;
}
/** The ID of the presentation to retrieve. */
public Get setPresentationId(java.lang.String presentationId) {
this.presentationId = presentationId;
return this;
}
/** The object ID of the page to retrieve. */
@com.google.api.client.util.Key
private java.lang.String pageObjectId;
/** The object ID of the page to retrieve.
*/
public java.lang.String getPageObjectId() {
return pageObjectId;
}
/** The object ID of the page to retrieve. */
public Get setPageObjectId(java.lang.String pageObjectId) {
this.pageObjectId = pageObjectId;
return this;
}
@Override
public Get set(String parameterName, Object value) {
return (Get) super.set(parameterName, value);
}
}
}
}
/**
* Builder for {@link Slides}.
*
*
* Implementation is not thread-safe.
*
*
* @since 1.3.0
*/
public static final class Builder extends com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient.Builder {
/**
* 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,
DEFAULT_ROOT_URL,
DEFAULT_SERVICE_PATH,
httpRequestInitializer,
false);
}
/** Builds a new instance of {@link Slides}. */
@Override
public Slides build() {
return new Slides(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 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 SlidesRequestInitializer}.
*
* @since 1.12
*/
public Builder setSlidesRequestInitializer(
SlidesRequestInitializer slidesRequestInitializer) {
return (Builder) super.setGoogleClientRequestInitializer(slidesRequestInitializer);
}
@Override
public Builder setGoogleClientRequestInitializer(
com.google.api.client.googleapis.services.GoogleClientRequestInitializer googleClientRequestInitializer) {
return (Builder) super.setGoogleClientRequestInitializer(googleClientRequestInitializer);
}
}
}