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 einzelnen Komponenten eines Ressourcennamens kennen, können Sie mit dem Dienstprogramm ResourceNames den formatierten Ressourcennamen generieren.
ResourceNames-Klasse
Mit dem Dienstprogramm ResourceNames wird der Ressourcenname einer Entität erstellt, wenn Sie alle relevanten IDs für diese Entität kennen. Übergeben Sie die IDs als Strings, die nur Ziffern und keine Bindestriche enthalten.
Der Name einer Kampagnenressource hat beispielsweise das Format customers/{customer_id}/campaigns/{campaign_id}. Wenn Sie die Kunden-ID und die Kampagnen-ID kennen, können Sie das ResourceNames-Tool verwenden, um den vollständigen Ressourcennamen so zu erstellen:
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
);
Das Dienstprogramm ResourceNames bietet ähnliche Hilfsmethoden für andere Entitätstypen wie ad_group(), customer() und ad_group_criterion(). ResourceNames ist auf jeden unterstützten API-Versionsnamespace beschränkt (z. B. V25, wobei untergeordnete API-Releases wie v25.1 das Modul der Hauptversion V25 verwenden). Ersetzen Sie V25 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.