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 das Dienstprogramm ResourceNames verwenden, um den formatierten Ressourcennamen zu 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 ohne Bindestriche enthalten.
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 v26.1 ihr Hauptversionsmodul V26 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.