--- 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
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-07-22。