שמות המשאבים

המזהה הייחודי של ישות ב-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 משניות כמו v26.1 משתמשות במודול הגרסה הראשית V26), אז אם אתם משתמשים בגרסה קודמת, החליפו את V26 בגרסת ה-API הרצויה. ResourceNames.pm source file לרשימה המלאה של שיטות העזר הנתמכות.