com.google.api.ads.adwords.jaxws.utils.v201708

Class SelectorBuilder

java.lang.Object

com.google.api.ads.adwords.jaxws.utils.v201708.SelectorBuilder

All Implemented Interfaces:

SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

public class SelectorBuilder
extends Object
implements SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

A builder for Selector objects. This builder is not thread safe.

Constructor Summary

Constructors

Constructor and Description
SelectorBuilder()

Method Summary

Modifier and Type	Method and Description
com.google.api.ads.adwords.jaxws.v201708.cm.Selector	build() Builds a new Selector.
SelectorBuilder	contains(EntityField field, String propertyValue) Adds the predicate contains to the selector for the given field and value.
SelectorBuilder	contains(String field, String propertyValue) Adds the predicate contains to the selector for the given field and value.
SelectorBuilder	containsAll(EntityField field, String... values) Adds the predicate contains all to the selector for the given field and value.
SelectorBuilder	containsAll(String field, String... values) Adds the predicate contains all to the selector for the given field and value.
SelectorBuilder	containsAny(EntityField field, String... values) Adds the predicate contains any to the selector for the given field and value.
SelectorBuilder	containsAny(String field, String... values) Adds the predicate contains any to the selector for the given field and value.
SelectorBuilder	containsIgnoreCase(EntityField field, String propertyValue) Adds the predicate contains ignore case to the selector for the given field and value.
SelectorBuilder	containsIgnoreCase(String field, String propertyValue) Adds the predicate contains ignore case to the selector for the given field and value.
SelectorBuilder	containsNone(EntityField field, String... values) Adds the predicate contains none to the selector for the given field and value.
SelectorBuilder	containsNone(String field, String... values) Adds the predicate contains none to the selector for the given field and value.
SelectorBuilder	doesNotContain(EntityField field, String propertyValue) Adds the predicate does not contain to the selector for the given field and value.
SelectorBuilder	doesNotContain(String field, String propertyValue) Adds the predicate does not contain to the selector for the given field and value.
SelectorBuilder	doesNotContainIgnoreCase(EntityField field, String propertyValue) Adds the predicate does not contain ignore case to the selector for the given field and value.
SelectorBuilder	doesNotContainIgnoreCase(String field, String propertyValue) Adds the predicate does not contain ignore case to the selector for the given field and value.
SelectorBuilder	equals(EntityField field, String propertyValue) Adds the predicate equals to the selector for the given field and value.
SelectorBuilder	equals(String field, String propertyValue) Adds the predicate equals to the selector for the given field and value.
SelectorBuilder	equalsId(Long id) Adds the predicate equals to the selector for the entity Id and the given id value.
SelectorBuilder	fields(EntityField... fields) Chooses the set of fields that will be selected via the API.
SelectorBuilder	fields(String... fields) Chooses the set of fields that will be selected via the API.
SelectorBuilder	forDateRange(org.joda.time.DateTime start, org.joda.time.DateTime end) Restricts the Selector by the date range.
SelectorBuilder	greaterThan(EntityField field, long propertyValue) Adds the predicate greater than to the selector for the given field and value.
SelectorBuilder	greaterThan(String field, long propertyValue) Adds the predicate greater than to the selector for the given field and value.
SelectorBuilder	greaterThanEquals(EntityField field, long propertyValue) Adds the predicate greater than equals to the selector for the given field and value.
SelectorBuilder	greaterThanEquals(String field, long propertyValue) Adds the predicate greater than equals to the selector for the given field and value.
SelectorBuilder	in(EntityField field, String... values) Adds the predicate in to the selector for the given field and set of values.
SelectorBuilder	in(String field, String... values) Adds the predicate in to the selector for the given field and set of values.
SelectorBuilder	increaseOffsetBy(int additionalOffset) Adds the given amount to the current offset.
SelectorBuilder	lessThan(EntityField field, long propertyValue) Adds the predicate less than to the selector for the given field and value.
SelectorBuilder	lessThan(String field, long propertyValue) Adds the predicate less than to the selector for the given field and value.
SelectorBuilder	lessThanEquals(EntityField field, long propertyValue) Adds the predicate less than equals to the selector for the given field and value.
SelectorBuilder	lessThanEquals(String field, long propertyValue) Adds the predicate less than equals to the selector for the given field and value.
SelectorBuilder	limit(int limit) Sets the limit amount of results that will be brought back.
SelectorBuilder	notEquals(EntityField field, String propertyValue) Adds the predicate not equals to the selector for the given field and value.
SelectorBuilder	notEquals(String field, String propertyValue) Adds the predicate not equals to the selector for the given field and value.
SelectorBuilder	notIn(EntityField field, String... values) Adds the predicate not in to the selector for the given field and set of values.
SelectorBuilder	notIn(String field, String... values) Adds the predicate not in to the selector for the given field and set of values.
SelectorBuilder	offset(int offset) Sets the offset for the start point of the query.
SelectorBuilder	orderAscBy(EntityField field) Adds the order by the given field, on ASCENDING sort.
SelectorBuilder	orderAscBy(String field) Adds the order by the given field, on ASCENDING sort.
SelectorBuilder	orderDescBy(EntityField field) Adds the order by the given field, on DESCENDING sort.
SelectorBuilder	orderDescBy(String field) Adds the order by the given field, on DESCENDING sort.
SelectorBuilder	removeLimitAndOffset() Removes the offset and limit information from the selector.
SelectorBuilder	removeOrderBy(EntityField field) Removes the order that is associated with the given field.
SelectorBuilder	removeOrderBy(String field) Removes the order that is associated with the given field.

Methods inherited from class java.lang.Object

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

Constructor Detail

SelectorBuilder

public SelectorBuilder()

Method Detail

build

public com.google.api.ads.adwords.jaxws.v201708.cm.Selector build()

Description copied from interface: SelectorBuilderInterface

Builds a new Selector.

When a Selector is built by this method, the state of the builder doesn't change. If you need to clean the builder, the best way to do it, is by creating a new instance.

Specified by:

build in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the new Selector containing all the configuration that was set previously.

fields

public SelectorBuilder fields(String... fields)

Description copied from interface: SelectorBuilderInterface

Chooses the set of fields that will be selected via the API.

Calling this method multiple times will overwrite the previous fields that were set.

Specified by:

fields in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Parameters:

fields - the set of fields of the given entity.

Returns:

the builder itself to proceed the chain.

fields

public SelectorBuilder fields(EntityField... fields)

Description copied from interface: SelectorBuilderInterface

Chooses the set of fields that will be selected via the API.

Calling this method multiple times will overwrite the previous fields that were set.

Specified by:

fields in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Parameters:

fields - the set of fields of the given entity as Java Enums.

Returns:

the builder itself to proceed the chain.

increaseOffsetBy

public SelectorBuilder increaseOffsetBy(int additionalOffset)

Description copied from interface: SelectorBuilderInterface

Adds the given amount to the current offset.

Specified by:

increaseOffsetBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Parameters:

additionalOffset - the amount that will be added to the offset

Returns:

the builder itself to proceed the chain.

limit

public SelectorBuilder limit(int limit)

Description copied from interface: SelectorBuilderInterface

Sets the limit amount of results that will be brought back. Calling this method overrides the previous limit value.

Specified by:

limit in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

offset

public SelectorBuilder offset(int offset)

Description copied from interface: SelectorBuilderInterface

Sets the offset for the start point of the query. Calling this method overrides the previous offset value.

Specified by:

offset in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Parameters:

offset - the offset

Returns:

the builder itself to proceed the chain.

removeLimitAndOffset

public SelectorBuilder removeLimitAndOffset()

Description copied from interface: SelectorBuilderInterface

Removes the offset and limit information from the selector.

Specified by:

removeLimitAndOffset in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

orderAscBy

public SelectorBuilder orderAscBy(String field)

Description copied from interface: SelectorBuilderInterface

Adds the order by the given field, on ASCENDING sort.

Specified by:

orderAscBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

orderAscBy

public SelectorBuilder orderAscBy(EntityField field)

Description copied from interface: SelectorBuilderInterface

Adds the order by the given field, on ASCENDING sort.

Specified by:

orderAscBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

orderDescBy

public SelectorBuilder orderDescBy(String field)

Description copied from interface: SelectorBuilderInterface

Adds the order by the given field, on DESCENDING sort.

Specified by:

orderDescBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

orderDescBy

public SelectorBuilder orderDescBy(EntityField field)

Description copied from interface: SelectorBuilderInterface

Adds the order by the given field, on DESCENDING sort.

Specified by:

orderDescBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

removeOrderBy

public SelectorBuilder removeOrderBy(String field)

Description copied from interface: SelectorBuilderInterface

Removes the order that is associated with the given field.

Specified by:

removeOrderBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

removeOrderBy

public SelectorBuilder removeOrderBy(EntityField field)

Description copied from interface: SelectorBuilderInterface

Removes the order that is associated with the given field.

Specified by:

removeOrderBy in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

forDateRange

public SelectorBuilder forDateRange(org.joda.time.DateTime start,
                                    org.joda.time.DateTime end)

Description copied from interface: SelectorBuilderInterface

Restricts the Selector by the date range.

Specified by:

forDateRange in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

equals

public SelectorBuilder equals(String field,
                              String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate equals to the selector for the given field and value.

Specified by:

equals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

Returns:

the builder itself to proceed the chain.

equals

public SelectorBuilder equals(EntityField field,
                              String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate equals to the selector for the given field and value.

Specified by:

equals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

Returns:

the builder itself to proceed the chain.

notEquals

public SelectorBuilder notEquals(String field,
                                 String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate not equals to the selector for the given field and value.

Specified by:

notEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

notEquals

public SelectorBuilder notEquals(EntityField field,
                                 String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate not equals to the selector for the given field and value.

Specified by:

notEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

contains

public SelectorBuilder contains(String field,
                                String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains to the selector for the given field and value.

Specified by:

contains in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

contains

public SelectorBuilder contains(EntityField field,
                                String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains to the selector for the given field and value.

Specified by:

contains in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

containsIgnoreCase

public SelectorBuilder containsIgnoreCase(String field,
                                          String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains ignore case to the selector for the given field and value.

Specified by:

containsIgnoreCase in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

containsIgnoreCase

public SelectorBuilder containsIgnoreCase(EntityField field,
                                          String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains ignore case to the selector for the given field and value.

Specified by:

containsIgnoreCase in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

doesNotContain

public SelectorBuilder doesNotContain(String field,
                                      String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate does not contain to the selector for the given field and value.

Specified by:

doesNotContain in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

doesNotContain

public SelectorBuilder doesNotContain(EntityField field,
                                      String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate does not contain to the selector for the given field and value.

Specified by:

doesNotContain in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

doesNotContainIgnoreCase

public SelectorBuilder doesNotContainIgnoreCase(String field,
                                                String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate does not contain ignore case to the selector for the given field and value.

Specified by:

doesNotContainIgnoreCase in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

doesNotContainIgnoreCase

public SelectorBuilder doesNotContainIgnoreCase(EntityField field,
                                                String propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate does not contain ignore case to the selector for the given field and value.

Specified by:

doesNotContainIgnoreCase in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

greaterThan

public SelectorBuilder greaterThan(String field,
                                   long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate greater than to the selector for the given field and value.

Specified by:

greaterThan in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

greaterThan

public SelectorBuilder greaterThan(EntityField field,
                                   long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate greater than to the selector for the given field and value.

Specified by:

greaterThan in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

greaterThanEquals

public SelectorBuilder greaterThanEquals(String field,
                                         long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate greater than equals to the selector for the given field and value.

Specified by:

greaterThanEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

greaterThanEquals

public SelectorBuilder greaterThanEquals(EntityField field,
                                         long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate greater than equals to the selector for the given field and value.

Specified by:

greaterThanEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

lessThan

public SelectorBuilder lessThan(String field,
                                long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate less than to the selector for the given field and value.

Specified by:

lessThan in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

lessThan

public SelectorBuilder lessThan(EntityField field,
                                long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate less than to the selector for the given field and value.

Specified by:

lessThan in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

lessThanEquals

public SelectorBuilder lessThanEquals(String field,
                                      long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate less than equals to the selector for the given field and value.

Specified by:

lessThanEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

lessThanEquals

public SelectorBuilder lessThanEquals(EntityField field,
                                      long propertyValue)

Description copied from interface: SelectorBuilderInterface

Adds the predicate less than equals to the selector for the given field and value.

Specified by:

lessThanEquals in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

propertyValue - the property value as a String independently of the field type. The caller should take care of the formatting if it is necessary

equalsId

public SelectorBuilder equalsId(Long id)

Description copied from interface: SelectorBuilderInterface

Adds the predicate equals to the selector for the entity Id and the given id value.

Specified by:

equalsId in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Parameters:

id - the ID of the current entity. This field represents different values for different entity types

Returns:

the builder itself to proceed the chain.

in

public SelectorBuilder in(String field,
                          String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate in to the selector for the given field and set of values.

Specified by:

in in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

in

public SelectorBuilder in(EntityField field,
                          String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate in to the selector for the given field and set of values.

Specified by:

in in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

notIn

public SelectorBuilder notIn(String field,
                             String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate not in to the selector for the given field and set of values.

Specified by:

notIn in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

notIn

public SelectorBuilder notIn(EntityField field,
                             String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate not in to the selector for the given field and set of values.

Specified by:

notIn in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsAny

public SelectorBuilder containsAny(String field,
                                   String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains any to the selector for the given field and value.

Specified by:

containsAny in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsAny

public SelectorBuilder containsAny(EntityField field,
                                   String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains any to the selector for the given field and value.

Specified by:

containsAny in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsAll

public SelectorBuilder containsAll(String field,
                                   String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains all to the selector for the given field and value.

Specified by:

containsAll in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsAll

public SelectorBuilder containsAll(EntityField field,
                                   String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains all to the selector for the given field and value.

Specified by:

containsAll in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsNone

public SelectorBuilder containsNone(String field,
                                    String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains none to the selector for the given field and value.

Specified by:

containsNone in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.

containsNone

public SelectorBuilder containsNone(EntityField field,
                                    String... values)

Description copied from interface: SelectorBuilderInterface

Adds the predicate contains none to the selector for the given field and value.

Specified by:

containsNone in interface SelectorBuilderInterface<com.google.api.ads.adwords.jaxws.v201708.cm.Selector>

Returns:

the builder itself to proceed the chain.