Request for API/GAQL Clarifications on Business Locations & Location Groups in Google Ads Location Manager

[Hardeep Singh]

Hello Google Ads Support Team,

I am working with the Location Manager under Tools → Shared Library in Google Ads, and I would like to request clarification on several API-related points based on the screenshots attached.

I kindly request your guidance on the following:

---

1. GAQL Query for Business Locations

• What is the correct GAQL query to retrieve all Business Locations listed under Location Manager → Business locations?

• Does this GAQL response include full location metadata such as:

  • City

  • State / Province

  • Country code

  • Postal code

  • Phone number

  • Chain Name

  • Chain ID

  • Place ID

• If these fields are not available through asset or geo_target resources, please clarify which resource or API endpoint should be used to fetch them.

---

2. API Code to Create Location Groups & Attach Business Locations

• Please provide a full code sample that demonstrates:

  1. Creating a Location Group

  2. Adding or associating Business Locations to the newly created group

---

3. Uploading & Validating CSV/Excel Files for Location Group Creation

The UI provides an option to upload a CSV/Excel file to create or update a location group.

I would like clarification on the API side:

• Is there an API method to validate the uploaded CSV/Excel rows (e.g., business data format, invalid Place IDs, address validation)?

• What is the API method or recommended approach to:

  • Create location groups using CSV/Excel input

  • Create business locations via CSV/Excel upload programmatically

---

4. “Filter by label” in Location Groups

While creating a location group in the UI, there is an option to Filter by label.

Could you please clarify:

• Which API resource and fields correspond to these labels?

• What is the API code or example request to filter business locations by label?

---

I appreciate your assistance and any relevant documentation links you can provide.

Thank you for your support.

Warm regards,

[Google Ads API Forum Advisor]

Hi,

 

Thank you for reaching out to the Google Ads API support team.

 

>> What is the correct GAQL query to retrieve all Business Locations listed under Location Manager → Business locations?

 

Kindly note that the business locations are not available from the Google Ads API. However, I will raise a request for this feature to be available in the Google Ads API. I cannot provide a scheduled timeline for the availability of this feature in the API. I would recommend you to kindly follow our Release Notes and Blog post for future updates.

 

>> API Code to Create Location Groups & Attach Business Locations

 

• Initially, you need to create a location sync asset set and attach it to the customer by following this documentation.
• Once these steps are completed, the Google Ads API automatically generates location assets and adds them to the created location sync asset set, just as it would if you added them manually using the AssetSetAssetService. You don't need to manage these assets yourself unless you intend to manually add them to a static location group asset set.
• You can create a location group asset set by following this guide. 

>> Uploading & Validating CSV/Excel Files for Location Group Creation

 

The Google Ads API doesn't support uploading or validating csv files. It only supports one csv file i.e, campaign report to csv 

 

>> “Filter by label” in Location Groups

 

Location group asset sets contain a subset of location assets of the location sync asset set. You can dynamically create a location group asset set by leveraging some features of Google Business Profile (like filtering by labels) or chain IDs and chain locations. I would suggest to refer to the Create a location group asset set and attach it to a campaign or an ad group for more information.

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-11-17 17:37:51Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01vTdED:ref" (ADR-00339519)