AdsApp.PriceItem
Stay organized with collections
Save and categorize content based on your preferences.
Represents a price item in an ad price extension. Visit our Ad Extensions
page
for more information on price extensions and other types of ad extensions. Methods:
getAmount()
Returns the amount of money of the price item. Return values:
getCurrencyCode()
Returns the currency code of the price item. Return values:
getDescription()
Returns the description text of the price item. Return values:
getFinalUrl()
Returns the final URL of the price item or null
if
there is no final URL. The final URL represents the actual landing page for your price item. The final URL must be the URL of the page that the user
ends up on after clicking on your ad, once all the redirects have taken
place.
Final URLs follow the same override rules as destination URLs. For
example, a final URL at the keyword level overrides a final URL at an ad
level.
See Using
Upgraded URLs
for more information.
Return values:
Returns the header text of the price item. Return values:
getMobileFinalUrl()
Returns the mobile final URL of the price item or null
if there is no mobile final URL. The mobile final URL represents the actual landing page for your price item on a mobile device. The final mobile URL must be the URL of
the page that the user ends up on after clicking on your ad on a mobile
device, once all the redirects have taken place.
Mobile final URLs follow the same override rules as destination URLs.
For example, a mobile final URL at the keyword level overrides a mobile
final URL at an ad level.
See Using
Upgraded URLs
for more information.
Return values:
getUnitType()
Returns the unit type of the price item. The unit type defines the rate
that describes the price (e.g., whether the amount specified is per day,
per week, etc). Return values:
remove()
Removes the price item from its parent Price
object. Returns nothing.
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 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eRepresents a price item within an ad's price extension, allowing advertisers to showcase product or service pricing directly in their ads.\u003c/p\u003e\n"],["\u003cp\u003eProvides methods to access and manage various aspects of the price item, such as amount, currency, description, header, and URLs.\u003c/p\u003e\n"],["\u003cp\u003eIncludes functionalities to retrieve the final URL and mobile final URL, leading users to the specific product or service page after clicking the ad.\u003c/p\u003e\n"],["\u003cp\u003eAllows for the removal of the price item from its parent Price object, enabling dynamic updates to the price extension.\u003c/p\u003e\n"],["\u003cp\u003eFor further details on price extensions and other ad extensions, refer to the Ad Extensions documentation.\u003c/p\u003e\n"]]],[],null,["# AdsApp.PriceItem\n\nRepresents a price item in an ad price extension. Visit our [Ad Extensions](/google-ads/scripts/docs/features/ad-extensions) page for more information on price extensions and other types of ad extensions.\n\n### Methods:\n\n| Member | Type | Description |\n|-------------------------------------------|----------|----------------------------------------------------------------------------------------------------------------|\n| [getAmount()](#getAmount) | `long` | Returns the amount of money of the price item. |\n| [getCurrencyCode()](#getCurrencyCode) | `String` | Returns the currency code of the price item. |\n| [getDescription()](#getDescription) | `String` | Returns the description text of the price item. |\n| [getFinalUrl()](#getFinalUrl) | `String` | Returns the final URL of the price item or `null` if there is no final URL. |\n| [getHeader()](#getHeader) | `String` | Returns the header text of the price item. |\n| [getMobileFinalUrl()](#getMobileFinalUrl) | `String` | Returns the mobile final URL of the price item or `null` if there is no mobile final URL. |\n| [getUnitType()](#getUnitType) | `String` | Returns the unit type of the price item. |\n| [remove()](#remove) | `void` | Removes the price item from its parent [Price](/google-ads/scripts/docs/reference/adsapp/adsapp_price) object. |\n\n`getAmount()`\n-------------\n\nReturns the amount of money of the price item.\n\n### Return values:\n\n| Type | Description |\n|--------|----------------------------------------------|\n| `long` | Amount of money in micros of the price item. |\n\n`getCurrencyCode()`\n-------------------\n\nReturns the currency code of the price item.\n\n### Return values:\n\n| Type | Description |\n|----------|----------------------------------|\n| `String` | Currency code of the price item. |\n\n`getDescription()`\n------------------\n\nReturns the description text of the price item.\n\n### Return values:\n\n| Type | Description |\n|----------|-------------------------------------|\n| `String` | Description text of the price item. |\n\n`getFinalUrl()`\n---------------\n\nReturns the final URL of the price item or `null` if there is no final URL.\n\nThe final URL represents the actual landing page for your price item. The final URL must be the URL of the page that the user\nends up on after clicking on your ad, once all the redirects have taken\nplace.\n\nFinal URLs follow the same override rules as destination URLs. For\nexample, a final URL at the keyword level overrides a final URL at an ad\nlevel.\n\nSee [Using\nUpgraded URLs](//support.google.com/google-ads/answer/6049217) for more information.\n\n### Return values:\n\n| Type | Description |\n|----------|----------------------------------|\n| `String` | The final URL of the price item. |\n\n`getHeader()`\n-------------\n\nReturns the header text of the price item.\n\n### Return values:\n\n| Type | Description |\n|----------|--------------------------------|\n| `String` | Header text of the price item. |\n\n`getMobileFinalUrl()`\n---------------------\n\nReturns the mobile final URL of the price item or `null` if there is no mobile final URL.\n\nThe mobile final URL represents the actual landing page for your price item on a mobile device. The final mobile URL must be the URL of\nthe page that the user ends up on after clicking on your ad on a mobile\ndevice, once all the redirects have taken place.\n\nMobile final URLs follow the same override rules as destination URLs.\nFor example, a mobile final URL at the keyword level overrides a mobile\nfinal URL at an ad level.\n\nSee [Using\nUpgraded URLs](//support.google.com/google-ads/answer/6049217) for more information.\n\n### Return values:\n\n| Type | Description |\n|----------|-----------------------------------------|\n| `String` | The mobile final URL of the price item. |\n\n`getUnitType()`\n---------------\n\nReturns the unit type of the price item. The unit type defines the rate that describes the price (e.g., whether the amount specified is per day, per week, etc).\n\n### Return values:\n\n| Type | Description |\n|----------|------------------------------|\n| `String` | Unit type of the price item. |\n\n`remove()`\n----------\n\nRemoves the price item from its parent [Price](/google-ads/scripts/docs/reference/adsapp/adsapp_price) object.\n\nReturns nothing."]]
