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 au 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 formaté.
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 trait d'union.
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 la campagne, vous pouvez utiliser l'utilitaire ResourceNames pour créer le nom complet de la ressource comme suit :
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'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 (tel que V26, où les versions d'API mineures telles que v25.1 utilisent leur module de version majeure V25). Remplacez donc V26 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.