Method: buyers.proposals.list

  • The document provides reference information for listing proposals for buyers using a GET HTTP request.

  • The request uses path and query parameters, but the request body must be empty.

  • The response body contains a list of proposals and a pagination token.

  • Authorization requires the https://www.googleapis.com/auth/authorized-buyers-marketplace OAuth scope.

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/v1/{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