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

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

คลาส ResourceNames

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

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

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

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

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

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