AdWords Lib TargetingIdea Service Class

Use this service to generate new keyword and placement ideas based on the parameters specified in the selector. See the TargetingIdeaSelector documentation for more details.

<p>You can also use this service to retrieve statistics for existing keywords and placements by setting the selector's {@code requestType} to STATS and passing in the appropriate search parameters.</p>

• copyright: Mirchev Ideas Ltd. &copy; 2011
• link: For more information about TargetingIdeaService see in Google AdWords Developer's Guide

Located in /services/TargetingIdeaService.php

awService
   |
   --awTargetingIdeaService

mixed $_serviceName = awServicesUrl::TARGETING_IDEA_SERVICE

• access: protected

---

Redefinition of:

awService::$_serviceName

Inherited Variables

Inherited from awService

awService::$_authToken
awService::$_clientCustomerId
awService::$_clientEmail
awService::$_developerToken
awService::$_partialFailure
awService::$_soapClient
awService::$_userAgent
awService::$_useSandbox
awService::$_validateOnly

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

The selector must specify a {@code paging} value, with {@code numberResults} set to 800 or less. Large result sets must be composed through multiple calls to this method, advancing the paging {@code startIndex} value by {@code 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.

• return: TargetingIdeaPage of results, that is a subset of the list of possible ideas meeting the criteria of the TargetingIdeaSelector.
• link: For more information about get see in Google AdWords Developer's Guide
• throws: ApiException If problems occurred while querying for ideas.
• access: public

A get (awTargetingIdeaSelector $targetingIdeaSelector)

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

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 IDEAS and KEYWORD. A limited, fixed set of attributes will be returned.

<p>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.

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

<p>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).

• return: TargetingIdeaPage of results, that is a subset of the list of possible ideas meeting the criteria of the
• link: TargetingIdeaSelector}.
• link: For more information about get see in Google AdWords Developer's Guide
• throws: ApiException If problems occurred while querying for ideas.
• access: public

A getBulkKeywordIdeas (awTargetingIdeaSelector $targetingIdeaSelector)

• selector $targetingIdeaSelector: Query describing the bulk keyword ideas to return.

Inherited Methods

Inherited From awService

awService::__construct()
awService::callService()
awService::checkArray()
awService::checkArrayOf()
awService::checkObjectOf()
awService::getAuthToken()
awService::getClientCustomerId()
awService::getClientEmail()
awService::getDeveloperToken()
awService::getPartialFailure()
awService::getResponseHeaders()
awService::getServiceHeaders()
awService::getServiceName()
awService::getServiceUrl()
awService::getSoapClient()
awService::getUserAgent()
awService::getValidateOnly()
awService::isUsingSandbox()
awService::returnResponseAsArrayOf()
awService::returnResponseAsObjectOf()
awService::setAuthToken()
awService::setClientCustomerId()
awService::setClientEmail()
awService::setDeveloperToken()
awService::setPartialFailure()
awService::setServiceHeaders()
awService::setUserAgent()
awService::setValidateOnly()
awService::useSandbox()