Hierarchia nazw
Nazwy zasobów używane w interfejsie Google Ads API są hierarchiczne i odzwierciedlają strukturę jednostek w Google Ads. Prawie wszystkie zasoby są podzasobami
zasobu Customer
, co oznacza, ż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ą podzasobami głównego zasobu klienta.
| Zasób | Nazwa zasobu |
|---|---|
| Klient | customers/1234567890
|
| Kampania | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Identyfikatory zasobów
Jednostki Google Ads (klienci, kampanie itp.) są w interfejsie API określane za pomocą nazw zasobów. Warto jednak pamiętać, że nazwy zasobów mogą mieć unikalne numeryczne identyfikatory zasobów, które identyfikują każdy obiekt w hierarchii. W takich przypadkach może się przydać przeanalizowanie nazwy zasobu, aby wyodrębnić te identyfikatory zasobów i utworzyć nowy.
Na przykład przyjrzyj się nazwie zasobu AdGroupAd z poprzedniej tabeli:
customers/1234567890/adGroupAds/54321098765~2109876543210
Można ją podzielić na poszczególne identyfikatory zasobów (oddzielone identyfikatorami kolekcji) w ten sposób:
| Elementy nazwy zasobu | |||||||
|---|---|---|---|---|---|---|---|
| Identyfikatory zasobów |
|
||||||
| Identyfikatory kolekcji |
|
||||||
Analizowanie poszczególnych identyfikatorów pozwala uzyskać nowe nazwy zasobów, które odwołują się do
klienta reklamy w grupie reklam (customers/1234567890) lub do jej 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ę 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 będą się różnić w zależności od tego, na które konto 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ę dla wielu kont jednemu ze swoich kont klientów 123-456-7890:
Wywołanie interfejsu API na koncie menedżera, aby na przykład zaktualizować okres ważności konwersji, będzie odwoływać się do obiektu udostępnionego za pomocą nazwy zasobu: customers/9876543210/conversionActions/257733534.
Wywołanie interfejsu API na koncie klienta , aby wyrazić zgodę na korzystanie z udostępnionego działania powodującego konwersję, będzie odwoływać 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.