How to get an ad's URL?

[MS]

As far as I understand, every Google ad is connected to a URL the Google ad is pointing to.

I've been wading through the Google Ads API documentation for hours by now, but I'm still struggling to get a Google ad's URL using GAQL.

So …

1. What is the GAQL query for retrieving a Google ad's URL?
2. Why is the "final_urls" attribute a collection and not a single string value?
   What's the reason behind this? I've never seen any Google ad pointing to more than a single URL so far.
3. What is the role of asset groups in regard to a Google ad's URL?

Your answer is appreciated.

[Google Ads API Forum Advisor]

Hi,

Thank you for contacting the Google Ads API support team. 

Please find responses to your queries below:

• What is the GAQL query for retrieving a Google ad's URL?

Response: In order to answer this query, please confirm if you are able to get the desired data using the Google Ads UI? If yes, please provide an uncropped UI screenshot of your Google Ads account highlighting the data which you are trying to retrieve. 

• Why is the "final_urls" attribute a collection and not a single string value? What's the reason behind this? I've never seen any Google ad pointing to more than a single URL so far.

Response: In order to answer this query, please provide your Google Ads customer Id and the complete API logs (request and response with request-id and request header) generated at your end without redacting any information. If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java, .Net, PHP, Python, Ruby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

• What is the role of asset groups in regard to a Google ad's URL?

Answer: As per the Help Center article, the final url is one of the parameters for the text asset in an asset group.  Asset Groups are where you manage different types of creative assets including text, images, videos, logos, and final URLs. You can create a single asset group with audience signals or you can also create multiple asset groups for different final URLs. Please note that: If Final URL expansion is on, Google may replace your Final URL with a more relevant landing page based on the user’s search query, and generate a dynamic headline, description, and additional assets to match your landing page content. Learn more About text customization. I would recommend you to refer to the Help Center article for more information.

You can send the details via Reply privately to the author option, or direct private reply to this email.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-09-08 15:37:15Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u62uN:ref" (ADR-00332099)

[D. H.]

Hi,

The Google Ads documentation for Final URL states Final URL: Represents a list of actual landing pages for your ad, keyword, or sitelink.

https://developers.google.com/google-ads/api/docs/ads/upgraded-urls/fields

And you can see for example in the Python Google Ads library for an ad final_urls is a RepeatedField:

final_urls: MutableSequence[str] = proto.RepeatedField(
        proto.STRING,
        number=41,
    )

https://github.com/googleads/google-ads-python/blob/c7535c7e2a8f87bb6abbad4c4b4ea05d5b4593b4/google/ads/googleads/v20/resources/types/ad.py#L257

I would also like to know why this is a repeated field rather than a string value.

Thanks,

D.H.

[Google Ads API Forum Advisor]

Hi,

I see that you are having issues with Google Ads API (Python client). I would recommend that you reach out to the Python Client Library owner by filing an issue in the issue tracker on the issues tab of your client library on GitHub, so that they can provide guidance on it.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-09-09 09:09:42Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u62uN:ref" (ADR-00332099)

[MS]

Still, the questions remains: What is the GAQL query to retrieve an ad's final URL?

[Google Ads API Forum Advisor]

Hi,

Upon checking the screenshot provided, the final URL for the campaign is within the ad_group_ad report. Please refer to the sample query below to get the final URL from the campaign using the ad_group_ad.

• SELECT ad_group_ad.ad.final_urls, ad_group_ad.ad.id, ad_group_ad.ad.name,     
         ad_group_ad.ad.resource_name,campaign.advertising_channel_sub_type,
         campaign.advertising_channel_type, campaign.name, campaign.resource_name 
  FROM ad_group_ad
  

You may use the ad_group_ad Query Builder and modify the field that you need to include while fetching the final URL.

I hope it helps.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-09-10 22:30:46Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u62uN:ref" (ADR-00332099)

[Axel Dahmen]

Thanks a lot for providing me this great hint! You've been a great help.

Damn, I missed that ad.final_urls attribute from the reference page.

I already posted a feature request to the Google Ads API Reference pages team using the Feedback feature, to offer three filter boxes, then providing for filtering not only on resources (in the left panel), but also on attributes (in the right panel) and attributes and enum values (in the middle panel), like this:

Currently, when searching for an attribute like "type", you won't find anything useful: