Method: buyers.proposals.deals.patch

  • Updates a given deal at the buyer's known revision number, returning an error if the server revision has advanced since the provided revision.

  • The revision number is incremented whenever the proposal or its deals are updated and is used for conflict detection.

  • The API uses a PATCH request to https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{deal.name=buyers/*/proposals/*/deals/*} to update the deal.

  • Requires the https://www.googleapis.com/auth/authorized-buyers-marketplace OAuth scope for authorization.

  • The request body should contain a Deal object with the desired updates.

Updates the given deal at the buyer known revision number. If the server revision has advanced since the passed-in proposal.proposal_revision an ABORTED error message will be returned. The revision number is incremented by the server whenever the proposal or its constituent deals are updated. Note: The revision number is kept at a proposal level. The buyer of the API is expected to keep track of the revision number after the last update operation and send it in as part of the next update request. This way, if there are further changes on the server (for example, seller making new updates), then the server can detect conflicts and reject the proposed changes.

HTTP request

PATCH https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{deal.name=buyers/*/proposals/*/deals/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
deal.name

string

Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId}

Query parameters

Parameters
updateMask

string (FieldMask format)

List of fields to be updated. If empty or unspecified, the service will update all fields populated in the update request excluding the output only fields and primitive fields with default value. Note that explicit field mask is required in order to reset a primitive field back to its default value, for example, false for boolean fields, 0 for integer fields. A special field mask consisting of a single path "*" can be used to indicate full replacement(the equivalent of PUT method), updatable fields unset or unspecified in the input will be cleared or set to default value. Output only fields will be ignored regardless of the value of updateMask.

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

Request body

The request body contains an instance of Deal.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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