Nomi delle risorse

L'identificatore univoco per un'entità nell'API Google Ads è chiamato nome risorsa ed è rappresentato come una stringa con un formato prevedibile. Se conosci i componenti costituenti di un nome risorsa, puoi utilizzare l'utilità ResourceNames per generare il nome 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 della risorsa completo come segue:

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

L'utilità ResourceNames fornisce metodi helper simili per altri tipi di entità, come ad_group(), customer() e ad_group_criterion(). Tieni presente che ResourceNames è limitato a ogni spazio dei nomi della versione dell'API supportata (ad esempio V25, dove le release dell'API secondarie come v25.1 utilizzano il modulo della versione principale V25), quindi sostituisci V25 con la versione dell'API di destinazione se utilizzi una versione precedente. Consulta il ResourceNames.pm file di origine per l'elenco completo dei metodi helper supportati.