Method: buyers.finalizedDeals.pause

Pauses serving of the given finalized deal. This call only pauses the serving status, and does not affect other fields of the finalized deal. Calling this method for an already paused deal has no effect. This method only applies to programmatic guaranteed deals and preferred deals.

HTTP request

POST https://authorizedbuyersmarketplace.googleapis.com/v1/{name=buyers/*/finalizedDeals/*}:pause

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Format: buyers/{accountId}/finalizedDeals/{dealId}

Request body

The request body contains data with the following structure:

JSON representation
{
  "reason": string
}
Fields
reason

string

The reason to pause the finalized deal, will be displayed to the seller. Maximum length is 1000 characters.

Response body

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

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/authorized-buyers-marketplace