شناسه منحصر به فرد برای یک موجودیت در API گوگل ادز، نام منبع (resource name) نامیده میشود و به صورت رشتهای با قالبی قابل پیشبینی نمایش داده میشود. اگر شناسههای تشکیلدهنده یک موجودیت را میدانید، میتوانید از ابزارهای کتابخانه کلاینت جاوا برای تولید یا تجزیه نام کامل منبع استفاده کنید.
ساخت نام منابع با ResourceNames
کلاس کاربردی ResourceNames نام منبع یک موجودیت را زمانی میسازد که شما تمام شناسههای (ID) مربوط به آن موجودیت را میدانید. برای مثال، نام منبع یک کمپین به شکل زیر است:
customers/{customer_id}/campaigns/{campaign_id}
اگر شناسه مشتری (بدون خط فاصله) و شناسه کمپین را میدانید، از کلاس ResourceNames برای ساخت نام کامل منبع به شرح زیر استفاده کنید:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
شما میتوانید نامهای منبع را برای انواع موجودیتهای دیگر نیز بسازید، که بسته به شکل نهایی نام منبع، پارامترهای ID متفاوتی را میپذیرند.
تجزیه نام منابع
اگرچه ResourceNames ( com.google.ads.googleads.lib.utils.ResourceNames ) در تمام نسخههای API پشتیبانیشده، مستقل از نسخه است، کتابخانه کلاینت جاوا همچنین کلاسهای نام منبع با نوعبندی قوی (مانند 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();