Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcenname bezeichnet und als String mit einem vorhersehbaren Format dargestellt. Wenn Sie die Bestandteile eines Ressourcennamens kennen, können Sie mit dem Dienstprogramm ResourceNames den formatierten Ressourcennamen generieren.
ResourceNames-Klasse
Das Dienstprogramm ResourceNames erstellt den Ressourcennamen einer Entität, wenn Sie alle relevanten IDs für diese Entität kennen. Übergeben Sie die IDs als Strings, die nur Ziffern enthalten, ohne Bindestriche.
Der Ressourcenname einer Kampagne hat beispielsweise das Format customers/{customer_id}/campaigns/{campaign_id}. Wenn Sie die Kundennummer und die Kampagnen-ID kennen, können Sie mit dem Dienstprogramm ResourceNames den vollständigen Ressourcennamen so erstellen:
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
);
Das Dienstprogramm ResourceNames bietet ähnliche Hilfsmethoden für andere Entitätstypen wie ad_group(), customer() und ad_group_criterion(). Beachten Sie, dass ResourceNames auf jeden unterstützten API-Versions-Namespace beschränkt ist (z. B. V26, wobei kleinere API-Releases wie v25.1 ihr Hauptversionsmodul V25 verwenden). Ersetzen Sie daher V26 durch Ihre Ziel-API-Version, wenn Sie eine frühere Version verwenden. Eine vollständige Liste der unterstützten Hilfsmethoden finden Sie in der ResourceNames.pm-Quelldatei.