Nama resource

ID unik untuk entity di Google Ads API disebut nama resource, dan direpresentasikan sebagai string dengan format yang dapat diprediksi. Jika Anda mengetahui komponen penyusun nama resource, Anda dapat menggunakan utilitas ResourceNames untuk membuat nama resource yang diformat.

Class ResourceNames

Utilitas ResourceNames membuat nama resource entity saat Anda mengetahui semua ID yang relevan terkait entity tersebut. Teruskan ID sebagai string yang hanya berisi digit, tanpa tanda hubung.

Misalnya, nama resource kampanye menggunakan format customers/{customer_id}/campaigns/{campaign_id}. Jika mengetahui ID pelanggan dan ID kampanye, Anda dapat menggunakan utilitas ResourceNames untuk membuat nama resource lengkap sebagai berikut:

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
  );

Utilitas ResourceNames menyediakan metode bantuan serupa untuk jenis entity lainnya, seperti ad_group(), customer(), dan ad_group_criterion(). Perhatikan bahwa ResourceNames dicakupkan ke setiap namespace versi API yang didukung (seperti V26, dengan rilis API minor seperti v25.1 menggunakan modul versi utamanya V25), jadi ganti V26 dengan versi API target Anda jika menggunakan versi yang lebih lama. Lihat file sumber ResourceNames.pm untuk mengetahui daftar lengkap metode bantuan yang didukung.