Nazwy zasobów

Hierarchia nazw

Nazwy zasobów używane w interfejsie Google Ads API są hierarchiczne i odzwierciedlają organizacji podmiotów w ramach Google Ads. Prawie wszystkie zasoby są zasobami podrzędnymi z Customer zasób, który odzwierciedla fakt, że prawie każde wywołanie interfejsu API musi być kierowane na konkretne konto Google Ads. Na przykład kampanie, grupy reklam, reklamy i słowa kluczowe to wszystkie zasoby podrzędne zasobu głównego klienta.

Zasób	Nazwa zasobu
Klient	customers/1234567890
Kampania	customers/1234567890/campaigns/8765432109
Grupa reklam	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Ważne: interfejs Google Ads API korzysta względne nazwy zasobów (a nie pełne nazwy zasobów jak niektóre inne interfejsy API Google).

Identyfikatory zasobów

Podmioty Google Ads (klienci, kampanie itp.) są wskazywane przez ich zasoby w całym interfejsie API. Warto jednak zauważyć, że zasób Same nazwy mogą mieć unikalne zasoby liczbowe identyfikatory, które określają, dla każdego obiektu w hierarchii. W takich przypadkach warto przeanalizować nazwę zasobu, aby wyodrębnić te identyfikatory i utworzyć nowy.

Sprawdź na przykład nazwę zasobu AdGroupAd z poprzedniej tabeli:

customers/1234567890/adGroupAds/54321098765~2109876543210

Można ją podzielić na poszczególne identyfikatory zasobów (rozdzielone znakiem identyfikatory kolekcji) w następujący sposób:

Komponenty nazwy zasobu
Identyfikatory zasobów	identyfikator klienta: "1234567890" identyfikator grupy reklam: "54321098765" identyfikator reklamy grupy reklam: "2109876543210"
Identyfikatory kolekcji	"customers" "adGroupAds"

Analiza poszczególnych identyfikatorów umożliwia generowanie nowych nazw zasobów, do których można się odwoływać klient reklamy z grupy reklam (customers/1234567890) lub jego grupa reklam (customers/1234567890/adGroupAds/54321098765).

Ważne: nazwy zasobów w treści żądań i odpowiedzi JSON są odwoływane pole resourceName, a nie pole name. jak w niektórych innych interfejsach API Google Cloud. Wiele elementów Google Ads ma nazwy (campaign.Name, adGroup.Name itp.), więc resourceName jest używany w celu uniknięcia kolizji z istniejącymi nazwami obiektów.

Identyfikatory udostępnionych obiektów

Większość obiektów w interfejsie API jest powiązana z jedną konkretną usługą Google Ads klienta. Istnieją jednak typy obiektów, które mogą być współużytkowane przez wiele kont. W praktyce są to np. wykluczające słowa kluczowe list lub dla wielu kont działania powodujące konwersję, zwykle tworzone przez menedżerów, a następnie udostępniane wielu kontom klientów.

Nazwy zasobów takich obiektów różnią się w zależności od tego, do którego wysyłasz wywołanie interfejsu API.

Przykład: działania powodujące konwersje dla wielu kont

Załóżmy, że mamy konto menedżera 987-654-3210, które korzysta z wielu kont działanie powodujące konwersję na jednym z kont klienta 123-456-7890:

Wywoływanie interfejsu API na koncie menedżera w celu np. zaktualizowania konwersji okres ważności działania odwołałby się do udostępnionego obiektu za pomocą nazwy zasobu: customers/9876543210/conversionActions/257733534

Wywoływanie interfejsu API na koncie klienta w celu wyrażenia zgody na korzystanie z udostępnionych działanie powodujące konwersję odwołałoby się do niego za pomocą nazwy zasobu: customers/1234567890/conversionActions/257733534

To jest to samo bazowe działanie powodujące konwersję, ale jego nazwa zasobu jest względna z kontem, za pomocą którego uzyskano do niego dostęp.