Ressourcennamen

Namenshierarchie

Die in der Search Ads 360 Reporting API verwendeten Ressourcennamen sind hierarchisch aufgebaut und spiegeln die Organisation der Entitäten in Search Ads 360 wider. Fast alle Ressourcen sind Unterressourcen der Ressource Customer. Dies spiegelt wider, dass fast jeder API-Aufruf auf ein bestimmtes Search Ads 360-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind z. B. Unterressourcen einer Stammkundenressource.

Ressource Ressourcenname
Kunde customers/1234567890
Kampagne customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

Ressourcen-IDs

Elemente der Search Ads 360 Reporting API (Kunden, Kampagnen usw.) werden in der API mit ihren Ressourcennamen bezeichnet. Die Ressourcennamen selbst können jedoch eindeutige numerische Ressourcen-IDs haben, mit denen jedes Objekt in der Hierarchie identifiziert werden kann. In diesen Fällen kann es nützlich sein, den Ressourcennamen zu parsen, um diese Ressourcen-IDs zu extrahieren und eine neue zu erstellen.

Sehen Sie sich beispielsweise den Ressourcennamen AdGroupAd aus der vorherigen Tabelle an:

customers/1234567890/adGroupAds/54321098765~2109876543210

Diese kann so in die einzelnen Ressourcen-IDs (durch Sammlungs-IDs getrennt) aufgeschlüsselt werden:

Komponenten des Ressourcennamens
Ressourcen-IDs
Kundennummer:
"1234567890"
Anzeigengruppen-ID:
"54321098765"
Anzeigen-ID der Anzeigengruppe:
"2109876543210"
Sammlungs-IDs
"customers"
"adGroupAds"

Durch das Parsen der einzelnen IDs können Sie neue Ressourcennamen ableiten, um auf den Kunden der Anzeige in der Anzeigengruppe (customers/1234567890) oder auf die Anzeigengruppe (customers/1234567890/adGroupAds/54321098765) zu verweisen.