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 constituyentes de una entidad, puedes usar las utilidades de la biblioteca cliente de Java para generar o analizar el nombre completo del recurso.
Crea nombres de recursos con ResourceNames
La clase de utilidad ResourceNames construye el nombre del recurso de una entidad
cuando conoces todos los IDs pertinentes 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 de cliente (sin guiones) y el ID de 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 los nombres de los recursos
Si bien ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) es
independiente de la versión en todas las versiones de la API compatibles, la biblioteca cliente de Java también
proporciona clases de nombres de recursos con tipos de datos definidos (como CampaignName,
AdGroupName y CustomerName) en cada paquete de recursos con versión (por
ejemplo, com.google.ads.googleads.v26.resources) que
te permiten analizar una cadena de nombre de recurso en sus IDs constituyentes:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();