How to get an ad's URL?

27 views
Skip to first unread message

MS

unread,
Sep 7, 2025, 3:51:50 PM (2 days ago)  Sep 7
to Google Ads API and AdWords API Forum
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

unread,
Sep 8, 2025, 11:38:03 AM (yesterday)  Sep 8
to axe...@axeldahmen.de, adwor...@googlegroups.com

Hi,

Thank you for contacting the Google Ads API support team. 

Please find responses to your queries below:

  • What is the GAQL queryfor 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 collectionand 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 groupsin 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 Logo
Google Ads API Team

Feedback
How was our support today?

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



D. H.

unread,
Sep 8, 2025, 9:41:01 PM (20 hours ago)  Sep 8
to Google Ads API and AdWords API Forum
Hi,

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

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,
    )

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

unread,
5:10 AM (12 hours ago)  5:10 AM
to heiberge...@gmail.com, adwor...@googlegroups.com

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 Logo
Google Ads API Team

Feedback
How was our support today?

rating1 rating2 rating3 rating4 rating5

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



Reply all
Reply to author
Forward
0 new messages