Class AbstractGoogleClient (2.5.0)

public abstract class AbstractGoogleClient

Abstract thread-safe Google client.

Inheritance

java.lang.Object > AbstractGoogleClient

Constructors

AbstractGoogleClient(AbstractGoogleClient.Builder builder)

protected AbstractGoogleClient(AbstractGoogleClient.Builder builder)
Parameter
Name Description
builder AbstractGoogleClient.Builder

builder

Methods

batch()

public final BatchRequest batch()

Create an BatchRequest object from this Google API client instance.

Sample usage:


 client.batch()
    .queue(...)
    .queue(...)
    .execute();
 
Returns
Type Description
BatchRequest

newly created Batch request

batch(HttpRequestInitializer httpRequestInitializer)

public final BatchRequest batch(HttpRequestInitializer httpRequestInitializer)

Create an BatchRequest object from this Google API client instance.

Sample usage:


 client.batch(httpRequestInitializer)
    .queue(...)
    .queue(...)
    .execute();
 
Parameter
Name Description
httpRequestInitializer com.google.api.client.http.HttpRequestInitializer

The initializer to use when creating the top-level batch HTTP request or null for none

Returns
Type Description
BatchRequest

newly created Batch request

getApplicationName()

public final String getApplicationName()

Returns the application name to be sent in the User-Agent header of each request or null for none.

Returns
Type Description
String

getBaseUrl()

public final String getBaseUrl()

Returns the URL-encoded base URL of the service, for example "https://www.googleapis.com/tasks/v1/".

Must end with a "/". It is guaranteed to be equal to getRootUrl() + getServicePath().

Returns
Type Description
String

getGoogleClientRequestInitializer()

public final GoogleClientRequestInitializer getGoogleClientRequestInitializer()

Returns the Google client request initializer or null for none.

Returns
Type Description
GoogleClientRequestInitializer

getObjectParser()

public ObjectParser getObjectParser()

Returns the object parser or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Returns
Type Description
com.google.api.client.util.ObjectParser

getRequestFactory()

public final HttpRequestFactory getRequestFactory()

Returns the HTTP request factory.

Returns
Type Description
com.google.api.client.http.HttpRequestFactory

getRootUrl()

public final String getRootUrl()

Returns the URL-encoded root URL of the service, for example "https://www.googleapis.com/".

Must end with a "/".

Returns
Type Description
String

getServicePath()

public final String getServicePath()

Returns the URL-encoded service path of the service, for example "tasks/v1/".

Must end with a "/" and not begin with a "/". It is allowed to be an empty string "" or a forward slash "/", if it is a forward slash then it is treated as an empty string

Returns
Type Description
String

getSuppressPatternChecks()

public final boolean getSuppressPatternChecks()

Returns whether discovery pattern checks should be suppressed on required parameters.

Returns
Type Description
boolean

getSuppressRequiredParameterChecks()

public final boolean getSuppressRequiredParameterChecks()

Returns whether discovery required parameter checks should be suppressed.

Returns
Type Description
boolean

getUniverseDomain()

public final String getUniverseDomain()

Universe Domain is the domain for Google Cloud Services. It follows the format of {ServiceName}.{UniverseDomain}. For example, speech.googleapis.com would have a Universe Domain value of googleapis.com and cloudasset.test.com would have a Universe Domain of test.com. If this value is not set, this will default to googleapis.com.

Returns
Type Description
String

The configured Universe Domain or the Google Default Universe (googleapis.com)

initialize(AbstractGoogleClientRequest<?> httpClientRequest)

protected void initialize(AbstractGoogleClientRequest<?> httpClientRequest)

Initializes a AbstractGoogleClientRequest using a GoogleClientRequestInitializer.

Must be called before the Google client request is executed, preferably right after the request is instantiated. Sample usage:


 public class Get extends HttpClientRequest {
   ...
 }

 public Get get(String userId) throws IOException {
   Get result = new Get(userId);
   initialize(result);
   return result;
 }
 

Subclasses may override by calling the super implementation.

Parameter
Name Description
httpClientRequest AbstractGoogleClientRequest<?>

Google client request type

Exceptions
Type Description
IOException

validateUniverseDomain()

public void validateUniverseDomain()

Check that the User configured universe domain matches the Credentials' universe domain. This uses the HttpRequestInitializer to get the Credentials and is enforced that the HttpRequestInitializer is of the {@see HttpCredentialsAdapter} from the google-auth-library.

To use a non-GDU Credentials, you must use the HttpCredentialsAdapter class.

Exceptions
Type Description
IOException

if there is an error reading the Universe Domain from the credentials