v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-131541,3491.5 MB
customers

Applies the incentive for the ads customer.

post/v23/customers/{+customerId}/incentives/{+selectedIncentiveId}:applyIncentive

Path parameters

customerIdstring required

The customer ID of the account that the incentive is being applied to.

selectedIncentiveIdstring required

The incentive ID of this incentive. This is used to identify which incentive is selected by the user in the CYO flow.

Request body

countryCodestring

Required. User's country code. Required. This field must be equal to the Google Ads account's billing country. Incentive eligibility, terms of service, and reward values are often country-specific. This country code is used to ensure the selected incentive is applicable to the user. Possible country codes: https://developers.google.com/google-ads/api/data/codes-formats#country_codes

Response

Successful response