Method: sellers.availabilityOrders.availabilityLines.list

Lists lines for an availability order.

  • For example GET /v1/sellers/111/availabilityOrders/123/availabilityLines
  • Returns a list of availability lines and a token to retrieve the next page if successful.
  • Returns error code PERMISSION_DENIED if the user does not have access to the seller or seller id does not exist.
  • Returns error code INVALID_ARGUMENT if sellers provide an invalid page size or page token.
  • Returns error code NOT_FOUND if the availability order does not exist.

HTTP request

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource name. Format: sellers/{seller}/availabilityOrders/{availability_order}

Query parameters

Parameters
pageSize

integer

The maximum number of items to return. The service may return fewer than this value. Max allowed number of availability lines is 1000. If unspecified, at most 1000 availability lines will be returned.

pageToken

string

The nextPageToken value returned from a previous List request, if any.

filter

string

The list filter. Currently supports state filtering, with the syntax: "state = [STATE]". The logical operators AND and OR can be used to chain filters.

orderBy

string

The order by string used to specify the sort order of the results. Currently supports ordering by updateTime, provide "updateTime" to get results sorted by updateTime in ascending order, or "updateTime desc" for descending order.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "availabilityLines": [
    {
      object (AvailabilityLine)
    }
  ],
  "nextPageToken": string
}
Fields
availabilityLines[]

object (AvailabilityLine)

The list of availability lines.

nextPageToken

string

A token to retrieve the next page of results. Pass this value in the pageToken field in the subsequent call to availabilityLines.list method to retrieve the next page of results.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/doubleclickbidmanager

For more information, see the OAuth 2.0 Overview.