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 na konkretne konto 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 do elementów Google Ads (klientów, kampanii itp.) odwołuje się 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.
Sprawdź na przykład 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 akcję odwołuje się 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.