El identificador único de una entidad en la API de Google Ads se denomina nombre de recurso y se representa como una cadena con un formato predecible. Si conoces los IDs de los componentes de una entidad, puedes usar las utilidades de la biblioteca cliente de Java para generar o analizar el nombre completo del recurso.
Cómo construir nombres de recursos con ResourceNames
La clase de utilidad ResourceNames construye el nombre del recurso de una entidad cuando conoces todos los IDs relevantes relacionados con esa entidad. Por ejemplo, el nombre de un recurso de campaña tiene el siguiente formato:
customers/{customer_id}/campaigns/{campaign_id}
Si conoces el ID del cliente (sin guiones) y el ID de la campaña, usa la clase ResourceNames para construir el nombre completo del recurso de la siguiente manera:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
También puedes construir nombres de recursos para otros tipos de entidades, que aceptan diferentes parámetros de ID según la forma final del nombre del recurso.
Analiza nombres de recursos
Si bien ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) es independiente de la versión en todas las versiones de la API admitidas, la biblioteca cliente de Java también proporciona clases de nombres de recursos con escritura segura (como CampaignName, AdGroupName y CustomerName) en cada paquete de recursos con versiones (por ejemplo, com.google.ads.googleads.v25.resources) que te permiten analizar una cadena de nombre de recurso y volver a obtener sus IDs constituyentes:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();