ID unik untuk entity di Google Ads API disebut nama resource, dan ditampilkan sebagai string dengan format yang dapat diprediksi. Jika Anda mengetahui ID konstituen suatu entitas, Anda dapat menggunakan utilitas library klien Java untuk membuat atau mengurai nama resource lengkap.
Membuat nama resource dengan ResourceNames
Class utilitas ResourceNames membuat nama resource entity
jika Anda mengetahui semua ID yang relevan terkait entity tersebut. Misalnya, nama resource
kampanye menggunakan format berikut:
customers/{customer_id}/campaigns/{campaign_id}
Jika Anda mengetahui ID pelanggan (tanpa tanda hubung) dan ID kampanye, gunakan class
ResourceNames untuk membuat nama resource lengkap sebagai berikut:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Anda juga dapat membuat nama resource untuk jenis entity lain, yang menerima parameter ID yang berbeda bergantung pada bentuk akhir nama resource.
Mengurai nama resource
Meskipun ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) tidak bergantung pada versi di semua versi API yang didukung, library klien Java juga menyediakan class nama resource yang memiliki jenis kuat (seperti CampaignName, AdGroupName, dan CustomerName) di setiap paket resource yang memiliki versi (misalnya, com.google.ads.googleads.v25.resources) yang memungkinkan Anda mengurai string nama resource kembali menjadi ID penyusunnya:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();