Class AdvertisersResource.InsertionOrdersResource.ListRequest
Lists insertion orders in an advertiser. The order is defined by the order_by parameter. If a filter by
entity_status is not specified, insertion orders with ENTITY_STATUS_ARCHIVED
will not be included in
the results.
Inheritance
Inherited Members
Namespace: Google.Apis.DisplayVideo.v1
Assembly: Google.Apis.DisplayVideo.v1.dll
Syntax
public class ListRequest : DisplayVideoBaseServiceRequest<ListInsertionOrdersResponse>, IClientServiceRequest<ListInsertionOrdersResponse>, IClientServiceRequest
Constructors
ListRequest(IClientService, Int64)
Constructs a new List request.
Declaration
public ListRequest(IClientService service, long advertiserId)
Parameters
Type | Name | Description |
---|---|---|
IClientService | service | |
System.Int64 | advertiserId |
Properties
AdvertiserId
Required. The ID of the advertiser to list insertion orders for.
Declaration
[RequestParameter("advertiserId", RequestParameterType.Path)]
public virtual long AdvertiserId { get; }
Property Value
Type | Description |
---|---|
System.Int64 |
Filter
Allows filtering by insertion order properties. Supported syntax: * Filter expressions are made up
of one or more restrictions. * Restrictions can be combined by AND
or OR
logical operators. A
sequence of restrictions implicitly uses AND
. * A restriction has the form of {field} {operator}
{value}
. * The operator used on budget.budget_segments.date_range.end_date
must be LESS THAN
(<). * The operator used on updateTime
must be GREATER THAN OR EQUAL TO (&gt;=)
or
LESS THAN OR EQUAL TO (&lt;=)
. * The operators used on all other fields must be EQUALS (=)
.
- Supported fields: -
campaignId
-displayName
-entityStatus
-budget.budget_segments.date_range.end_date
(input as YYYY-MM-DD) -updateTime
(input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All insertion orders under a campaign:campaignId="1234"
* AllENTITY_STATUS_ACTIVE
orENTITY_STATUS_PAUSED
insertion orders under an advertiser:(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
* All insertion orders whose budget segments' dates end before March 28, 2019:budget.budget_segments.date_range.end_date&lt;"2019-03-28"
* All insertion orders with an update time less than or equal to2020-11-04T18:54:47Z (format of ISO 8601)
:updateTime&lt;="2020-11-04T18:54:47Z"
* All insertion orders with an update time greater than or equal to2020-11-04T18:54:47Z (format of ISO 8601)
:updateTime&gt;="2020-11-04T18:54:47Z"
The length of this field should be no more than 500 characters.
Declaration
[RequestParameter("filter", RequestParameterType.Query)]
public virtual string Filter { get; set; }
Property Value
Type | Description |
---|---|
System.String |
HttpMethod
Gets the HTTP method.
Declaration
public override string HttpMethod { get; }
Property Value
Type | Description |
---|---|
System.String |
Overrides
MethodName
Gets the method name.
Declaration
public override string MethodName { get; }
Property Value
Type | Description |
---|---|
System.String |
Overrides
OrderBy
Field by which to sort the list. Acceptable values are: * "displayName" (default) * "entityStatus" *
"updateTime" The default sorting order is ascending. To specify descending order for a field, a
suffix "desc" should be added to the field name. Example: displayName desc
.
Declaration
[RequestParameter("orderBy", RequestParameterType.Query)]
public virtual string OrderBy { get; set; }
Property Value
Type | Description |
---|---|
System.String |
PageSize
Requested page size. Must be between 1
and 100
. If unspecified will default to 100
. Returns
error code INVALID_ARGUMENT
if an invalid value is specified.
Declaration
[RequestParameter("pageSize", RequestParameterType.Query)]
public virtual int? PageSize { get; set; }
Property Value
Type | Description |
---|---|
System.Nullable<System.Int32> |
PageToken
A token identifying a page of results the server should return. Typically, this is the value of
next_page_token returned from the previous call to ListInsertionOrders
method. If not specified,
the first page of results will be returned.
Declaration
[RequestParameter("pageToken", RequestParameterType.Query)]
public virtual string PageToken { get; set; }
Property Value
Type | Description |
---|---|
System.String |
RestPath
Gets the REST path.
Declaration
public override string RestPath { get; }
Property Value
Type | Description |
---|---|
System.String |
Overrides
Methods
InitParameters()
Initializes List parameter list.
Declaration
protected override void InitParameters()