Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on January 29th at 10:00 AM EST! We will discuss the new features added in v23 of the Google Ads API.
AppliedIncentive
Stay organized with collections
Save and categorize content based on your preferences.
| Fields |
coupon_code
|
string
Output only. The coupon code of the incentive.
|
currency_code
|
string
Output only. The currency code for all monetary amounts (for example, "USD").
|
current_spend_towards_fulfillment_micros
|
int64
Output only. The current amount spent towards the fulfillment requirements, in micros.
|
fulfillment_expiration_date_time
|
string
Output only. The time by which the incentive's fulfillment requirements must be met, in "YYYY-MM-DD HH:MM:SS" format in UTC.
|
granted_amount_micros
|
int64
Output only. The amount of the reward granted in micros. This field is not set if the reward has not been granted.
|
incentive_state
|
IncentiveState
Output only. The current state of the incentive.
|
redemption_date_time
|
string
Output only. The redemption time of the incentive in "YYYY-MM-DD HH:MM:SS" format in UTC.
|
required_min_spend_micros
|
int64
Output only. The minimum amount that must be spent to fulfill the coupon requirements, in micros.
|
resource_name
|
string
Output only. The resource name of the incentive. Incentive resource names have the form: customers/{customer_id}/appliedIncentives/{coupon_code}
|
reward_amount_micros
|
int64
Output only. The maximum potential reward amount in micros for the incentive.
|
reward_balance_remaining_micros
|
int64
Output only. The remaining balance of the granted reward in micros. This field is not set if the reward has not been granted.
|
reward_expiration_date_time
|
string
Output only. The time when the granted reward expires in "YYYY-MM-DD HH:MM:SS" format in UTC. This field is not set if the reward has not been granted.
|
reward_grant_date_time
|
string
Output only. The time when the reward was granted in "YYYY-MM-DD HH:MM:SS" format in UTC. This field is not set if the reward has not been granted.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-22 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-01-22 UTC."],[],[]]