Ressourcennamen

Namenshierarchie

Die in der Google Ads API verwendeten Ressourcennamen sind hierarchisch und spiegeln die Organisation von Rechtspersönlichkeiten in Google Ads. Fast alle Ressourcen sind Unterressourcen von Customer . Dies spiegelt die Tatsache wider, dass fast jeder API-Aufruf auf ein in einem bestimmten Google Ads-Konto. Beispiele: Kampagnen, Anzeigengruppen, Anzeigen und Keywords sind alle Unterressourcen einer Stammkundenressource.

Ressource	Ressourcenname
Kunde	customers/1234567890
Campaign	customers/1234567890/campaigns/8765432109
Anzeigengruppe	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Wichtiger Hinweis :In der Google Ads API werden relative Ressourcennamen (und keine vollständigen Ressourcennamen wie einige andere Google APIs).

Ressourcen-IDs

Auf Google Ads-Entitäten (Kunden, Kampagnen usw.) wird über ihre Ressource verwiesen in der gesamten API verwenden. Es ist jedoch wichtig zu beachten, dass die Ressource können in den Namen selbst eine eindeutige numerische Ressource enthalten. IDs zur Identifizierung jedes Objekt in der Hierarchie. In diesen Fällen kann es hilfreich sein, Ressourcenname, 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

Dieser kann in die einzelnen Ressourcen-IDs aufgeschlüsselt werden (getrennt durch Sammlungs-IDs) wie folgt:

Komponenten für Ressourcennamen
Ressourcen-IDs	Kundennummer: "1234567890" Anzeigengruppen-ID: "54321098765" Anzeigengruppen-Anzeigen-ID: "2109876543210"
Sammlungs-IDs	"customers" "adGroupAds"

Durch das Parsen der einzelnen IDs können Sie neue Ressourcennamen als Referenz ableiten Der Kunde der Anzeige aus der Anzeigengruppe (customers/1234567890) oder die zugehörige Anzeigengruppe (customers/1234567890/adGroupAds/54321098765)

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

IDs gemeinsam genutzter Objekte

Die meisten Objekte in der API sind einem einzelnen Google Ads-Konto zugeordnet. Kunden. Es gibt jedoch einige Objekttypen, die zwischen mehrere Konten. In der Praxis sind dies beispielsweise ausschließende Keywords Listen oder kontoübergreifende Conversion-Aktionen, die normalerweise von einem Verwaltungskonto erstellt und dann für viele Kundenkonten freigegeben werden.

Die Ressourcennamen solcher Objekte unterscheiden sich je nachdem, an das Sie einen API-Aufruf senden.

Beispiel: Kontoübergreifende Conversion-Aktionen

Angenommen, Sie haben das Verwaltungskonto 987-654-3210 mit einem kontoübergreifenden Konto Conversion-Aktion mit einem ihrer Kundenkonten 123-456-7890:

Ein API-Aufruf an das Verwaltungskonto, um beispielsweise die Conversion zu aktualisieren Lookback-Window der Aktion würde über den Ressourcennamen auf das gemeinsam genutzte Objekt verweisen: customers/9876543210/conversionActions/257733534

Über einen API-Aufruf an das Kundenkonto, um die gemeinsame Nutzung zu aktivieren kann die Conversion-Aktion über den Ressourcennamen darauf verweisen: customers/1234567890/conversionActions/257733534

Dies ist dieselbe zugrunde liegende Conversion-Aktion, ihr Ressourcenname ist jedoch relativ mit dem Konto verknüpft sind, mit dem Sie darauf zugreifen.