ID unik untuk entity di Google Ads API disebut nama resource, dan direpresentasikan sebagai string dengan format yang dapat diprediksi. Jika mengetahui ID konstituen suatu entity, 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
saat 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 diketik dengan kuat (seperti CampaignName, AdGroupName, dan CustomerName) di setiap paket resource berversi (misalnya, com.google.ads.googleads.v26.resources) yang memungkinkan Anda mengurai string nama resource kembali ke ID konstituennya:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();