Ressourcennamen

Namenshierarchie

Die in der Google Ads API verwendeten Ressourcennamen sind hierarchisch aufgebaut, was die Organisation der Entitäten in Google Ads widerspiegelt. Nahezu alle Ressourcen sind Unterressourcen der Ressource Customer. Dies spiegelt wider, dass fast jeder API-Aufruf auf ein bestimmtes Google Ads-Konto ausgerichtet sein muss. Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind z. B. Unterressourcen einer Stammkundenressource.

Ressource	Ressourcenname
Kunde	customers/1234567890
Kampagne	customers/1234567890/campaigns/8765432109
AdGroup	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Wichtiger Hinweis :Die Google Ads API verwendet relative Ressourcennamen (und nicht wie einige andere Google APIs vollständige Ressourcennamen).

Ressourcen-IDs

Google Ads-Entitäten (Kunden, Kampagnen usw.) werden in der API über ihre Ressourcennamen referenziert. Die Ressourcennamen selbst können jedoch eindeutige numerische Ressourcen-IDs haben, mit denen jedes Objekt in der Hierarchie identifiziert werden kann. In diesen Fällen kann es nützlich 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 so in die einzelnen Ressourcen-IDs (durch Sammlungs-IDs getrennt) aufgeschlüsselt werden:

Komponenten des Ressourcennamens
Ressourcen-IDs	Kundennummer: "1234567890" Anzeigengruppen-ID: "54321098765" Anzeigen-ID der Anzeigengruppe: "2109876543210"
Sammlungs-IDs	"customers" "adGroupAds"

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

Wichtiger Hinweis: Auf Ressourcennamen in JSON-Anfrage- und -Antworttexten wird wie in einigen anderen Google Cloud APIs vom Feld resourceName und nicht vom Feld name verwiesen. Viele Google Ads-Entitäten haben selbst Namensattribute (campaign.Name, adGroup.Name usw.). resourceName wird daher verwendet, um Konflikte mit vorhandenen Objektnamen zu vermeiden.

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 z. B. Listen mit auszuschließenden Keywords oder kontoübergreifende Conversion-Aktionen, die normalerweise 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, wir haben das Verwaltungskonto 987-654-3210, über das eine kontoübergreifende Conversion-Aktion mit einem seiner Kundenkonten 123-456-7890 geteilt wird:

Wenn Sie einen API-Aufruf an das Verwaltungskonto senden, um beispielsweise das Lookback-Window der Conversion-Aktion zu aktualisieren, wird unter Verwendung des Ressourcennamens customers/9876543210/conversionActions/257733534 auf das gemeinsam genutzte Objekt verwiesen.

Ein API-Aufruf an das Kundenkonto, um der Verwendung der freigegebenen Conversion-Aktion zu zustimmen, würde anhand des Ressourcennamens customers/1234567890/conversionActions/257733534 darauf verweisen.

Dies ist dieselbe zugrunde liegende Conversion-Aktion, aber ihr Ressourcenname bezieht sich auf das Konto, mit dem auf sie zugegriffen wurde.