Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13145259.5 KB
partners

Currently, it is only enabled for YouTube. Finds eligible promotions for the current user. The API requires user authorization via OAuth. The bare minimum oauth scope openid is sufficient, which will skip the consent screen.

post/v1/{+parent}/promotions:findEligible

Path parameters

parentstring required

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

Request body

filterstring

Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: 1. Only the following features are supported: - Logical operator AND - Comparison operator = (no wildcards *) - Traversal operator . - Has operator : (no wildcards *) 2. Only the following fields are supported: - applicableProducts - regionCodes - youtubePayload.partnerEligibilityId - youtubePayload.postalCode 3. Unless explicitly mentioned above, other features are not supported. Example: applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id

pageTokenstring

Optional. A page token, received from a previous FindEligiblePromotions call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FindEligiblePromotions must match the call that provided the page token.

pageSizeinteger

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

Response

Successful response