Clarification on Campaign Feeds and Location Groups for Performance Max Campaigns

[Amit Tomar]

Dear Team,

I am currently working with the "Local store visits and promotions" campaign objective and using the Performance Max campaign type. I would like to clarify the following points regarding the Campaign Feeds section:

1. Could you please confirm which Google Ads API endpoint or method should be used to fetch all location groups?

2. When creating a campaign via the API, which field in the campaign resource should be used to define or associate location groups?

I have attached a screenshot for reference to provide better context.

Thank you for your support.

[Google Ads API Forum Advisor]

Hi,

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

Please find the answers for your questions below: 

1. Could you please confirm which Google Ads API endpoint or method should be used to fetch all location groups?

• You need to use the campaign_criterion resource to retrieve all the location groups from the Google Ads API. As you are specifically looking for the PMax campaigns, I have build a GAQL query using which you can retrieve the location groups of a PMax campaigns in the Google Ads API. You can find the sample GAQL query as per your requirement: 

• SELECT campaign_criterion.criterion_id, campaign_criterion.type, campaign_criterion.resource_name, 
  campaign.advertising_channel_type FROM campaign_criterion WHERE campaign.advertising_channel_type = 
  'PERFORMANCE_MAX' AND campaign_criterion.type = 'LOCATION_GROUP'

• You can use the search or searchStream methods in making the API calls while retrieving the data. Additionally, you can utilize the Google Ads Query Builder and Query Validator to build and validate the queries for retrieving the data from the Google Ads API.

2. When creating a campaign via the API, which field in the campaign resource should be used to define or associate location groups?

• While creating a campaign via the API, you need to use the campainCriteria method for creating the location groups in the Google Ads API. I would recommend you to refer to the Create the campaign criteria documentation for more detailed information. Also, you can refer to the LocationGroupInfo guide for more information. However, I am providing you the sample request and response logs for creating the location groups for PMax campaign using the Google Ads API. 

• Request Body:
  ===============
  POST https://googleads.googleapis.com/v19/customers/{customerId}/campaignCriteria:mutate?key=[YOUR_API_KEY] HTTP/1.1
  
  developer-token: **********************
  Authorization: Bearer [YOUR_ACCESS_TOKEN]
  Accept: application/json
  Content-Type: application/json
  
  {
    "operations": [
      {
        "create": {
          "campaign": "customers/{customerId}/campaigns/{campaignId}",   //PMax campaign ID
          "locationGroup": {
            "geoTargetConstants": [
              "geoTargetConstants/2008"
            ],
            "radius": 3000,
            "radiusUnits": "METERS",
            "locationGroupAssetSets": [
              "customers/{customerId}/assetSets/{assetSetId}"
            ]
          }
        }
      }
    ]
  }
  
  Response:
  ===========
  
  HTTP/1.1 200 
  content-encoding: gzip
  content-length: 128
  content-type: application/json; charset=UTF-8
  date: Thu, 24 Apr 2025 18:03:51 GMT
  server: ESF
  vary: Origin, X-Origin, Referer
  
  {
    "results": [
      {
        "resourceName": "customers/{customerId}/campaignCriteria/{campaignId}~{campaignCriterionId}"
      }
    ]
  }

• I hope this clarifies. 

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-04-24 18:24:57Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qUriR:ref" (ADR-00301563)

[Amit Tomar]

Dear Team,

Thank you for your previous detailed response regarding Campaign Feeds and Location Groups.

However, I would like to kindly clarify my actual requirement, as I believe there may have been some misunderstanding:

• I am not looking to retrieve location groups already assigned to campaigns.

• I am trying to fetch the list of available location groups (the same way it appears in the UI under “Choose store locations” > “Use location groups”) before associating them with a new Performance Max campaign.

• Essentially, I would like to display all available location groups in my application so users can select from them when creating a campaign.

Could you please confirm:

1. Which API resource or method should be used to retrieve the list of available location groups?

2. Could you please provide an example GAQL query to retrieve all such available location groups?

Thank you for your support and guidance.

[Google Ads API Forum Advisor]

Hi,

By reviewing your concern, I understand that you are trying to retrieve a list of available location groups. Note that in Google Ads API before ‘V19’ version of Google Ads API, location groups were retrieved using feed_item_set resource. But in the ‘V19’ version, the feed_item_set resource has been removed. Now, ‘Location’ is an asset and ‘LOCATION_GROUP’ is an asset set. I would recommend you to refer to this document for complete information.

Below are the answers for your concerns:

1. Which API resource or method should be used to retrieve the list of available location groups?

To fetch a list of all available location groups, you should query an asset_set resource.

2. Could you please provide an example GAQL query to retrieve all such available location groups?

SELECT asset_set.id, asset_set.name, asset_set.status, asset_set.type FROM asset_set WHERE asset_set.type = 'BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP'

If you want to fetch all available geo target constants, i.e., all available countries, cities, regions etc. in Google Ads API, I would recommend you to use geo_target_constant resource.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-04-28 09:52:35Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qUriR:ref" (ADR-00301563)