Show / Hide Table of Contents

Class AdsResource.ListRequest

Retrieves a list of ads, possibly filtered. This method supports paging.

Inheritance
System.Object
Google.Apis.Requests.ClientServiceRequest
Google.Apis.Requests.ClientServiceRequest<AdsListResponse>
DfareportingBaseServiceRequest<AdsListResponse>
AdsResource.ListRequest
Implements
Google.Apis.Requests.IClientServiceRequest<AdsListResponse>
Google.Apis.Requests.IClientServiceRequest
Inherited Members
DfareportingBaseServiceRequest<AdsListResponse>.Xgafv
DfareportingBaseServiceRequest<AdsListResponse>.AccessToken
DfareportingBaseServiceRequest<AdsListResponse>.Alt
DfareportingBaseServiceRequest<AdsListResponse>.Callback
DfareportingBaseServiceRequest<AdsListResponse>.Fields
DfareportingBaseServiceRequest<AdsListResponse>.Key
DfareportingBaseServiceRequest<AdsListResponse>.OauthToken
DfareportingBaseServiceRequest<AdsListResponse>.PrettyPrint
DfareportingBaseServiceRequest<AdsListResponse>.QuotaUser
DfareportingBaseServiceRequest<AdsListResponse>.UploadType
DfareportingBaseServiceRequest<AdsListResponse>.UploadProtocol
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.Execute()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ExecuteAsStream()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ExecuteAsync()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ExecuteAsync(System.Threading.CancellationToken)
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ExecuteAsStreamAsync()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ExecuteAsStreamAsync(System.Threading.CancellationToken)
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.CreateRequest(System.Nullable<System.Boolean>)
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.GenerateRequestUri()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.GetBody()
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.GetDefaultETagAction(System.String)
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ETagAction
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ModifyRequest
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.ValidateParameters
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.RequestParameters
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.Service
Google.Apis.Requests.ClientServiceRequest._unsuccessfulResponseHandlers
Google.Apis.Requests.ClientServiceRequest._exceptionHandlers
Google.Apis.Requests.ClientServiceRequest._executeInterceptors
Google.Apis.Requests.ClientServiceRequest.AddUnsuccessfulResponseHandler(Google.Apis.Http.IHttpUnsuccessfulResponseHandler)
Google.Apis.Requests.ClientServiceRequest.AddExceptionHandler(Google.Apis.Http.IHttpExceptionHandler)
Google.Apis.Requests.ClientServiceRequest.AddExecuteInterceptor(Google.Apis.Http.IHttpExecuteInterceptor)
Google.Apis.Requests.ClientServiceRequest.Credential
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Google.Apis.Dfareporting.v3_4
Assembly: Google.Apis.Dfareporting.v3_4.dll
Syntax
public class ListRequest : DfareportingBaseServiceRequest<AdsListResponse>, IClientServiceRequest<AdsListResponse>, IClientServiceRequest

Constructors

ListRequest(IClientService, Int64)

Constructs a new List request.

Declaration
public ListRequest(IClientService service, long profileId)
Parameters
Type Name Description
Google.Apis.Services.IClientService service
System.Int64 profileId

Properties

Active

Select only active ads.

Declaration
[RequestParameter("active", RequestParameterType.Query)]
public virtual bool? Active { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

AdvertiserId

Select only ads with this advertiser ID.

Declaration
[RequestParameter("advertiserId", RequestParameterType.Query)]
public virtual long? AdvertiserId { get; set; }
Property Value
Type Description
System.Nullable<System.Int64>

Archived

Select only archived ads.

Declaration
[RequestParameter("archived", RequestParameterType.Query)]
public virtual bool? Archived { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

AudienceSegmentIds

Select only ads with these audience segment IDs.

Declaration
[RequestParameter("audienceSegmentIds", RequestParameterType.Query)]
public virtual Repeatable<string> AudienceSegmentIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

CampaignIds

Select only ads with these campaign IDs.

Declaration
[RequestParameter("campaignIds", RequestParameterType.Query)]
public virtual Repeatable<string> CampaignIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

Compatibility

Select default ads with the specified compatibility. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering an in-stream video ads developed with the VAST standard.

Declaration
[RequestParameter("compatibility", RequestParameterType.Query)]
public virtual AdsResource.ListRequest.CompatibilityEnum? Compatibility { get; set; }
Property Value
Type Description
System.Nullable<AdsResource.ListRequest.CompatibilityEnum>

CreativeIds

Select only ads with these creative IDs assigned.

Declaration
[RequestParameter("creativeIds", RequestParameterType.Query)]
public virtual Repeatable<string> CreativeIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

CreativeOptimizationConfigurationIds

Select only ads with these creative optimization configuration IDs.

Declaration
[RequestParameter("creativeOptimizationConfigurationIds", RequestParameterType.Query)]
public virtual Repeatable<string> CreativeOptimizationConfigurationIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

DynamicClickTracker

Select only dynamic click trackers. Applicable when type is AD_SERVING_CLICK_TRACKER. If true, select dynamic click trackers. If false, select static click trackers. Leave unset to select both.

Declaration
[RequestParameter("dynamicClickTracker", RequestParameterType.Query)]
public virtual bool? DynamicClickTracker { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

HttpMethod

Gets the HTTP method.

Declaration
public override string HttpMethod { get; }
Property Value
Type Description
System.String
Overrides
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.HttpMethod

Ids

Select only ads with these IDs.

Declaration
[RequestParameter("ids", RequestParameterType.Query)]
public virtual Repeatable<string> Ids { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

LandingPageIds

Select only ads with these landing page IDs.

Declaration
[RequestParameter("landingPageIds", RequestParameterType.Query)]
public virtual Repeatable<string> LandingPageIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

MaxResults

Maximum number of results to return.

Declaration
[RequestParameter("maxResults", RequestParameterType.Query)]
public virtual int? MaxResults { get; set; }
Property Value
Type Description
System.Nullable<System.Int32>

MethodName

Gets the method name.

Declaration
public override string MethodName { get; }
Property Value
Type Description
System.String
Overrides
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.MethodName

OverriddenEventTagId

Select only ads with this event tag override ID.

Declaration
[RequestParameter("overriddenEventTagId", RequestParameterType.Query)]
public virtual long? OverriddenEventTagId { get; set; }
Property Value
Type Description
System.Nullable<System.Int64>

PageToken

Value of the nextPageToken from the previous result page.

Declaration
[RequestParameter("pageToken", RequestParameterType.Query)]
public virtual string PageToken { get; set; }
Property Value
Type Description
System.String

PlacementIds

Select only ads with these placement IDs assigned.

Declaration
[RequestParameter("placementIds", RequestParameterType.Query)]
public virtual Repeatable<string> PlacementIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

ProfileId

User profile ID associated with this request.

Declaration
[RequestParameter("profileId", RequestParameterType.Path)]
public virtual long ProfileId { get; }
Property Value
Type Description
System.Int64

RemarketingListIds

Select only ads whose list targeting expression use these remarketing list IDs.

Declaration
[RequestParameter("remarketingListIds", RequestParameterType.Query)]
public virtual Repeatable<string> RemarketingListIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

RestPath

Gets the REST path.

Declaration
public override string RestPath { get; }
Property Value
Type Description
System.String
Overrides
Google.Apis.Requests.ClientServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.RestPath

SearchString

Allows searching for objects by name or ID. Wildcards () are allowed. For example, "ad2015" will return objects with names like "ad June 2015", "ad April 2015", or simply "ad 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "ad" will match objects with name "my ad", "ad 2015", or simply "ad".

Declaration
[RequestParameter("searchString", RequestParameterType.Query)]
public virtual string SearchString { get; set; }
Property Value
Type Description
System.String

SizeIds

Select only ads with these size IDs.

Declaration
[RequestParameter("sizeIds", RequestParameterType.Query)]
public virtual Repeatable<string> SizeIds { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<System.String>

SortField

Field by which to sort the list.

Declaration
[RequestParameter("sortField", RequestParameterType.Query)]
public virtual AdsResource.ListRequest.SortFieldEnum? SortField { get; set; }
Property Value
Type Description
System.Nullable<AdsResource.ListRequest.SortFieldEnum>

SortOrder

Order of sorted results.

Declaration
[RequestParameter("sortOrder", RequestParameterType.Query)]
public virtual AdsResource.ListRequest.SortOrderEnum? SortOrder { get; set; }
Property Value
Type Description
System.Nullable<AdsResource.ListRequest.SortOrderEnum>

SslCompliant

Select only ads that are SSL-compliant.

Declaration
[RequestParameter("sslCompliant", RequestParameterType.Query)]
public virtual bool? SslCompliant { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

SslRequired

Select only ads that require SSL.

Declaration
[RequestParameter("sslRequired", RequestParameterType.Query)]
public virtual bool? SslRequired { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

Type

Select only ads with these types.

Declaration
[RequestParameter("type", RequestParameterType.Query)]
public virtual AdsResource.ListRequest.TypeEnum? Type { get; set; }
Property Value
Type Description
System.Nullable<AdsResource.ListRequest.TypeEnum>
Remarks

Use this property to set a single value for the parameter, or TypeList to set multiple values. Do not set both properties.

TypeList

Select only ads with these types.

Declaration
[RequestParameter("type", RequestParameterType.Query)]
public virtual Repeatable<AdsResource.ListRequest.TypeEnum> TypeList { get; set; }
Property Value
Type Description
Google.Apis.Util.Repeatable<AdsResource.ListRequest.TypeEnum>
Remarks

Use this property to set one or more values for the parameter. Do not set both this property and Type.

Methods

InitParameters()

Initializes List parameter list.

Declaration
protected override void InitParameters()
Overrides
Google.Apis.Dfareporting.v3_4.DfareportingBaseServiceRequest<Google.Apis.Dfareporting.v3_4.Data.AdsListResponse>.InitParameters()

Implements

Google.Apis.Requests.IClientServiceRequest<TResponse>
Google.Apis.Requests.IClientServiceRequest
In This Article
Back to top