Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Ressourcennamen

Namenshierarchie

Die in der Google Ads API verwendeten Ressourcennamen sind hierarchisch angeordnet und spiegeln die Entitäten in Google Ads wider. Fast alle Ressourcen sind Unterressourcen der Ressource Customer. Das bedeutet, dass fast jeder API-Aufruf auf ein bestimmtes Google Ads-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind beispielsweise alle 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

Google Ads-Entitäten (Kunden, Kampagnen usw.) werden in der gesamten API durch ihre Ressourcennamen bezeichnet. Beachten Sie jedoch, dass die Ressourcennamen selbst eindeutige numerische Ressourcen-IDs haben können, 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 ID zusammenzustellen.

Prüfe beispielsweise den Ressourcennamen AdGroupAd aus der vorherigen Tabelle:

customers/1234567890/adGroupAds/54321098765~2109876543210

Dies kann folgendermaßen in die einzelnen Ressourcen-IDs unterteilt werden (getrennt durch die Sammlungs-IDs):

Komponentennamen
Ressourcen-IDs
Kundennummer:
"1234567890"
Anzeigengruppen-ID
"54321098765"
Anzeigengruppen-ID der Anzeigengruppe:
"2109876543210"
Sammlungs-IDs
"customers"
"adGroupAds"

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

Kennungen von gemeinsam genutzten Objekten

Die meisten Objekte in der API sind mit einem bestimmten Google Ads-Kunden verknüpft. Es gibt jedoch einige Objekttypen, die von mehreren Konten gemeinsam genutzt werden können. Das sind praktisch Listen mit auszuschließenden Keywords oder kontoübergreifende Conversion-Aktionen, die normalerweise von Verwaltungskonten erstellt und dann für viele Kundenkonten freigegeben werden.

Die Ressourcennamen dieser 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:

Diagramm: Beziehung von Ressourcennamen zu Kontohierarchien

Durch einen API-Aufruf an das Verwaltungskonto wird z. B. das Lookback-Window der Conversion-Aktion aktualisiert, das auf das freigegebene Objekt mit dem Ressourcennamen customers/9876543210/conversionActions/257733534 verweist.

Durch einen API-Aufruf an das Kundenkonto, um die gemeinsame Conversion-Aktion zu aktivieren, wird über den Ressourcennamen customers/1234567890/conversionActions/257733534 verwiesen.

Dies ist dieselbe Conversion-Aktion, deren Ressourcenname relativ zum Konto ist, das für den Zugriff verwendet wurde.