ชื่อทรัพยากร

ตัวระบุที่ไม่ซ้ำกันของเอนทิตีใน Google Ads API เรียกว่าชื่อทรัพยากร และแสดงเป็นสตริงที่มีรูปแบบที่คาดการณ์ได้ หากทราบองค์ประกอบที่เป็นส่วนประกอบของชื่อทรัพยากร คุณสามารถใช้ยูทิลิตี ResourceNames เพื่อสร้างชื่อทรัพยากรที่จัดรูปแบบแล้วได้

คลาส ResourceNames

ยูทิลิตี ResourceNames จะสร้างชื่อทรัพยากรของเอนทิตีเมื่อคุณทราบรหัสที่เกี่ยวข้องทั้งหมดที่เกี่ยวข้องกับเอนทิตีนั้น ส่งรหัสเป็นสตริง ที่มีเฉพาะตัวเลขโดยไม่มีขีดกลาง

เช่น ชื่อทรัพยากรแคมเปญอยู่ในรูปแบบ customers/{customer_id}/campaigns/{campaign_id} หากทราบรหัสลูกค้า และรหัสแคมเปญ คุณสามารถใช้ยูทิลิตี ResourceNames เพื่อสร้าง ชื่อทรัพยากรแบบเต็มได้ดังนี้

use Google::Ads::GoogleAds::V25::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

ยูทิลิตี ResourceNames มีเมธอดตัวช่วยที่คล้ายกันสำหรับเอนทิตีประเภทอื่นๆ เช่น ad_group(), customer() และ ad_group_criterion() โปรดทราบว่า ResourceNames มีขอบเขตเป็นเนมสเปซของ API เวอร์ชันที่รองรับแต่ละรายการ (เช่น V25 ซึ่งการเปิดตัว API ย่อย เช่น v25.1 จะใช้โมดูลเวอร์ชันหลัก V25) ดังนั้นให้แทนที่ V25 ด้วย เวอร์ชัน API เป้าหมายหากใช้เวอร์ชันก่อนหน้า ดูรายการวิธีตัวช่วยทั้งหมดที่รองรับได้ในResourceNames.pm ไฟล์ต้นฉบับ