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 |
|
||||||
Identyfikatory kolekcji |
|
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
:
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.