com.google.api.ads.admanager.lib.client

Class AdManagerSession.Builder

java.lang.Object

com.google.api.ads.admanager.lib.client.AdManagerSession.Builder

All Implemented Interfaces:

Builder<AdManagerSession>

Enclosing class:

AdManagerSession

public static class AdManagerSession.Builder
extends Object
implements Builder<AdManagerSession>

Builder for AdManagerSession.

Implementation is not thread-safe.

Field Summary

Fields inherited from interface com.google.api.ads.common.lib.utils.Builder

DEFAULT_CONFIGURATION_FILENAME

Constructor Summary

Constructors

Constructor and Description
Builder() Constructs an empty builder.

Method Summary

Modifier and Type	Method and Description
AdManagerSession	build() Builds the AdManagerSession.
AdManagerSession.ImmutableAdManagerSession	buildImmutable() Builds a thread-safe AdManagerSession.ImmutableAdManagerSession.
AdManagerSession.Builder	from(org.apache.commons.configuration.Configuration config) Reads properties from the provided Configuration object. Known properties: api.admanager.applicationName api.admanager.networkCode api.admanager.endpoint
AdManagerSession.Builder	fromFile() Loads credentials from the "ads.properties" file in one of the following locations according to the following order: in the current directory, in the user home directory, in the classpath
AdManagerSession.Builder	fromFile(File path) Populates this builder from a properties file from a specified path.
AdManagerSession.Builder	fromFile(String path) Populates this builder from a properties file from a specified path.
AdManagerSession.Builder	fromFile(URL path) Populates this builder from a properties file from a specified path.
AdManagerSession.Builder	withApplicationName(String applicationName) Includes application name (any string of your choice).
AdManagerSession.Builder	withEndpoint(String endpoint) Override the endpoint server.
AdManagerSession.Builder	withNetworkCode(String networkCode) Includes network code.
AdManagerSession.Builder	withOAuth2Credential(com.google.api.client.auth.oauth2.Credential oAuth2Credential) Includes OAuth2 credential to be used for OAuth2 authentication.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Constructs an empty builder. To construct a builder initialized to the settings of an existing AdManagerSession, use AdManagerSession.newBuilder() instead.

Method Detail

fromFile

public AdManagerSession.Builder fromFile()
                                  throws com.google.api.ads.common.lib.conf.ConfigurationLoadException

Description copied from interface: Builder

Loads credentials from the "ads.properties" file in one of the following locations according to the following order: in the current directory, in the user home directory, in the classpath

Specified by:

fromFile in interface Builder<AdManagerSession>

Throws:

com.google.api.ads.common.lib.conf.ConfigurationLoadException - if the configuration could not be loaded.

fromFile

public AdManagerSession.Builder fromFile(String path)
                                  throws com.google.api.ads.common.lib.conf.ConfigurationLoadException

Description copied from interface: Builder

Populates this builder from a properties file from a specified path. If not absolute, will look in user home directory, the current classpath and the system classpath.

Specified by:

fromFile in interface Builder<AdManagerSession>

Parameters:

path - the path to try first as a resource, then as a file

Returns:

Builder populated with properties.

Throws:

com.google.api.ads.common.lib.conf.ConfigurationLoadException - if the configuration could not be loaded.

fromFile

public AdManagerSession.Builder fromFile(File path)
                                  throws com.google.api.ads.common.lib.conf.ConfigurationLoadException

Description copied from interface: Builder

Populates this builder from a properties file from a specified path.

Specified by:

fromFile in interface Builder<AdManagerSession>

Parameters:

path - the path to load properties from

Returns:

Builder populated with properties.

Throws:

com.google.api.ads.common.lib.conf.ConfigurationLoadException - if the configuration could not be loaded.

fromFile

public AdManagerSession.Builder fromFile(URL path)
                                  throws com.google.api.ads.common.lib.conf.ConfigurationLoadException

Description copied from interface: Builder

Populates this builder from a properties file from a specified path. If not absolute, will look in user home directory, the current classpath and the system classpath.

Specified by:

fromFile in interface Builder<AdManagerSession>

Parameters:

path - the path to try first as a resource, then as a file

Returns:

Builder populated with properties.

Throws:

com.google.api.ads.common.lib.conf.ConfigurationLoadException - if the configuration could not be loaded.

from

public AdManagerSession.Builder from(org.apache.commons.configuration.Configuration config)

Reads properties from the provided Configuration object.

Known properties:

• api.admanager.applicationName
• api.admanager.networkCode
• api.admanager.endpoint

Specified by:

from in interface Builder<AdManagerSession>

Parameters:

config - the configuration

Returns:

Builder populated from the configuration

withOAuth2Credential

public AdManagerSession.Builder withOAuth2Credential(com.google.api.client.auth.oauth2.Credential oAuth2Credential)

Includes OAuth2 credential to be used for OAuth2 authentication.

withNetworkCode

public AdManagerSession.Builder withNetworkCode(String networkCode)

Includes network code. Required for most service calls.

withApplicationName

public AdManagerSession.Builder withApplicationName(String applicationName)

Includes application name (any string of your choice). Required.

withEndpoint

public AdManagerSession.Builder withEndpoint(String endpoint)

Override the endpoint server. Optional and defaults to https://ads.google.com/.

build

public AdManagerSession build()
                       throws ValidationException

Builds the AdManagerSession.

Specified by:

build in interface Builder<AdManagerSession>

Returns:

the built AdManagerSession

Throws:

ValidationException - if the AdManagerSession did not validate

buildImmutable

public AdManagerSession.ImmutableAdManagerSession buildImmutable()
                                                          throws ValidationException

Builds a thread-safe AdManagerSession.ImmutableAdManagerSession.

Returns:

the built ImmutableAdManagerSession

Throws:

ValidationException - if the attributes of this builder fail validation