Google Ads API'deki bir öğenin benzersiz tanımlayıcısına kaynak adı denir ve bu ad, tahmin edilebilir bir biçime sahip bir dize olarak gösterilir. Bir varlığın bileşen kimliklerini biliyorsanız tam kaynak adını oluşturmak veya ayrıştırmak için Java istemci kitaplığı yardımcı programlarını kullanabilirsiniz.
ResourceNames ile kaynak adları oluşturma
ResourceNames yardımcı program sınıfı, bir varlıkla ilgili tüm kimlikleri bildiğinizde
bu varlığın kaynak adını oluşturur. Örneğin, bir kampanya kaynak adı şu biçimdedir:
customers/{customer_id}/campaigns/{campaign_id}
Müşteri kimliğini (tire işaretleri olmadan) ve kampanya kimliğini biliyorsanız tam kaynak adını aşağıdaki gibi oluşturmak için ResourceNames sınıfını kullanın:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Kaynak adının son biçimine bağlı olarak farklı kimlik parametrelerini kabul eden diğer öğe türleri için de kaynak adları oluşturabilirsiniz.
Kaynak adlarını ayrıştırma
ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) tüm desteklenen API sürümlerinde sürümden bağımsız olsa da Java istemci kitaplığı, her sürümlü kaynak paketinde (ör. com.google.ads.googleads.v26.resources) kesin tür belirtimli kaynak adı sınıfları (ör. CampaignName, AdGroupName ve CustomerName) sağlar. Bu sınıflar, bir kaynak adı dizesini bileşen kimliklerine geri ayrıştırmanıza olanak tanır:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();