Nazwy zasobów

Hierarchia nazw

Nazwy zasobów używanych w interfejsie Google Ads API są hierarchiczne i odzwierciedlają organizację elementów w Google Ads. Prawie wszystkie zasoby są podrzędnymi zasobami zasobu Customer, co odzwierciedla fakt, że prawie każde wywołanie interfejsu API musi być kierowane do konkretnego konta Google Ads. Na przykład kampanie, grupy reklam, reklamy i słowa kluczowe są podrzędnymi zasobami 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

Identyfikatory zasobów

W interfejsie API elementy Google Ads (klienci, kampanie itp.) są określane za pomocą nazw zasobów. Pamiętaj jednak, że same nazwy zasobów mogą mieć unikalne liczbowe identyfikatory zasobów, które identyfikują każdy obiekt w hierarchii. W takich przypadkach warto przeanalizować nazwę zasobu, aby wyodrębnić z niej identyfikatory zasobów i utworzyć nowy.

Na przykład zobacz nazwę zasobu AdGroupAd z poprzedniej tabeli:

customers/1234567890/adGroupAds/54321098765~2109876543210

Można go podzielić na poszczególne identyfikatory zasobów (oddzielone identyfikatorami kolekcji) w ten sposób:

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

Analizowanie poszczególnych identyfikatorów umożliwia wyprowadzanie nowych nazw zasobów, aby odwoływać się do klienta reklamy grupy reklam (customers/1234567890) lub grupy reklam (customers/1234567890/adGroupAds/54321098765).

Identyfikatory udostępnionych obiektów

Większość obiektów w interfejsie API jest powiązana z jednym konkretnym klientem Google Ads. Niektóre typy obiektów można jednak udostępniać na wielu kontach. W praktyce są to np. listy wykluczających słów kluczowych lub działania powodujące konwersję w wielu kontach, które są zwykle tworzone przez menedżerów, a potem udostępniane wielu kontom klientów.

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

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

Załóżmy, że mamy konto menedżera 987-654-3210, które udostępnia działanie powodujące konwersję na różnych kontach klientom 123-456-7890:

Diagram pokazujący związek nazw zasobów z hierarchiami kont

Wywołanie interfejsu API na koncie menedżera w celu np. zaktualizowania okna konwersji obejmowanego przez działanie obejmowałoby odwołanie do udostępnionego obiektu za pomocą nazwy zasobu: customers/9876543210/conversionActions/257733534.

Wywołanie interfejsu API na koncie klienta w celu włączenia używania współdzielonego działania powodującego konwersję odwołuje się do niego za pomocą nazwy zasobu: customers/1234567890/conversionActions/257733534.

Jest to to samo podstawowe działanie powodujące konwersję, ale jego nazwa zasobu jest względna w stosunku do konta, na którym jest ono dostępne.