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.