Hierarchia nazw
Nazwy zasobów używane w interfejsie Search Ads 360 Reporting API mają charakter hierarchiczny i odzwierciedlają organizację elementów w Search Ads 360. 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 Search Ads 360. 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
Do elementów interfejsu Search Ads 360 Reporting API (klientów, kampanii itp.) służą nazwy zasobów w interfejsie API. 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).