Hierarchia nazw
Nazwy zasobów używane w interfejsie Search Ads 360 Reporting API są hierarchiczne i odzwierciedlają organizację elementów w Search Ads 360. Prawie wszystkie zasoby są podrzędnymi zasobami zasobu Customer, co oznacza, że prawie każde wywołanie interfejsu API musi być kierowane do konkretnego konta Search Ads 360. Na przykład kampanie, grupy reklam, reklamy i słowa kluczowe są podrzędnymi zasobami zasobu głównego klienta.
| 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
Elementy interfejsu Search Ads 360 Reporting API (klienci, kampanie itp.) są odwoływane za pomocą nazw zasobów w całym interfejsie API. Pamiętaj jednak, że same nazwy zasobów mogą mieć unikalne liczbowe identyfikatory zasobów, które identyfikują poszczególne obiekty w hierarchii. W takich przypadkach warto przeanalizować nazwę zasobu, aby wyodrębnić z niej identyfikatory zasobów i utworzyć nowy.
Sprawdź na przykład nazwę zasobu AdGroupAd z poprzedniej tabeli:
customers/1234567890/adGroupAds/54321098765~2109876543210
Można go podzielić na poszczególne identyfikatory zasobów (oddzielone identyfikatorami kolekcji) w ten sposób:
| Komponenty nazwy zasobu | |||||||
|---|---|---|---|---|---|---|---|
| Identyfikatory zasobów |
|
||||||
| Identyfikatory kolekcji |
|
||||||
Analizowanie poszczególnych identyfikatorów umożliwia wyprowadzanie nowych nazw zasobów, aby odwoływać się do klienta reklamy grupy reklam (customers/1234567890) lub grupy reklam (customers/1234567890/adGroupAds/54321098765).