שמות המשאבים

המזהה הייחודי של ישות ב-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(). שימו לב שה-API‏ ResourceNames מוגבל לכל מרחב שמות של גרסת API נתמכת (למשל V25, כאשר גרסאות API משניות כמו v25.1 משתמשות במודול של הגרסה הראשית V25), לכן אם אתם משתמשים בגרסה קודמת, אתם צריכים להחליף את V25 בגרסת ה-API לטירגוט. ResourceNames.pm הרשימה המלאה של שיטות העזר הנתמכות מופיעה בקובץ המקור.