--- v24/services/incentive_service.proto 2026-07-21 22:02:30.000000000 +0000 +++ v25/services/incentive_service.proto 2026-07-21 22:02:37.000000000 +0000 @@ -45,27 +47,17 @@ // Applies the incentive for the ads customer. rpc ApplyIncentive(ApplyIncentiveRequest) returns (ApplyIncentiveResponse) { option (google.api.http) = { - post: "/v24/customers/{customer_id=*}/incentives/{selected_incentive_id=*}:applyIncentive" + post: "/v25/customers/{customer_id=*}/incentives/{selected_incentive_id=*}:applyIncentive" body: "*" }; option (google.api.method_signature) = "country_code"; + option (google.api.method_signature) = + "selected_incentive_id,customer_id,country_code"; } } // Request for getting the acquisition incentive for a user. message FetchIncentiveRequest { - // Types of incentives offered - enum IncentiveType { - // Not specified. - UNSPECIFIED = 0; - - // Unknown incentive type. Should not be used as a value explicitly. - UNKNOWN = 1; - - // An acquisition incentive. - ACQUISITION = 2; - } - // Optional. User's language code. // If not provided, the server will default to "en". // Possible language codes: @@ -85,7 +77,8 @@ // Optional. The type of incentive to get. // Defaults to ACQUISITION. - optional IncentiveType type = 4 [(google.api.field_behavior) = OPTIONAL]; + optional google.ads.googleads.v25.enums.IncentiveTypeEnum.IncentiveType + incentive_type = 5 [(google.api.field_behavior) = OPTIONAL]; } // An incentive that a user can claim for their account. @@ -131,7 +124,8 @@ optional string incentive_terms_and_conditions_url = 3; // The type of the incentive. - optional FetchIncentiveRequest.IncentiveType type = 4; + optional google.ads.googleads.v25.enums.IncentiveTypeEnum.IncentiveType + incentive_type = 5; } // An incentive offer in the Choose-Your-Own Incentive feature where a user @@ -150,28 +144,14 @@ // An acquisition incentive offer for a user. An offer means how the user is // treated. An offer can have no incentive or multiple incentives. message IncentiveOffer { - // Types of acquisition incentive offers. - enum OfferType { - // Unknown offer type. Should not be used as a value explicitly. - UNSPECIFIED = 0; - - // Unknown offer type. - UNKNOWN = 1; - - // An offer with no incentive. - NO_INCENTIVE = 2; - - // A CYO (Choose-Your-Own) offer with multiple incentives to choose from. - CYO_INCENTIVE = 3; - } - - // Required. The type of this acquisition incentive offer. - optional OfferType type = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The URL of the terms and conditions for the incentive offer. optional string consolidated_terms_and_conditions_url = 2 [(google.api.field_behavior) = OPTIONAL]; + // Required. The type of this acquisition incentive offer. + optional google.ads.googleads.v25.enums.IncentiveOfferTypeEnum.OfferType + offer_type = 4 [(google.api.field_behavior) = REQUIRED]; + // The specific incentive details, which can only be one of the following. oneof incentive_details { // CYO incentives. Set when type is CYO_INCENTIVE. @@ -189,12 +169,13 @@ // Request message for applying an incentive. message ApplyIncentiveRequest { - // The incentive ID of this incentive. This is used to identify which - // incentive is selected by the user in the CYO flow. - optional int64 selected_incentive_id = 1; - - // The customer ID of the account that the incentive is being applied to. - optional string customer_id = 2; + // Required. The incentive ID of this incentive. This is used to identify + // which incentive is selected by the user in the CYO flow. + int64 selected_incentive_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The customer ID of the account that the incentive is being + // applied to. + string customer_id = 2 [(google.api.field_behavior) = REQUIRED]; // Required. User's country code. // Required. This field must be equal to the Google Ads account's billing @@ -203,7 +184,7 @@ // incentive is applicable to the user. // Possible country codes: // https://developers.google.com/google-ads/api/data/codes-formats#country_codes - optional string country_code = 3 [(google.api.field_behavior) = REQUIRED]; + string country_code = 3 [(google.api.field_behavior) = REQUIRED]; } // Response for applying an incentive.
/services/incentive_service.proto
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-07-22 UTC.