Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Treten Sie der Google-Gruppe searchads-api-announcements bei, um über kommende Verbesserungen und Releases auf dem Laufenden zu bleiben.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
Search Ads 360 Reporting API-Entitäten (Kunden, Kampagnen usw.) werden in der API anhand ihrer Ressourcennamen referenziert. 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:
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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-26 (UTC)."],[],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]