<?php
# Generated by the protocol buffer compiler.  DO NOT EDIT!
# source: google/ads/googleads/v25/services/incentive_service.proto

namespace Google\Ads\GoogleAds\V25\Services;

use Google\Protobuf\Internal\GPBType;
use Google\Protobuf\Internal\GPBUtil;
use Google\Protobuf\RepeatedField;

/**
 * Request message for applying an incentive.
 *
 * Generated from protobuf message <code>google.ads.googleads.v25.services.ApplyIncentiveRequest</code>
 */
class ApplyIncentiveRequest extends \Google\Protobuf\Internal\Message
{
    /**
     * Required. The incentive ID of this incentive. This is used to identify
     * which incentive is selected by the user in the CYO flow.
     *
     * Generated from protobuf field <code>int64 selected_incentive_id = 1 [(.google.api.field_behavior) = REQUIRED];</code>
     */
    protected $selected_incentive_id = 0;
    /**
     * Required. The customer ID of the account that the incentive is being
     * applied to.
     *
     * Generated from protobuf field <code>string customer_id = 2 [(.google.api.field_behavior) = REQUIRED];</code>
     */
    protected $customer_id = '';
    /**
     * 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
     *
     * Generated from protobuf field <code>string country_code = 3 [(.google.api.field_behavior) = REQUIRED];</code>
     */
    protected $country_code = '';

    /**
     * @param string $countryCode 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
     *
     * @return \Google\Ads\GoogleAds\V25\Services\ApplyIncentiveRequest
     *
     * @experimental
     */
    public static function build(string $countryCode): self
    {
        return (new self())
            ->setCountryCode($countryCode);
    }

    /**
     * @param int    $selectedIncentiveId Required. The incentive ID of this incentive. This is used to identify
     *                                    which incentive is selected by the user in the CYO flow.
     * @param string $customerId          Required. The customer ID of the account that the incentive is being
     *                                    applied to.
     * @param string $countryCode         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
     *
     * @return \Google\Ads\GoogleAds\V25\Services\ApplyIncentiveRequest
     *
     * @experimental
     */
    public static function buildFromSelectedIncentiveIdCustomerIdCountryCode(int $selectedIncentiveId, string $customerId, string $countryCode): self
    {
        return (new self())
            ->setSelectedIncentiveId($selectedIncentiveId)
            ->setCustomerId($customerId)
            ->setCountryCode($countryCode);
    }

    /**
     * Constructor.
     *
     * @param array $data {
     *     Optional. Data for populating the Message object.
     *
     *     @type int|string $selected_incentive_id
     *           Required. The incentive ID of this incentive. This is used to identify
     *           which incentive is selected by the user in the CYO flow.
     *     @type string $customer_id
     *           Required. The customer ID of the account that the incentive is being
     *           applied to.
     *     @type string $country_code
     *           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
     * }
     */
    public function __construct($data = NULL) {
        \GPBMetadata\Google\Ads\GoogleAds\V25\Services\IncentiveService::initOnce();
        parent::__construct($data);
    }

    /**
     * Required. The incentive ID of this incentive. This is used to identify
     * which incentive is selected by the user in the CYO flow.
     *
     * Generated from protobuf field <code>int64 selected_incentive_id = 1 [(.google.api.field_behavior) = REQUIRED];</code>
     * @return int|string
     */
    public function getSelectedIncentiveId()
    {
        return $this->selected_incentive_id;
    }

    /**
     * Required. The incentive ID of this incentive. This is used to identify
     * which incentive is selected by the user in the CYO flow.
     *
     * Generated from protobuf field <code>int64 selected_incentive_id = 1 [(.google.api.field_behavior) = REQUIRED];</code>
     * @param int|string $var
     * @return $this
     */
    public function setSelectedIncentiveId($var)
    {
        GPBUtil::checkInt64($var);
        $this->selected_incentive_id = $var;

        return $this;
    }

    /**
     * Required. The customer ID of the account that the incentive is being
     * applied to.
     *
     * Generated from protobuf field <code>string customer_id = 2 [(.google.api.field_behavior) = REQUIRED];</code>
     * @return string
     */
    public function getCustomerId()
    {
        return $this->customer_id;
    }

    /**
     * Required. The customer ID of the account that the incentive is being
     * applied to.
     *
     * Generated from protobuf field <code>string customer_id = 2 [(.google.api.field_behavior) = REQUIRED];</code>
     * @param string $var
     * @return $this
     */
    public function setCustomerId($var)
    {
        GPBUtil::checkString($var, True);
        $this->customer_id = $var;

        return $this;
    }

    /**
     * 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
     *
     * Generated from protobuf field <code>string country_code = 3 [(.google.api.field_behavior) = REQUIRED];</code>
     * @return string
     */
    public function getCountryCode()
    {
        return $this->country_code;
    }

    /**
     * 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
     *
     * Generated from protobuf field <code>string country_code = 3 [(.google.api.field_behavior) = REQUIRED];</code>
     * @param string $var
     * @return $this
     */
    public function setCountryCode($var)
    {
        GPBUtil::checkString($var, True);
        $this->country_code = $var;

        return $this;
    }

}