O identificador exclusivo de uma entidade na API Google Ads é chamado de nome do recurso e é representado como uma string com um formato previsível. Se você souber os IDs constituintes de uma entidade, use os utilitários da biblioteca de cliente Java para gerar ou analisar o nome completo do recurso.
Construir nomes de recursos com ResourceNames
A classe utilitária ResourceNames cria o nome do recurso de uma entidade
quando você conhece todos os IDs relevantes relacionados a ela. Por exemplo, o nome de um recurso de campanha está no seguinte formato:
customers/{customer_id}/campaigns/{campaign_id}
Se você souber o ID do cliente (sem hifens) e o ID da campanha, use a classe ResourceNames para construir o nome completo do recurso da seguinte maneira:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Também é possível criar nomes de recursos para outros tipos de entidades, que aceitam parâmetros de ID diferentes, dependendo da forma final do nome do recurso.
Analisar nomes de recursos
Embora ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) seja
independente de versão em todas as versões de API compatíveis, a biblioteca de cliente Java também
fornece classes de nome de recurso fortemente tipadas (como CampaignName,
AdGroupName e CustomerName) em cada pacote de recursos versionado (por
exemplo, com.google.ads.googleads.v25.resources) que
permitem analisar uma string de nome de recurso de volta aos IDs constituintes:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();