Resource Names
Stay organized with collections
Save and categorize content based on your preferences.
The unique identifier for an entity in the Google Ads API is called a resource
name, and is represented as a string with a predictable format. If you know the
constituent components of a resource name, you can use this utility to generate
the final resource name.
ResourceNames class
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 as follows:
my $resource_name =
Google::Ads::GoogleAds::V21::Utils::ResourceNames::campaign($customer_id,
$campaign_id);
You can use other entity names as well, which take different IDs depending on
the final form of the resource name.
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-09-03 UTC.
[null,null,["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eGoogle Ads API entities are uniquely identified by resource names, which are strings with predictable formats based on their components.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eResourceNames\u003c/code\u003e utility helps construct these resource names when you know the necessary IDs, such as customer and campaign IDs.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003eResourceNames\u003c/code\u003e utility with various entity names, providing the corresponding IDs needed for the specific resource name structure.\u003c/p\u003e\n"]]],[],null,["# Resource Names\n\nThe unique identifier for an entity in the Google Ads API is called a resource\nname, and is represented as a string with a predictable format. If you know the\nconstituent components of a resource name, you can use this utility to generate\nthe final resource name.\n\nResourceNames class\n-------------------\n\nThe `ResourceNames` utility is a way to construct the resource name of an entity\nif you know all of the relevant IDs related to that entity. For example, a\ncampaign resource name is in the format\n`customers/{customer_id}/campaigns/{campaign_id}`, so if you know the customer\nID and the campaign ID, you can use the `ResourceNames` utility to construct the\nfull resource name as follows: \n\n my $resource_name =\n Google::Ads::GoogleAds::V21::Utils::ResourceNames::campaign($customer_id,\n $campaign_id);\n\nYou can use other entity names as well, which take different IDs depending on\nthe final form of the resource name."]]
