Resource Names

  • Resource names are unique identifiers for entities in the Google Ads API, represented as strings with a predictable format.

  • The ResourceNames class can construct the full resource name of an entity if you know its relevant IDs.

  • For example, a campaign resource name is formatted as customers/{customer_id}/campaigns/{campaign_id} and can be constructed using the ResourceNames.campaign(customerId, campaignId) method.

  • The ResourceNames class can be used with other entity names by providing the necessary IDs for their specific resource name format.

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 class 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 class construct the full resource name as follows:

String campaignResourceName = ResourceNames.campaign(customerId, campaignId);

You can use other entity names as well, which take different IDs depending on the final form of the resource name.