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

namespace Google\Ads\GoogleAds\V23\Services;

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

/**
 * The targeting for which traffic metrics will be reported.
 *
 * Generated from protobuf message <code>google.ads.googleads.v23.services.Targeting</code>
 */
class Targeting extends \Google\Protobuf\Internal\Message
{
    /**
     * The ID of the selected location. Plannable location IDs can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_ids`.
     * This field is deprecated and will be removed in a future release.
     * Use `plannable_location_ids` instead.
     *
     * Generated from protobuf field <code>optional string plannable_location_id = 6;</code>
     */
    protected $plannable_location_id = null;
    /**
     * The list of plannable location IDs to target with this forecast.
     * If more than one ID is provided, all IDs must have the same
     * `parent_country_id`. Planning for more than `parent_county` is not
     * supported. Plannable location IDs and their `parent_country_id` can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_id`.
     *
     * Generated from protobuf field <code>repeated string plannable_location_ids = 8;</code>
     */
    private $plannable_location_ids;
    /**
     * Targeted age range.
     * An unset value is equivalent to targeting all ages.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_range = 2;</code>
     */
    protected $age_range = 0;
    /**
     * Targeted genders.
     * An unset value is equivalent to targeting MALE and FEMALE.
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.GenderInfo genders = 3;</code>
     */
    private $genders;
    /**
     * Targeted devices.
     * If not specified, targets all applicable devices. Applicable devices vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.DeviceInfo devices = 4;</code>
     */
    private $devices;
    /**
     * Targetable network for the ad product.
     * If not specified, targets all applicable networks. Applicable networks vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanNetworkEnum.ReachPlanNetwork network = 5;</code>
     */
    protected $network = 0;
    /**
     * Targeted audiences.
     * If not specified, does not target any specific audience.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.services.AudienceTargeting audience_targeting = 7;</code>
     */
    protected $audience_targeting = null;

    /**
     * Constructor.
     *
     * @param array $data {
     *                    Optional. Data for populating the Message object.
     *
     * @type string $plannable_location_id
     *           The ID of the selected location. Plannable location IDs can be
     *           obtained from
     *           [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     *           Requests must set either this field or `plannable_location_ids`.
     *           This field is deprecated and will be removed in a future release.
     *           Use `plannable_location_ids` instead.
     * @type string[] $plannable_location_ids
     *           The list of plannable location IDs to target with this forecast.
     *           If more than one ID is provided, all IDs must have the same
     *           `parent_country_id`. Planning for more than `parent_county` is not
     *           supported. Plannable location IDs and their `parent_country_id` can be
     *           obtained from
     *           [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     *           Requests must set either this field or `plannable_location_id`.
     * @type int $age_range
     *           Targeted age range.
     *           An unset value is equivalent to targeting all ages.
     * @type \Google\Ads\GoogleAds\V23\Common\GenderInfo[] $genders
     *           Targeted genders.
     *           An unset value is equivalent to targeting MALE and FEMALE.
     * @type \Google\Ads\GoogleAds\V23\Common\DeviceInfo[] $devices
     *           Targeted devices.
     *           If not specified, targets all applicable devices. Applicable devices vary
     *           by product and region and can be obtained from
     *           [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     * @type int $network
     *           Targetable network for the ad product.
     *           If not specified, targets all applicable networks. Applicable networks vary
     *           by product and region and can be obtained from
     *           [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     * @type \Google\Ads\GoogleAds\V23\Services\AudienceTargeting $audience_targeting
     *           Targeted audiences.
     *           If not specified, does not target any specific audience.
     * }
     */
    public function __construct($data = null)
    {
        \GPBMetadata\Google\Ads\GoogleAds\V23\Services\ReachPlanService::initOnce();
        parent::__construct($data);
    }

    /**
     * The ID of the selected location. Plannable location IDs can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_ids`.
     * This field is deprecated and will be removed in a future release.
     * Use `plannable_location_ids` instead.
     *
     * Generated from protobuf field <code>optional string plannable_location_id = 6;</code>
     *
     * @return string
     */
    public function getPlannableLocationId()
    {
        return isset($this->plannable_location_id) ? $this->plannable_location_id : '';
    }

    public function hasPlannableLocationId()
    {
        return isset($this->plannable_location_id);
    }

    public function clearPlannableLocationId()
    {
        unset($this->plannable_location_id);
    }

    /**
     * The ID of the selected location. Plannable location IDs can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_ids`.
     * This field is deprecated and will be removed in a future release.
     * Use `plannable_location_ids` instead.
     *
     * Generated from protobuf field <code>optional string plannable_location_id = 6;</code>
     *
     * @param  string $var
     * @return $this
     */
    public function setPlannableLocationId($var)
    {
        GPBUtil::checkString($var, true);
        $this->plannable_location_id = $var;

        return $this;
    }

    /**
     * The list of plannable location IDs to target with this forecast.
     * If more than one ID is provided, all IDs must have the same
     * `parent_country_id`. Planning for more than `parent_county` is not
     * supported. Plannable location IDs and their `parent_country_id` can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_id`.
     *
     * Generated from protobuf field <code>repeated string plannable_location_ids = 8;</code>
     *
     * @return RepeatedField<string>
     */
    public function getPlannableLocationIds()
    {
        return $this->plannable_location_ids;
    }

    /**
     * The list of plannable location IDs to target with this forecast.
     * If more than one ID is provided, all IDs must have the same
     * `parent_country_id`. Planning for more than `parent_county` is not
     * supported. Plannable location IDs and their `parent_country_id` can be
     * obtained from
     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v23.services.ReachPlanService.ListPlannableLocations].
     * Requests must set either this field or `plannable_location_id`.
     *
     * Generated from protobuf field <code>repeated string plannable_location_ids = 8;</code>
     *
     * @param  string[] $var
     * @return $this
     */
    public function setPlannableLocationIds($var)
    {
        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING);
        $this->plannable_location_ids = $arr;

        return $this;
    }

    /**
     * Targeted age range.
     * An unset value is equivalent to targeting all ages.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_range = 2;</code>
     *
     * @return int
     */
    public function getAgeRange()
    {
        return $this->age_range;
    }

    /**
     * Targeted age range.
     * An unset value is equivalent to targeting all ages.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_range = 2;</code>
     *
     * @param  int $var
     * @return $this
     */
    public function setAgeRange($var)
    {
        GPBUtil::checkEnum($var, \Google\Ads\GoogleAds\V23\Enums\ReachPlanAgeRangeEnum\ReachPlanAgeRange::class);
        $this->age_range = $var;

        return $this;
    }

    /**
     * Targeted genders.
     * An unset value is equivalent to targeting MALE and FEMALE.
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.GenderInfo genders = 3;</code>
     *
     * @return RepeatedField<\Google\Ads\GoogleAds\V23\Common\GenderInfo>
     */
    public function getGenders()
    {
        return $this->genders;
    }

    /**
     * Targeted genders.
     * An unset value is equivalent to targeting MALE and FEMALE.
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.GenderInfo genders = 3;</code>
     *
     * @param  \Google\Ads\GoogleAds\V23\Common\GenderInfo[] $var
     * @return $this
     */
    public function setGenders($var)
    {
        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Ads\GoogleAds\V23\Common\GenderInfo::class);
        $this->genders = $arr;

        return $this;
    }

    /**
     * Targeted devices.
     * If not specified, targets all applicable devices. Applicable devices vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.DeviceInfo devices = 4;</code>
     *
     * @return RepeatedField<\Google\Ads\GoogleAds\V23\Common\DeviceInfo>
     */
    public function getDevices()
    {
        return $this->devices;
    }

    /**
     * Targeted devices.
     * If not specified, targets all applicable devices. Applicable devices vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>repeated .google.ads.googleads.v23.common.DeviceInfo devices = 4;</code>
     *
     * @param  \Google\Ads\GoogleAds\V23\Common\DeviceInfo[] $var
     * @return $this
     */
    public function setDevices($var)
    {
        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Ads\GoogleAds\V23\Common\DeviceInfo::class);
        $this->devices = $arr;

        return $this;
    }

    /**
     * Targetable network for the ad product.
     * If not specified, targets all applicable networks. Applicable networks vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanNetworkEnum.ReachPlanNetwork network = 5;</code>
     *
     * @return int
     */
    public function getNetwork()
    {
        return $this->network;
    }

    /**
     * Targetable network for the ad product.
     * If not specified, targets all applicable networks. Applicable networks vary
     * by product and region and can be obtained from
     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v23.services.ReachPlanService.ListPlannableProducts].
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.enums.ReachPlanNetworkEnum.ReachPlanNetwork network = 5;</code>
     *
     * @param  int $var
     * @return $this
     */
    public function setNetwork($var)
    {
        GPBUtil::checkEnum($var, \Google\Ads\GoogleAds\V23\Enums\ReachPlanNetworkEnum\ReachPlanNetwork::class);
        $this->network = $var;

        return $this;
    }

    /**
     * Targeted audiences.
     * If not specified, does not target any specific audience.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.services.AudienceTargeting audience_targeting = 7;</code>
     *
     * @return \Google\Ads\GoogleAds\V23\Services\AudienceTargeting|null
     */
    public function getAudienceTargeting()
    {
        return $this->audience_targeting;
    }

    public function hasAudienceTargeting()
    {
        return isset($this->audience_targeting);
    }

    public function clearAudienceTargeting()
    {
        unset($this->audience_targeting);
    }

    /**
     * Targeted audiences.
     * If not specified, does not target any specific audience.
     *
     * Generated from protobuf field <code>.google.ads.googleads.v23.services.AudienceTargeting audience_targeting = 7;</code>
     *
     * @param  \Google\Ads\GoogleAds\V23\Services\AudienceTargeting $var
     * @return $this
     */
    public function setAudienceTargeting($var)
    {
        GPBUtil::checkMessage($var, \Google\Ads\GoogleAds\V23\Services\AudienceTargeting::class);
        $this->audience_targeting = $var;

        return $this;
    }

}