AdsApp.​Extensions

AI-generated Key Takeaways

• This page provides access to and management of various ad extensions within your Google Ads account, such as callouts, mobile apps, phone numbers, sitelinks, snippets, and prices.

• You can retrieve existing extensions using selectors like callouts(), mobileApps(), phoneNumbers(), sitelinks(), snippets(), and prices().

• New ad extensions can be created using builders like newCalloutBuilder(), newMobileAppBuilder(), newPhoneNumberBuilder(), newSitelinkBuilder(), newSnippetBuilder(), and newPriceBuilder().

• These builders provide methods to configure and ultimately create new instances of the respective extension types in your account, enhancing your ads with additional information and calls to action.

• Note that while newPriceItemBuilder() creates price items, they need to be explicitly attached to price extensions using price.addPriceItem().

Access to ad extensions that have been added to this account: Callout, MobileApp, PhoneNumber, Sitelink, Snippet, and Price.

Methods:

Member	Type	Description
callouts()	AdsApp.CalloutSelector	Returns the selector of all callouts in the account.
mobileApps()	AdsApp.MobileAppSelector	Returns the selector of all mobile apps in the account.
newCalloutBuilder()	AdsApp.CalloutBuilder	Returns a new callout builder for this account.
newMobileAppBuilder()	AdsApp.MobileAppBuilder	Returns a new mobile app builder for this account.
newPhoneNumberBuilder()	AdsApp.PhoneNumberBuilder	Returns a new phone number builder for this account.
newPriceBuilder()	AdsApp.PriceBuilder	Returns a new price builder for this account.
newPriceItemBuilder()	AdsApp.PriceItemBuilder	Returns a new price item builder for this account.
newSitelinkBuilder()	AdsApp.SitelinkBuilder	Returns a new sitelink builder for this account.
newSnippetBuilder()	AdsApp.SnippetBuilder	Returns a new snippet builder for this account.
phoneNumbers()	AdsApp.PhoneNumberSelector	Returns the selector of all phone numbers in the account.
prices()	AdsApp.PriceSelector	Returns the selector of all prices in the account.
sitelinks()	AdsApp.SitelinkSelector	Returns the selector of all sitelinks in the account.
snippets()	AdsApp.SnippetSelector	Returns the selector of all snippets in the account.

callouts()

Returns the selector of all callouts in the account.

Return values:

Type	Description
AdsApp.CalloutSelector	The selector of all callouts in the account.

mobileApps()

Returns the selector of all mobile apps in the account.

Return values:

Type	Description
AdsApp.MobileAppSelector	The selector of all mobile apps in the account.

newCalloutBuilder()

Returns a new callout builder for this account. Once builder.build() is called, the callout will be created in this account.

Return values:

Type	Description
AdsApp.CalloutBuilder	Callout builder used to create a new callout in the account.

newMobileAppBuilder()

Returns a new mobile app builder for this account. Once builder.build() or builder.create() is called, the mobile app will be created in this account.

Return values:

Type	Description
AdsApp.MobileAppBuilder	Mobile app builder used to create a new mobile app in the account.

newPhoneNumberBuilder()

Returns a new phone number builder for this account. Once builder.build() or builder.create() is called, the phone number will be created in this account.

Return values:

Type	Description
AdsApp.PhoneNumberBuilder	Phone number builder used to create a new phone number in the account.

newPriceBuilder()

Returns a new price builder for this account. Once builder.build() is called, the price will be created in this account.

Return values:

Type	Description
AdsApp.PriceBuilder	Price builder used to create a new price in the account.

newPriceItemBuilder()

Returns a new price item builder for this account. Once builder.build() or builder.create() is called, the price item will NOT be created in this account. In order to attach the price item to the price extension, you must call price.addPriceItem().

Return values:

Type	Description
AdsApp.PriceItemBuilder	Price item builder used to create a new price item in the account.

newSitelinkBuilder()

Returns a new sitelink builder for this account. Once builder.build() or builder.create() is called, the sitelink will be created in this account.

Return values:

Type	Description
AdsApp.SitelinkBuilder	Sitelink builder used to create a new sitelink in the account.

newSnippetBuilder()

Returns a new snippet builder for this account. Once builder.build() or builder.create() is called, the snippet will be created in this account.

Return values:

Type	Description
AdsApp.SnippetBuilder	Snippet builder used to create a new snippet in the account.

phoneNumbers()

Returns the selector of all phone numbers in the account.

Return values:

Type	Description
AdsApp.PhoneNumberSelector	The selector of all phone numbers in the account.

prices()

Returns the selector of all prices in the account.

Return values:

Type	Description
AdsApp.PriceSelector	The selector of all prices in the account.

sitelinks()

Returns the selector of all sitelinks in the account.

Return values:

Type	Description
AdsApp.SitelinkSelector	The selector of all sitelinks in the account.

snippets()

Returns the selector of all snippets in the account.

Return values:

Type	Description
AdsApp.SnippetSelector	The selector of all snippets in the account.