ตัวระบุที่ไม่ซ้ำกันสำหรับเอนทิตีใน Google Ads API เรียกว่าชื่อทรัพยากร และแสดงเป็นสตริงที่มีรูปแบบที่คาดการณ์ได้ หากทราบรหัสส่วนประกอบของเอนทิตี คุณสามารถใช้ยูทิลิตีไลบรารีของไคลเอ็นต์ Java เพื่อสร้างหรือแยกวิเคราะห์ชื่อทรัพยากรแบบเต็มได้
สร้างชื่อทรัพยากรด้วย ResourceNames
คลาสยูทิลิตี ResourceNames จะสร้างชื่อทรัพยากรของเอนทิตีเมื่อคุณทราบรหัสที่เกี่ยวข้องทั้งหมดของเอนทิตีนั้น ตัวอย่างเช่น ชื่อทรัพยากรแคมเปญจะอยู่ในรูปแบบต่อไปนี้
customers/{customer_id}/campaigns/{campaign_id}
หากคุณทราบรหัสลูกค้า (ไม่มีขีดกลาง) และรหัสแคมเปญ ให้ใช้คลาส ResourceNames เพื่อสร้างชื่อทรัพยากรแบบเต็มดังนี้
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
คุณสามารถสร้างชื่อทรัพยากรสำหรับเอนทิตีประเภทอื่นๆ ได้ด้วย ซึ่งจะยอมรับพารามิเตอร์รหัสที่แตกต่างกันไปตามรูปแบบสุดท้ายของชื่อทรัพยากร
แยกวิเคราะห์ชื่อทรัพยากร
แม้ว่า ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) จะไม่ขึ้นอยู่กับเวอร์ชันใน API เวอร์ชันที่รองรับทั้งหมด แต่ไลบรารีของไคลเอ็นต์ Java ยังมีคลาสชื่อทรัพยากรที่มีประเภทชัดเจน (เช่น CampaignName, AdGroupName และ CustomerName) ในแพ็กเกจทรัพยากรที่มีเวอร์ชันแต่ละแพ็กเกจ (เช่น com.google.ads.googleads.v26.resources) ซึ่งช่วยให้คุณแยกวิเคราะห์สตริงชื่อทรัพยากรกลับเป็นรหัสส่วนประกอบได้ ดังนี้
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();