Method: partners.promotions.findEligible

Used by partners to find eligible promotions for the current user. The API is OAuth only. The user is inferred from the authenticated OAuth credential.

HTTP request

POST https://paymentsresellersubscription.googleapis.com/v1/{parent=partners/*}/promotions:findEligible

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent, the partner that can resell. Format: partners/{partner}

Request body

The request body contains data with the following structure:

JSON representation
{
  "filter": string,
  "pageSize": integer,
  "pageToken": string
}
Fields
filter

string

Optional. Specifies the filters for the promotion results. The syntax defined in the EBNF grammar: https://google.aip.dev/assets/misc/ebnf-filtering.txt. Examples:

  • applicableProducts: "sku1"
  • regionCodes: "US"
  • applicableProducts: "sku1" AND regionCodes: "US"
pageSize

integer

Optional. The maximum number of promotions to return. The service may return fewer than this value. If unspecified, at most 50 products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken

string

Optional. A page token, received from a previous promotions.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to promotions.list must match the call that provided the page token.

Response body

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

Response containing the found promotions for the current user. NextId: 3

JSON representation
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Fields
promotions[]

object (Promotion)

The promotions for the current user.

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is empty, there are no subsequent pages.