Ads API .NET library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
Google.Api.Ads.AdWords.v201809.AdParamService Class Reference

Use this service to manage ad parameters, which let you quickly update parameterized values (such as prices or inventory levels) in a text ad. Whereas updates to regular ad text can take hours to go live, updates to parameterized values go live in minutes. More...

Inheritance diagram for Google.Api.Ads.AdWords.v201809.AdParamService:
Google.Api.Ads.AdWords.v201809.IAdParamService Google.Api.Ads.AdWords.v201809.AdParamServiceInterface

Public Member Functions

 AdParamService ()
 Creates a new instance of the AdParamService class. More...
 
 AdParamService (string endpointConfigurationName)
 Creates a new instance of the AdParamService class. More...
 
 AdParamService (string endpointConfigurationName, string remoteAddress)
 Creates a new instance of the AdParamService class. More...
 
 AdParamService (string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress)
 Creates a new instance of the AdParamService class. More...
 
 AdParamService (System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress)
 Creates a new instance of the AdParamService class. More...
 
virtual
Google.Api.Ads.AdWords.v201809.AdParamPage 
get (Google.Api.Ads.AdWords.v201809.Selector serviceSelector)
 Returns the ad parameters that match the criteria specified in the selector. More...
 
virtual
System.Threading.Tasks.Task
< Google.Api.Ads.AdWords.v201809.AdParamPage
getAsync (Google.Api.Ads.AdWords.v201809.Selector serviceSelector)
 
virtual
Google.Api.Ads.AdWords.v201809.AdParam[] 
mutate (Google.Api.Ads.AdWords.v201809.AdParamOperation[] operations)
 Sets and removes ad parameters. More...
 
virtual
System.Threading.Tasks.Task
< Google.Api.Ads.AdWords.v201809.AdParam[]> 
mutateAsync (Google.Api.Ads.AdWords.v201809.AdParamOperation[] operations)
 

Detailed Description

Use this service to manage ad parameters, which let you quickly update parameterized values (such as prices or inventory levels) in a text ad. Whereas updates to regular ad text can take hours to go live, updates to parameterized values go live in minutes.

To define where parameterized values appear in an ad, you insert {param#:default-value} tags in your ad text. You can use these tags in any line of display text, and also in the destination URL. When the text ad is displayed, values in these tags are replaced by the ad parameter's insertion text. default-value specifies the string to display if one of the following conditions is true:

  • The parameter has not been set.
  • The parameter's insertion text is too long for the display line.
  • The ad is being shown on the Google Display Network.

This is disabled for AdX.

Constructor & Destructor Documentation

Google.Api.Ads.AdWords.v201809.AdParamService.AdParamService ( )
inline

Creates a new instance of the AdParamService class.

Google.Api.Ads.AdWords.v201809.AdParamService.AdParamService ( string  endpointConfigurationName)
inline

Creates a new instance of the AdParamService class.

Google.Api.Ads.AdWords.v201809.AdParamService.AdParamService ( string  endpointConfigurationName,
string  remoteAddress 
)
inline

Creates a new instance of the AdParamService class.

Google.Api.Ads.AdWords.v201809.AdParamService.AdParamService ( string  endpointConfigurationName,
System.ServiceModel.EndpointAddress  remoteAddress 
)
inline

Creates a new instance of the AdParamService class.

Google.Api.Ads.AdWords.v201809.AdParamService.AdParamService ( System.ServiceModel.Channels.Binding  binding,
System.ServiceModel.EndpointAddress  remoteAddress 
)
inline

Creates a new instance of the AdParamService class.

Member Function Documentation

virtual Google.Api.Ads.AdWords.v201809.AdParamPage Google.Api.Ads.AdWords.v201809.AdParamService.get ( Google.Api.Ads.AdWords.v201809.Selector  serviceSelector)
inlinevirtual

Returns the ad parameters that match the criteria specified in the selector.

Parameters
serviceSelectorSpecifies which ad parameters to return.
Returns
A list of ad parameters.

Implements Google.Api.Ads.AdWords.v201809.AdParamServiceInterface.

virtual System.Threading.Tasks.Task<Google.Api.Ads.AdWords.v201809.AdParamPage> Google.Api.Ads.AdWords.v201809.AdParamService.getAsync ( Google.Api.Ads.AdWords.v201809.Selector  serviceSelector)
inlinevirtual
virtual Google.Api.Ads.AdWords.v201809.AdParam [] Google.Api.Ads.AdWords.v201809.AdParamService.mutate ( Google.Api.Ads.AdWords.v201809.AdParamOperation[]  operations)
inlinevirtual

Sets and removes ad parameters.

Note: ADD is not supported. Use SET for new ad parameters.

  • SET: Creates or updates an ad parameter, setting the new parameterized value for the given ad group / keyword pair.
  • REMOVE: Removes an ad parameter. The default-value specified in the ad text will be used.
Parameters
operationsThe operations to perform.
Returns
A list of ad parameters, where each entry in the list is the result of applying the operation in the input list with the same index. For a operation, the returned ad parameter will contain the updated values. For a REMOVE operation, the returned ad parameter will simply be the ad parameter that was removed.

Implements Google.Api.Ads.AdWords.v201809.IAdParamService.

virtual System.Threading.Tasks.Task<Google.Api.Ads.AdWords.v201809.AdParam[]> Google.Api.Ads.AdWords.v201809.AdParamService.mutateAsync ( Google.Api.Ads.AdWords.v201809.AdParamOperation[]  operations)
inlinevirtual

The documentation for this class was generated from the following file: