com.google.api.ads.adwords.v201109.o
Interface TargetingIdeaServiceInterface

All Superinterfaces:

Remote

All Known Implementing Classes:

TargetingIdeaServiceSoapBindingStub

public interface TargetingIdeaServiceInterface
extends Remote

Method Summary

TargetingIdeaPage	get(TargetingIdeaSelector selector) Returns a page of ideas that match the query described by the specified TargetingIdeaSelector.
TargetingIdeaPage	getBulkKeywordIdeas(TargetingIdeaSelector selector) Returns a page of ideas that match the query described by the specified TargetingIdeaSelector.

Method Detail

get

TargetingIdeaPage get(TargetingIdeaSelector selector)
                      throws RemoteException,
                             ApiException

Returns a page of ideas that match the query described by the specified TargetingIdeaSelector.

The selector must specify a paging value, with numberResults set to 800 or less. Large result sets must be composed through multiple calls to this method, advancing the paging startIndex value by numberResults with each call.

Only a relatively small total number of results will be available through this method. Much larger result sets may be available using getBulkKeywordIdeas(TargetingIdeaSelector) at the price of reduced flexibility in selector options.

Parameters:

selector - Query describing the types of results to return when finding matches (similar keyword ideas/placement ideas).

Returns:

A TargetingIdeaPage of results, that is a subset of the list of possible ideas meeting the criteria of the TargetingIdeaSelector.

Throws:

ApiException - If problems occurred while querying for ideas.

RemoteException

getBulkKeywordIdeas

TargetingIdeaPage getBulkKeywordIdeas(TargetingIdeaSelector selector)
                                      throws RemoteException,
                                             ApiException

Returns a page of ideas that match the query described by the specified TargetingIdeaSelector. This method is specialized for returning bulk keyword ideas, and thus the selector must be set for com.google.ads.api.services.targetingideas.attributes.RequestType#IDEAS and com.google.ads.api.services.common.optimization.attributes.IdeaType#KEYWORD. A limited, fixed set of attributes will be returned.

A single-valued com.google.ads.api.services.targetingideas.search.RelatedToUrlSearchParameter must be supplied. Single-valued com.google.ads.api.services.targetingideas.search.LanguageSearchParameter and com.google.ads.api.services.targetingideas.search.LocationSearchParameter are both optional. Other search parameters compatible with a keyword query may also be supplied.

The selector must specify a paging value, with numberResults set to 500 or less. Large result sets must be composed through multiple calls to this method, advancing the paging startIndex value by numberResults with each call.

This method can make many more results available than get(TargetingIdeaSelector), but allows less control over the query. For fine-tuned queries that do not need large numbers of results, prefer get(TargetingIdeaSelector).

Parameters:

selector - Query describing the bulk keyword ideas to return.

Returns:

A TargetingIdeaPage of results, that is a subset of the list of possible ideas meeting the criteria of the TargetingIdeaSelector.

Throws:

ApiException - If problems occurred while querying for ideas.

RemoteException