Method: buyers.proposals.list

  • Lists proposals, allowing filtering by displayName, dealType, updateTime, and state using Cloud API list filtering syntax.

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

  • Uses a GET request to the endpoint https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/proposals, with the parent specified as a path parameter.

  • Response includes a list of proposals and a nextPageToken for pagination.

  • Request body should be empty.

Lists proposals. A filter expression using Cloud API list filtering syntax may be specified to filter the results.

HTTP request

GET https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/proposals

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Parent that owns the collection of proposals Format: buyers/{accountId}

Query parameters

Parameters
filter

string

Optional query string using the Cloud API list filtering syntax Supported columns for filtering are:

  • displayName
  • dealType
  • updateTime
  • state
pageSize

integer

Requested page size. The server may return fewer results than requested. If unspecified, the server will put a size of 500.
pageToken

string

The page token as returned from ListProposalsResponse.

Request body

The request body must be empty.

Response body

Response message for listing proposals.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "proposals": [
    {
      object (Proposal)
    }
  ],
  "nextPageToken": string
}
Fields
proposals[]

object (Proposal)

The list of proposals.
nextPageToken

string

Continuation token for fetching the next page of results.

Authorization scopes

Requires the following OAuth scope:

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