L'identificatore univoco di un'entità nell'API Google Ads è chiamato nome della risorsa ed è rappresentato come una stringa con un formato prevedibile. Se conosci i componenti costitutivi di un nome di risorsa, puoi utilizzare l'utilità ResourceNames per generare il nome della risorsa formattato.
Classe ResourceNames
L'utilità ResourceNames crea il nome della risorsa di un'entità quando conosci tutti gli ID pertinenti correlati a quell'entità. Trasmetti gli ID come stringhe contenenti solo cifre, senza trattini.
Ad esempio, il nome di una risorsa della campagna è nel formato customers/{customer_id}/campaigns/{campaign_id}. Se conosci l'ID cliente e l'ID campagna, puoi utilizzare l'utilità ResourceNames per creare il nome completo della risorsa come segue:
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
);
L'utilità ResourceNames fornisce metodi helper simili per altri tipi di entità, come ad_group(), customer() e ad_group_criterion(). Tieni presente che ResourceNames ha come ambito lo spazio dei nomi di ogni versione dell'API supportata (ad esempio V26, dove le release secondarie dell'API come v25.1 utilizzano il modulo della versione principale V25), quindi sostituisci V26 con la versione dell'API di destinazione se utilizzi una versione precedente. Consulta il file di origine ResourceNames.pm per l'elenco completo dei metodi helper supportati.