Google Ads API'deki bir öğenin benzersiz tanımlayıcısına kaynak adı denir ve bu tanımlayıcı, tahmin edilebilir bir biçime sahip dize olarak gösterilir. Bir öğenin 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ı sınıfı, bir öğeyle ilgili tüm kimlikleri bildiğinizde öğenin kaynak adını oluşturur. Örneğin, bir
kampanya kaynağı adı şu biçimdedir:
customers/{customer_id}/campaigns/{campaign_id}
Müşteri kimliğini (tireler 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), desteklenen tüm API sürümlerinde sürümden bağımsız olsa da Java istemci kitaplığı, her sürüm oluşturulmuş kaynak paketinde (ör. com.google.ads.googleads.v25.resources) kaynak adı dizesini bileşen kimliklerine geri ayrıştırmanıza olanak tanıyan kesin olarak türü belirlenmiş kaynak adı sınıfları (ör. CampaignName, AdGroupName ve CustomerName) da sağlar:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();