Nama resource

ID unik untuk entity di Google Ads API disebut nama resource, dan ditampilkan 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 dalam 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::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
  );

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