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 della 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 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 ogni spazio dei nomi della versione dell'API supportata (ad esempio V26, dove le release secondarie dell'API come v26.1 utilizzano il modulo della versione principale V26), 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.