Hierarchia nazw
Nazwy zasobów używane w interfejsie Google Ads API mają strukturę hierarchiczną, która odzwierciedla organizację jednostek w Google Ads. Prawie wszystkie zasoby są podzasobami 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 zasobu klienta głównego.
| 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
Do jednostek Google Ads (klientów, kampanii itp.) odwołujemy się w API za pomocą nazw zasobów. Warto jednak pamiętać, że same nazwy zasobów mogą mieć unikalne numeryczne identyfikatory zasobów, które identyfikują każdy obiekt w hierarchii. W takich przypadkach może być przydatne przeanalizowanie nazwy zasobu w celu wyodrębnienia tych identyfikatorów zasobów i utworzenia nowego.
Na przykład sprawdź AdGroupAd nazwę zasobu z poprzedniej tabeli:
customers/1234567890/adGroupAds/54321098765~2109876543210
Można go podzielić na poszczególne identyfikatory zasobów (rozdzielone identyfikatorami kolekcji) w ten sposób:
| Składniki nazwy zasobu | |||||||
|---|---|---|---|---|---|---|---|
| Identyfikatory zasobów |
|
||||||
| Identyfikatory kolekcji |
|
||||||
Analizowanie poszczególnych identyfikatorów umożliwia uzyskanie nowych nazw zasobów, do których można się odwoływać w przypadku klienta reklamy w grupie reklam (customers/1234567890) lub grupy reklam (customers/1234567890/adGroupAds/54321098765).
Identyfikatory obiektów udostępnionych
Większość obiektów w interfejsie API jest powiązana z jednym konkretnym klientem Google Ads. Istnieją jednak typy obiektów, które można udostępniać na wielu kontach. W praktyce są to np. listy wykluczających słów kluczowych lub działania powodujące konwersję na różnych kontach, które są zwykle tworzone przez menedżerów, a następnie udostępniane wielu kontom klientów.
Nazwy zasobów takich obiektów będą się różnić w zależności od konta, na które wysyłasz wywołanie interfejsu API.
Przykład: działania powodujące konwersje dla wielu kont
Załóżmy, że konto menedżera 987-654-3210 udostępnia działanie powodujące konwersję na wielu kontach jednemu ze swoich kont klienta 123-456-7890:
Wywołanie interfejsu API na koncie menedżera, np. w celu zaktualizowania okresu wstecznego działania powodującego konwersję, będzie odwoływać się do udostępnionego obiektu za pomocą nazwy zasobu:customers/9876543210/conversionActions/257733534
Wywołanie interfejsu API na koncie klienta w celu wyrażenia zgody na używanie udostępnionego działania powodującego konwersję odwoływałoby się do niego za pomocą nazwy zasobu: customers/1234567890/conversionActions/257733534.
Jest to to samo działanie powodujące konwersję, ale jego nazwa zasobu jest względna w stosunku do konta używanego do uzyskiwania do niego dostępu.