Hierarchia nazw
Nazwy zasobów używane w interfejsie Google Ads API mają charakter hierarchiczny i odzwierciedlają organizację elementów w Google Ads. Niemal wszystkie zasoby to zasoby podrzędne zasobu Customer, co odzwierciedla fakt, że niemal każde wywołanie interfejsu API musi być kierowane na określone konto Google Ads. Na przykład kampanie, grupy reklam, reklamy i słowa kluczowe to zasoby podrzędne 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
Podmioty Google Ads (klienci, kampanie itp.) są oznaczane w interfejsie API za pomocą nazw zasobów. Warto jednak pamiętać, ż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ć identyfikatory i utworzyć nowe.
Przyjrzyj się na przykład nazwie zasobu AdGroupAd z poprzedniej tabeli:
customers/1234567890/adGroupAds/54321098765~2109876543210
Możesz ją podzielić 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 uzyskanie nowych nazw zasobów, aby odwoływać się do klienta reklamy w grupie reklam (customers/1234567890) lub 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 mogą być współużytkowane przez wiele kont. W praktyce są to listy wykluczających słów kluczowych lub działania powodujące konwersje 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ą 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 (123-456-7890) klienta:
Wywołanie interfejsu API na koncie menedżera w celu np. zaktualizowania okresu ważności działania powodującego konwersję spowoduje odwoływanie się do udostępnionego obiektu z użyciem 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, że będzie ono korzystać z nazwy zasobu: customers/1234567890/conversionActions/257733534.
Jest to podstawowe działanie powodujące konwersję, ale jego nazwa zasobu jest powiązana z kontem, za pomocą którego uzyskano dostęp.