שמות המשאבים

המזהה הייחודי של ישות ב-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 קובץ המקור מכיל את הרשימה המלאה של שיטות העזר הנתמכות.