نام‌های منبع

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