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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003ePauses the serving status of a finalized programmatic guaranteed or preferred deal without affecting other deal attributes.\u003c/p\u003e\n"],["\u003cp\u003eTo pause, send a POST request to the specified URL, including the buyer and deal IDs in the path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body can optionally include a reason for pausing, which is displayed to the seller.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns the updated FinalizedDeal object.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],[],null,["# Method: buyers.finalizedDeals.pause\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nPauses 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.\n\n### HTTP request\n\n`POST https://authorizedbuyersmarketplace.googleapis.com/v1/{name=buyers/*/finalizedDeals/*}:pause`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------|\n| `name` | `string` Required. Format: `buyers/{accountId}/finalizedDeals/{dealId}` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------|\n| ``` { \"reason\": string } ``` |\n\n| Fields ||\n|----------|----------------------------------------------------------------------------------------------------------------------|\n| `reason` | `string` The reason to pause the finalized deal, will be displayed to the seller. Maximum length is 1000 characters. |\n\n### Response body\n\nIf successful, the response body contains an instance of [FinalizedDeal](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals#FinalizedDeal).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]