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 Unterressourcen
der Customer
Ressource. Das liegt daran, dass fast jeder API-Aufruf auf ein
bestimmtes Google Ads-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind beispielsweise Unterressourcen einer Stammressource vom Typ „Kunde“.
| Ressource | Ressourcenname |
|---|---|
| Kunde | customers/1234567890
|
| Campaign | 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 gesamten API mit ihren Ressourcennamen verwiesen. Die Ressourcen namen selbst können jedoch 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 einen neuen Ressourcennamen zu erstellen.
Sehen Sie sich beispielsweise den Ressourcennamen AdGroupAd aus der vorherigen Tabelle an:
customers/1234567890/adGroupAds/54321098765~2109876543210
Er kann wie folgt in seine einzelnen Ressourcen-IDs aufgeschlüsselt werden (getrennt durch Sammlungs-IDs) ):
| Komponenten des Ressourcennamens | |||||||
|---|---|---|---|---|---|---|---|
| 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 Anzeigengruppe (customers/1234567890/adGroupAds/54321098765) zu verweisen.
Kennungen freigegebener 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 Administratoren 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, das Verwaltungskonto 987-654-3210 gibt eine kontoübergreifende Conversion-Aktion für eines seiner Kundenkonten 123-456-7890 frei:
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 customers/9876543210/conversionActions/257733534 verwiesen.
Wenn Sie einen API-Aufruf an das Kundenkonto senden, um die freigegebene Conversion-Aktion zu verwenden, wird mit dem Ressourcennamen customers/1234567890/conversionActions/257733534 darauf verwiesen.
Es handelt sich um dieselbe Conversion-Aktion, aber der Ressourcenname ist relativ zum Konto, das für den Zugriff verwendet wird.