Nazwy zasobów

Hierarchia nazw

Nazwy zasobów używane w interfejsie Search Ads 360 Reporting API są hierarchiczne i odzwierciedlają strukturę jednostek w Search Ads 360. Prawie wszystkie zasoby są podzasobami zasobu Customer , co oznacza, że prawie każde wywołanie interfejsu API musi być kierowane na konkretne konto Search Ads 360. 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 interfejsu Search Ads 360 Reporting API (klienci, kampanie itp.) są w całym interfejsie API określane 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 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
Identyfikator klienta:
"1234567890"
Identyfikator grupy reklam:
"54321098765"
Identyfikator reklamy w grupie reklam:
"2109876543210"
Identyfikatory kolekcji
"customers"
"adGroupAds"

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).