L'identifiant unique d'une entité dans l'API Google Ads est appelé nom de ressource. Il est représenté sous la forme d'une chaîne avec un format prévisible. Si vous connaissez les composants d'un nom de ressource, vous pouvez utiliser l'utilitaire ResourceNames pour générer le nom de ressource mis en forme.
Classe ResourceNames
L'utilitaire ResourceNames construit le nom de ressource d'une entité lorsque vous connaissez tous les ID pertinents associés à cette entité. Transmettez les ID sous forme de chaînes contenant uniquement des chiffres, sans tirets.
Par exemple, le nom d'une ressource de campagne est au format customers/{customer_id}/campaigns/{campaign_id}. Si vous connaissez le numéro client et l'ID de campagne, vous pouvez utiliser l'utilitaire ResourceNames pour construire le nom complet de la ressource comme suit :
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'utilitaire ResourceNames fournit des méthodes d'assistance similaires pour d'autres types d'entités, tels que ad_group(), customer() et ad_group_criterion(). Notez que ResourceNames est limité à chaque espace de noms de version d'API compatible (par exemple, V25, où les versions mineures de l'API telles que v25.1 utilisent leur module de version majeure V25). Par conséquent, remplacez V25 par votre version d'API cible si vous utilisez une version antérieure. Consultez le fichier source ResourceNames.pm pour obtenir la liste complète des méthodes d'assistance compatibles.