نام‌های منبع

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

کلاس ResourceNames

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

برای مثال، نام منبع پویش در قالب customers/{customer_id}/campaigns/{campaign_id} است. اگر شناسه مشتری و شناسه پویش را می‌دانید، می‌توانید از ابزار کمکی ResourceNames برای ساختن نام کامل منبع به‌صورت زیر استفاده کنید:

use Google::Ads::GoogleAds::V26::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V26::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

ابزار ResourceNames روش‌های کمکی مشابهی را برای انواع دیگر نهادها، مانند ad_group()، customer()، و ad_group_criterion() ارائه می‌دهد. توجه داشته باشید که ResourceNames به هر فضای نام نسخه میانای برنامه‌سازی کاربردی پشتیبانی‌شده (مانند V26، که در آن نسخه‌های جزئی میانای برنامه‌سازی کاربردی مانند v25.1 از ماژول نسخه اصلی V25 استفاده می‌کنند) محدود می‌شود، بنابراین اگر از نسخه قبلی استفاده می‌کنید، V26 را با نسخه میانای برنامه‌سازی کاربردی هدف خود جایگزین کنید. برای مشاهده فهرست کامل روش‌های کمکی پشتیبانی‌شده، ResourceNames.pm فایل منبع را ببینید.