Method: advertisers.insertionOrders.get

  • Retrieves a specific insertion order belonging to a given advertiser using a GET request.

  • Requires providing the advertiser ID and insertion order ID as path parameters in the request URL.

  • Returns the details of the insertion order, including its properties and settings, in the response body if found.

  • If the insertion order is not found, the API will return a NOT_FOUND error code.

  • Requires authorization with the https://www.googleapis.com/auth/display-video scope.

Gets an insertion order. Returns error code NOT_FOUND if the insertion order does not exist.

HTTP request

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the advertiser this insertion order belongs to.
insertionOrderId

string (int64 format)

Required. The ID of the insertion order to fetch.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of InsertionOrder.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.