Method: advertisers.insertionOrders.get

AI-generated Key Takeaways

• Display & Video 360 API v1 has been sunset.

• This document provides information on how to get an insertion order using the Display & Video API v1, including HTTP request details, parameters, and authorization scopes.

• Getting an insertion order requires specifying the advertiserId and insertionOrderId as path parameters in the GET request.

• A successful request returns an InsertionOrder instance in the response body, while a non-existent insertion order results in a NOT_FOUND error code.

• Accessing this functionality requires authorization with the https://www.googleapis.com/auth/display-video OAuth scope.

Display & Video 360 API v1 has been sunset.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization Scopes
• Try it!

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

HTTP request

GET https://displayvideo.googleapis.com/v1/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.