Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Nazwy zasobów

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Hierarchia nazw

Nazwy zasobów używane w interfejsie Google Ads API mają hierarchiczną strukturę, która odzwierciedla strukturę jednostek w Google Ads. Niemal wszystkie zasoby stanowią 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 stanowią zasoby podrzędne głównego zasobu klienta.

Zasób Nazwa zasobu
Klient customers/1234567890
Kampania customers/1234567890/campaigns/8765432109
Grupa reklam customers/1234567890/adGroups/54321098765
ReklamaGrupa reklam customers/1234567890/adGroupAds/54321098765~2109876543210

Identyfikatory zasobów

Elementy Google Ads (klienci, kampanie itp.) są wskazywane przez nazwy zasobów interfejsu API. Warto jednak zauważyć, że same nazwy zasobów mogą mieć unikalne liczbowe identyfikatory identyfikatorów, które identyfikują poszczególne obiekty w hierarchii. W takich przypadkach warto przeanalizować nazwę zasobu, by wyodrębnić te identyfikatory 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 (rozdzielone identyfikatorami kolekcji) w ten sposób:

Komponenty nazwy zasobu
Identyfikatory zasobów
identyfikator klienta:
"1234567890"
identyfikator grupy reklam:
"54321098765"
identyfikator reklamy z grupy reklam:
"2109876543210"
Identyfikatory kolekcji
"customers"
"adGroupAds"

Analiza poszczególnych identyfikatorów pozwala uzyskać nowe nazwy zasobów, które mogą się odwoływać do reklamy grupy 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ązanych z jednym konkretnym klientem Google Ads. Istnieją jednak typy obiektów, które można udostępniać między wieloma kontami. 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 i udostępniane wielu kontom klientów.

Nazwy zasobów takich obiektów różnią się w zależności od konta, na które 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 dzieli działanie powodujące konwersję dla wielu kont z jednym z kont klientów 123-456-7890:

Schemat przedstawiający powiązanie nazw zasobów z hierarchiami konta.

Wywołanie interfejsu API konta menedżera, aby na przykład zaktualizować działanie powodujące konwersję, może odwoływać się do udostępnianego obiektu za pomocą nazwy zasobu: customers/9876543210/conversionActions/257733534.

Wywołanie interfejsu API kierowane do konta klienta, umożliwiające włączenie korzystania z udostępnianego działania powodującego konwersję, będzie się odwoływać 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 wobec konta używanego do uzyskania do niego dostępu.