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 |
|
||||||
Sammlungs-IDs |
|
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.