Hierarchia nazw
Nazwy zasobów używane w interfejsie Google Ads API są hierarchiczne i odzwierciedlają organizację jednostek w Google Ads. Prawie wszystkie zasoby są zasobami podrzędnymi 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ą zasobami podrzędnymi głównego zasobu klienta.
| Zasób | Nazwa zasobu |
|---|---|
| Klient | customers/1234567890
|
| Priorytet | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Identyfikatory zasobów
Elementy Google Ads (klienty, kampanie itp.) są odwoływane za pomocą nazw zasobów w interfejsie API. 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 w celu wyodrębnienia identyfikatorów zasobów i utworzenia nowego.
Sprawdź na przykład nazwę zasobu AdGroupAd z poprzedniej tabeli:
customers/1234567890/adGroupAds/54321098765~2109876543210
Możesz podzielić te identyfikatory na poszczególne identyfikatory zasobów (rozdzielone identyfikatorami kolekcji) w ten sposób:
| Komponenty nazwy zasobu | |||||||
|---|---|---|---|---|---|---|---|
| Identyfikatory zasobów |
|
||||||
| Identyfikatory kolekcji |
|
||||||
Analiza poszczególnych identyfikatorów umożliwia generowanie nowych nazw zasobów, które odnoszą się do klienta reklamy (customers/1234567890) lub jej grupy reklam (customers/1234567890/adGroupAds/54321098765) w grupie reklam.
Identyfikatory udostępnionych obiektów
Większość obiektów w interfejsie API jest powiązana z jednym konkretnym klientem Google Ads. Istnieją jednak typy obiektów, które mogą być współużytkowane przez wiele kont. W praktyce są to np. listy wykluczających słów kluczowych lub działania powodujące konwersję dla wielu kont, które są 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 konta, 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 ma wspólne działanie powodujące konwersję dla wielu kont z jednym z kont klientów klienta 123-456-7890:
Wywołanie interfejsu API na koncie menedżera w celu np. zaktualizowania okresu ważności działania powodującego konwersję powodowałoby odwoływanie się do udostępnionego obiektu za pomocą nazwy zasobu: customers/9876543210/conversionActions/257733534.
Wywołanie interfejsu API konta klienta w celu wyrażenia zgody na korzystanie z udostępnionego działania powodującego konwersję spowoduje odwołanie do niego za pomocą nazwy zasobu: customers/1234567890/conversionActions/257733534.
Jest to to samo bazowe działanie powodujące konwersję, ale nazwa jego zasobu jest zależna od konta użytego do uzyskania do niego dostępu.