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 Unterressourcen der Customer Ressource. Das liegt daran, dass fast jeder API-Aufruf auf ein bestimmtes Search Ads 360-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind beispielsweise Unterressourcen einer Stammkundenressource.

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

Ressourcen-IDs

Auf Entitäten der Search Ads 360 Reporting API (Kunden, Kampagnen usw.) wird in der gesamten API mit ihren Ressourcennamen verwiesen. Die Ressourcen namen selbst können jedoch eindeutige numerische Ressourcen- IDs haben, die jedes Objekt in der Hierarchie identifizieren. 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

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

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

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