ตัวระบุที่ไม่ซ้ำกันของเอนทิตีใน 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.v25.resources) ซึ่งช่วยให้คุณแยกวิเคราะห์สตริงชื่อทรัพยากรกลับเป็นรหัสส่วนประกอบได้
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();