Ressourcennamen

Namenshierarchie

Die in der Google Ads API verwendeten Ressourcennamen sind hierarchisch und spiegeln die Organisation von Entitäten in Google Ads wider. Fast alle Ressourcen sind untergeordnete Ressourcen der Ressource Customer. Das spiegelt die Tatsache wider, dass fast jeder API-Aufruf auf ein bestimmtes Google Ads-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

Wichtig: In der Google Ads API werden relative Ressourcennamen verwendet (nicht wie bei einigen anderen Google APIs vollständige Ressourcennamen).

Ressourcen-IDs

Google Ads-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:

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.

Wichtiger Hinweis: Auf Ressourcennamen in JSON-Anfrage- und Antwortkörpern wird über das Feld resourceName verwiesen, nicht über das Feld name wie in einigen anderen Google Cloud APIs. Viele Google Ads-Entitäten haben selbst Namensattribute (campaign.Name, adGroup.Name usw.). Daher wird resourceName verwendet, um Überschneidungen mit vorhandenen Objektnamen zu vermeiden.

IDs für freigegebene Objekte

Die meisten Objekte in der API sind mit einem bestimmten Google Ads-Kunden verknüpft. Es gibt jedoch einige Objekttypen, die für mehrere Konten freigegeben werden können. In der Praxis sind das beispielsweise Listen mit auszuschließenden Keywords oder kontoübergreifende Conversion-Aktionen, die in der Regel von Verwaltungskonten 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, wir haben das Verwaltungskonto 987-654-3210, das eine kontoübergreifende Conversion-Aktion mit einem seiner Kundenkonten 123-456-7890 teilt:

Wenn Sie einen API-Aufruf an das Verwaltungskonto senden, um beispielsweise das Lookback-Window der Conversion-Aktion zu aktualisieren, wird auf das freigegebene Objekt mit dem Ressourcennamen verwiesen: customers/9876543210/conversionActions/257733534.

Wenn Sie die gemeinsame Conversion-Aktion aktivieren möchten, indem Sie einen API-Aufruf an das Kundenkonto senden, wird sie mit dem Ressourcennamen customers/1234567890/conversionActions/257733534 referenziert.

Es handelt sich um dieselbe zugrunde liegende Conversion-Aktion, der Ressourcenname ist jedoch relativ zum Konto, über das auf sie zugegriffen wird.