Represents a Google Ads targeted proximity --- some radius around a geographical point.

### Methods:

| Member | Type | Description |
|---|---|---|
| [getAddress()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getAddress) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_address` | Returns the address of the central point, or `null` if unknown. |
| [getBaseCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getBaseCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | Returns the base campaign to which this targeted proximity belongs. |
| [getBidModifier()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getBidModifier) | `double` | Returns the bid modifier for this targeted proximity. |
| [getCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | Returns the campaign to which this targeted proximity belongs or `null` if it does not belong to a search or display campaign. |
| [getCampaignType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getCampaignType) | `String` | Returns the campaign type. |
| [getEntityType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getEntityType) | `String` | Returns the type of this entity as a `String`, in this case, `"TargetedProximity"`. |
| [getId()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getId) | `String` | Returns the ID of the targeted proximity. |
| [getLatitude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getLatitude) | `double` | Returns the latitude in degrees of the central point of this proximity. |
| [getLongitude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getLongitude) | `double` | Returns the longitude in degrees of the central point of this proximity. |
| [getRadius()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadius) | `double` | Returns the radius around the central point to target. |
| [getRadiusUnits()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadiusUnits) | `String` | Returns the units of [TargetedProximity.getRadius()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadius). |
| [getResourceName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getResourceName) | `String` | Returns the resource name of the targeted proximity. |
| [getShoppingCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getShoppingCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaign` | Returns the shopping campaign to which this targeted proximity belongs or `null` if it does not belong to a shopping campaign. |
| [getStatsFor(dateRange)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getStatsFor_dateRange) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified date range. |
| [getStatsFor(dateFrom, dateTo)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getStatsFor_dateFrom-dateTo) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified custom date range. |
| [getVideoCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getVideoCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign` | Returns the video campaign to which this targeted proximity belongs or `null` if it does not belong to a video campaign. |
| [remove()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#remove) | `void` | Removes the targeted proximity. |
| [setBidModifier(modifier)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#setBidModifier_modifier) | `void` | Sets the bid modifier for this targeted proximity. |

## `getAddress()`

Returns the address of the central point, or `null` if unknown.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_address` | The address of the central point, or `null` if unknown. |

## `getBaseCampaign()`

Returns the base campaign to which this targeted proximity belongs.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | The base campaign to which this targeted proximity belongs. |

## `getBidModifier()`

Returns the bid modifier for this targeted proximity.

The bid modifier is a multiplier applied to bids which match this targeted proximity. So, for instance, a bid modifier of `1.1`
increases the bid to 110% of its original value, and changes a bid of $5.00
to a bid of $5.50.

The bid modifiers for all matching criteria are multiplied together to
calculate the actual bid modification. A campaign with the following bid
modifiers:

| Type | Value | Bid Modifier |
|---|---|---|
| Location | Laos | `1.3` |
| Ad Schedule | Saturday 6AM-10AM | `0.9` |
| Platform | Mobile | `1.1` |

would have a combined bid modifier of `1.3 * 0.9 * 1.1 = 1.287`, so a bid of $10 would get increased to $12.87 for metrics.clicks by Laotian smartphone users on Saturday mornings in the account timezone.

For more information about bid modifiers, please see the [Google Ads Help
Center article](https://support.google.com/google-ads/answer/2732132).

### Return values:

| Type | Description |
|---|---|
| `double` | The criterion bid modifier. |

## `getCampaign()`

Returns the campaign to which this targeted proximity belongs or `null` if it does not belong to a search or display campaign.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | The campaign to which this targeted proximity belongs or `null` if it does not belong to a search or display campaign. |

## `getCampaignType()`

Returns the campaign type. Possible return values:

`SEARCH_OR_DISPLAY, VIDEO, SHOPPING`

### Return values:

| Type | Description |
|---|---|
| `String` | Video campaign type. |

## `getEntityType()`

Returns the type of this entity as a `String`, in this case, `"TargetedProximity"`.

### Return values:

| Type | Description |
|---|---|
| `String` | Type of this entity: `"TargetedProximity"`. |

## `getId()`

Returns the ID of the targeted proximity.

Proximity IDs may be shared across campaigns. In order to uniquely
identify a proximity target, one must specify both its campaign ID and the
proximity ID.

### Return values:

| Type | Description |
|---|---|
| `String` | The ID of the targeted proximity. |

## `getLatitude()`

Returns the latitude in degrees of the central point of this proximity.

### Return values:

| Type | Description |
|---|---|
| `double` | The latitude in degrees of the central point of this proximity. |

## `getLongitude()`

Returns the longitude in degrees of the central point of this proximity.

### Return values:

| Type | Description |
|---|---|
| `double` | The longitude in degrees of the central point of this proximity. |

## `getRadius()`

Returns the radius around the central point to target.

This just returns a number such as `40` and is intended to be
used in tandem with [TargetedProximity.getRadiusUnits()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadiusUnits).

### Return values:

| Type | Description |
|---|---|
| `double` | The radius around the central point to target. |

## `getRadiusUnits()`

Returns the units of [TargetedProximity.getRadius()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadius).

This is either `"MILES"` or `"KILOMETERS"`.

### Return values:

| Type | Description |
|---|---|
| `String` | The units of [TargetedProximity.getRadius()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_targetedproximity#getRadius). |

## `getResourceName()`

Returns the resource name of the targeted proximity.

### Return values:

| Type | Description |
|---|---|
| `String` | The resource name of the targeted proximity. |

## `getShoppingCampaign()`

Returns the shopping campaign to which this targeted proximity belongs or `null` if it does not belong to a shopping campaign.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaign` | The shopping campaign to which this targeted proximity belongs or `null` if it does not belong to a shopping campaign. |

## `getStatsFor(dateRange)`

Returns stats for the specified date range. Supported values:

`TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME`.

Example:

```
var stats = targetedProximity.getStatsFor("THIS_MONTH");
```

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateRange | `String` | Date range for which the stats are requested. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getStatsFor(dateFrom, dateTo)`

Returns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` form. For instance, `March 24th,
2013` is represented as either `{year: 2013, month: 3, day:
24}` or `"20130324"`. The date range is inclusive on both ends, so `forDateRange("20130324", "20130324")` defines a range of a single day.

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateFrom | `Object` | Start date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |
| dateTo | `Object` | End date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getVideoCampaign()`

Returns the video campaign to which this targeted proximity belongs or `null` if it does not belong to a video campaign.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign` | The video campaign to which this targeted proximity belongs or `null` if it does not belong to a video campaign. |

## `remove()`

Removes the targeted proximity.

Returns nothing.

## `setBidModifier(modifier)`

Sets the bid modifier for this targeted proximity.

The bid modifier is a multiplier applied to bids which match this targeted proximity. So, for instance, a bid modifier of `1.1`
increases the bid to 110% of its original value, and changes a bid of
`$5.00` to a bid of `$5.50`.

The bid modifiers for all matching criteria are multiplied together to
calculate the actual bid modification. A campaign with the following bid
modifiers:

| Type | Value | Bid Modifier |
|---|---|---|
| Location | Laos | `1.3` |
| Ad Schedule | Saturday 6AM-10AM | `0.9` |
| Platform | Mobile | `1.1` |

would have a combined bid modifier of `1.3 * 0.9 * 1.1 = 1.287`, so a bid of $10 would get increased to $12.87 for metrics.clicks by Laotian smartphone users on Saturday mornings in the account timezone.

For more information about bid modifiers, please see the [Google Ads Help
Center article](https://support.google.com/google-ads/answer/2732132).
For proximities, acceptable bid modifiers are in the range `0.1`
to `10`.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| modifier | `double` | The new bid modifier. |