שמות המשאבים

המזהה הייחודי של ישות ב-Google Ads API נקרא שם משאב, והוא מיוצג כמחרוזת בפורמט צפוי. אם אתם יודעים את מזהי הרכיבים של ישות, אתם יכולים להשתמש בכלי השירות של ספריית הלקוח של Java כדי ליצור או לנתח את שם המשאב המלא.

יצירת שמות משאבים באמצעות ResourceNames

מחלקת כלי העזר ResourceNames יוצרת את שם המשאב של ישות מסוימת כשאתם יודעים את כל המזהים הרלוונטיים שקשורים לישות הזו. לדוגמה, שם משאב של קמפיין הוא בפורמט הבא:

customers/{customer_id}/campaigns/{campaign_id}

אם אתם יודעים את מספר הלקוח (בלי מקפים) ואת מזהה הקמפיין, אתם יכולים להשתמש במחלקה ResourceNames כדי ליצור את שם המשאב המלא באופן הבא:

long customerId = 1234567890L;
long campaignId = 9876543210L;

String campaignResourceName = ResourceNames.campaign(customerId, campaignId);

אפשר ליצור שמות משאבים גם לסוגים אחרים של ישויות, שמקבלים פרמטרים שונים של מזהים בהתאם לצורה הסופית של שם המשאב.

ניתוח שמות של משאבים

‫ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) לא תלוי בגרסה בכל גרסאות ה-API הנתמכות, אבל ספריית הלקוח של Java מספקת גם מחלקות של שמות משאבים עם הקלדה חזקה (כמו CampaignName,‏ AdGroupName ו-CustomerName) בכל חבילת משאבים עם גרסה (לדוגמה, com.google.ads.googleads.v25.resources) שמאפשרות לכם לנתח מחרוזת של שם משאב בחזרה למזהים המרכיבים שלה:

import com.google.ads.googleads.v25.resources.CampaignName;

CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();