Resource Names
Stay organized with collections
Save and categorize content based on your preferences.
The
ResourceNames
utility is a way to construct the resource name of an entity if you know all of
the relevant IDs related to that entity. For example, a campaign resource name
is in the format customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>, so if you
know the customer ID and the campaign ID, you can use the ResourceNames
utility to construct the full resource name.
Provided that $customerId contains your customer ID and $campaignId contains
your campaign ID, you can use
forCampaign
to get the resource name of the campaign as shown below:
$campaignResourceName = ResourceNames::forCampaign($customerId, $campaignId)
Each entity has a different set of IDs that composes the resource name. For
instance, the resource name of an ad group criterion needs a customer ID, ad
group ID, and ad group criterion ID.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eResourceNames\u003c/code\u003e utility helps build resource names for Google Ads entities using their respective IDs.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide the necessary IDs, like customer ID and campaign ID, to construct a specific resource name.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Ads entity type has a unique set of IDs required for its resource name, such as ad group criteria needing customer ID, ad group ID, and criterion ID.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eResourceNames\u003c/code\u003e offers functions like \u003ccode\u003eforCampaign\u003c/code\u003e to easily generate resource names for specific entities.\u003c/p\u003e\n"]]],[],null,["# Resource Names\n\nThe\n[ResourceNames](https://github.com/googleads/google-ads-php/blob/HEAD/src/Google/Ads/GoogleAds/Util/V21/ResourceNames.php)\nutility is a way to construct the resource name of an entity if you know all of\nthe relevant IDs related to that entity. For example, a campaign resource name\nis in the format `customers/\u003cCUSTOMER_ID\u003e/campaigns/\u003cCAMPAIGN_ID\u003e`, so if you\nknow the customer ID and the campaign ID, you can use the `ResourceNames`\nutility to construct the full resource name.\n\nProvided that `$customerId` contains your customer ID and `$campaignId` contains\nyour campaign ID, you can use\n[forCampaign](https://github.com/googleads/google-ads-php/blob/HEAD/src/Google/Ads/GoogleAds/Util/V21/ResourceNames.php#L141)\nto get the resource name of the campaign as shown below: \n\n $campaignResourceName = ResourceNames::forCampaign($customerId, $campaignId)\n\nEach entity has a different set of IDs that composes the resource name. For\ninstance, the resource name of an ad group criterion needs a customer ID, ad\ngroup ID, and ad group criterion ID."]]
