Ressourcennamen

Namenshierarchie

Die in der Search Ads 360 Reporting API verwendeten Ressourcennamen sind hierarchisch und spiegeln die Organisation von Entitäten in Search Ads 360 wider. Fast alle Ressourcen sind untergeordnete Ressourcen der Ressource Customer. Das spiegelt die Tatsache wider, dass fast jeder API-Aufruf auf ein bestimmtes Search Ads 360-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind beispielsweise untergeordnete Ressourcen einer übergeordneten Kundenressource.

Ressource Ressourcenname
Kunde customers/1234567890
Campaign customers/1234567890/campaigns/8765432109
Anzeigengruppe customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

Ressourcen-IDs

Search Ads 360 Reporting API-Entitäten (Kunden, Kampagnen usw.) werden in der API anhand ihrer Ressourcennamen bezeichnet. Die Ressourcennamen selbst können jedoch eindeutige numerische Ressourcen-IDs haben, die jedes Objekt in der Hierarchie identifizieren. In diesen Fällen kann es sinnvoll sein, den Ressourcennamen zu parsen, um diese Ressourcen-IDs zu extrahieren und eine neue zusammenzustellen.

Sehen wir uns beispielsweise den Ressourcennamen AdGroupAd aus der vorherigen Tabelle an:

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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