Method: guaranteedOrders.patch

  • Display & Video 360 API v3 is sunset and users should use v4 instead.

  • This page describes how to update an existing guaranteed order using the Display & Video 360 API v3 PATCH method.

  • Updating a guaranteed order requires specifying the order's unique ID in the path parameters and providing an update mask and either a partner or advertiser ID in the query parameters.

  • The request and response bodies for updating a guaranteed order contain instances of the GuaranteedOrder resource.

  • This operation requires the https://www.googleapis.com/auth/display-video OAuth scope for authorization.

Updates an existing guaranteed order. Returns the updated guaranteed order if successful.

HTTP request

PATCH https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
guaranteedOrder.guaranteedOrderId

string

Output only. The unique identifier of the guaranteed order. The guaranteed order IDs have the format {exchange}-{legacyGuaranteedOrderId} .

Query parameters

Parameters
updateMask

string ( FieldMask format)

Required. The mask to control which fields to update.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo" .

Union parameter accessor . Required.

Identifies which DV360 entity the request is being made within. accessor can be only one of the following:

partnerId

string ( int64 format)

The ID of the partner that the request is being made within.

advertiserId

string ( int64 format)

The ID of the advertiser that the request is being made within.

Request body

The request body contains an instance of GuaranteedOrder .

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview .

Create a Mobile Website
View Site in Mobile | Classic
Share by: