Namenshierarchie
Die in der Google Ads API verwendeten Ressourcennamen sind hierarchisch und spiegeln die Organisation der Entitäten in Google Ads wider. Fast alle Ressourcen sind Unterressourcen der Ressource Customer
. Das spiegelt auch die Tatsache wider, dass fast jeder API-Aufruf auf ein bestimmtes Google Ads-Konto ausgerichtet sein muss. Beispielsweise sind Kampagnen, Anzeigengruppen, Anzeigen und Keywords untergeordnete Ressourcen 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
Auf Google Ads-Entitäten (Kunden, Kampagnen usw.) wird in der API mit ihren Ressourcennamen verwiesen. Allerdings können die Ressourcennamen selbst eindeutige numerische Ressourcen-IDs haben, die jedes Objekt in der Hierarchie identifizieren. In diesen Fällen kann es hilfreich 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 folgendermaßen in ihre einzelnen Ressourcen-IDs aufgeschlüsselt werden, die durch Sammlungs-IDs getrennt sind:
Komponenten für Ressourcennamen | |||||||
---|---|---|---|---|---|---|---|
Ressourcen-IDs |
|
||||||
Sammlungs-IDs |
|
Durch das Parsen der einzelnen IDs können Sie neue Ressourcennamen ableiten, um auf den Kunden der Anzeigengruppenanzeige (customers/1234567890
) oder die zugehörige Anzeigengruppe (customers/1234567890/adGroupAds/54321098765
) zu verweisen.
IDs gemeinsam genutzter Objekte
Die meisten Objekte in der API sind einem einzelnen Google Ads-Kunden zugeordnet. Es gibt jedoch einige Objekttypen, die von mehreren Konten gemeinsam genutzt werden können. In der Praxis sind das beispielsweise Listen mit auszuschließenden Keywords oder kontoübergreifende Conversion-Aktionen, die normalerweise von Managern erstellt und dann für viele Kundenkonten freigegeben werden.
Die Ressourcennamen solcher Objekte unterscheiden sich je nachdem, an welches Konto Sie einen API-Aufruf senden.
Beispiel: Kontoübergreifende Conversion-Aktionen
Angenommen, Sie haben das Verwaltungskonto 987-654-3210
, das eine kontoübergreifende Conversion-Aktion mit einem seiner Kundenkonten 123-456-7890
teilt:
Wird ein API-Aufruf an das Verwaltungskonto gesendet, um beispielsweise das Lookback-Window der Conversion-Aktion zu aktualisieren, wird mithilfe des Ressourcennamens customers/9876543210/conversionActions/257733534
auf das gemeinsam genutzte Objekt verwiesen.
Wenn Sie einen API-Aufruf an das Kundenkonto senden, um die Verwendung der freigegebenen Conversion-Aktion zu aktivieren, wird mithilfe des Ressourcennamens customers/1234567890/conversionActions/257733534
darauf verwiesen.
Dies ist dieselbe zugrunde liegende Conversion-Aktion, aber ihr Ressourcenname bezieht sich auf das Konto, mit dem auf sie zugegriffen wurde.