שמות המשאבים

המזהה הייחודי של ישות ב-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.v26.resources) שמאפשרות לנתח מחרוזת של שם משאב בחזרה למזהים שמרכיבים אותה:

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

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