نام‌های منبع

شناسه یکتا برای یک نهاد در 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);

می‌توانید نام‌های منبع را برای انواع دیگر نهادها نیز بسازید، که بسته به شکل نهایی نام منبع، پارامترهای شناسه مختلفی را می‌پذیرند.

تجزیه نام منابع

While ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) is version-agnostic across all supported API versions, the Java client library also provides strongly-typed resource name classes (such as CampaignName, AdGroupName, and CustomerName) in each versioned resources package (for example, com.google.ads.googleads.v26.resources) that let you parse a resource name string back into its constituent IDs:

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

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