نام منابع

شناسه منحصر به فرد برای یک موجودیت در API گوگل ادز، نام منبع نامیده می‌شود و به صورت رشته‌ای با قالبی قابل پیش‌بینی نمایش داده می‌شود. اگر اجزای تشکیل‌دهنده یک نام منبع را می‌دانید، می‌توانید از ابزار ResourceNames برای تولید نام منبع قالب‌بندی شده استفاده کنید.

کلاس ResourceNames

ابزار ResourceNames نام منبع یک موجودیت را زمانی می‌سازد که شما تمام شناسه‌های (ID) مربوط به آن موجودیت را می‌دانید. شناسه‌ها را به صورت رشته‌هایی که فقط شامل اعداد هستند، بدون خط تیره ارسال کنید.

برای مثال، نام منبع یک کمپین به فرمت 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() ارائه می‌دهد. توجه داشته باشید که ResourceNames به هر فضای نام نسخه API پشتیبانی شده (مانند V25 ، که در آن نسخه‌های فرعی API مانند v25.1 از ماژول نسخه اصلی خود V25 استفاده می‌کنند) محدود می‌شود، بنابراین اگر از نسخه‌های قدیمی‌تر استفاده می‌کنید، V25 را با نسخه API هدف خود جایگزین کنید. برای لیست کامل متدهای کمکی پشتیبانی شده، به فایل منبع ResourceNames.pm مراجعه کنید.