30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

API Reference

To dokumentacja interfejsu API jest uporządkowana według typu zasobu. Każdy typ zasobu ma co najmniej 1 reprezentację danych i co najmniej 1 metodę.

Konwersja

Szczegółowe informacje o zasobach konwersji znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względne wobec https://www.googleapis.com/doubleclicksearch/v2, o ile nie zaznaczono inaczej
pobierz	`GET /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion`	Pobiera listę konwersji z konta wyszukiwarki w DoubleClick Search. Wymagane parametry zapytania: `endDate`, `rowCount`, `startDate`, `startRow`
getByCustomerId	`GET /customer/customerId/conversion`	Pobiera listę konwersji z konta wyszukiwarki DoubleClick Search przy użyciu nowego identyfikatora klienta Search Ads 360. Wymagane parametry zapytania: `endDate`, `rowCount`, `startDate`, `startRow`
wstaw	`POST /conversion`	Wstawia grupę nowych konwersji do DoubleClick Search.
aktualizacja	`PUT /conversion`	Aktualizuje grupę konwersji w usłudze DoubleClick Search.
updateAvailability	`POST /conversion/updateAvailability`	Aktualizuje dostępność grupy aktywności Floodlight w usłudze DoubleClick Search.

Raporty

Szczegółowe informacje o zasobach raportów znajdziesz na stronie reprezentowania zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względne wobec https://www.googleapis.com/doubleclicksearch/v2, o ile nie zaznaczono inaczej
generate	`POST /reports/generate`	Generuje i zwraca raport od razu.
pobierz	`GET /reports/reportId`	Ankiety na temat stanu żądania raportu.
getFile	`GET /reports/reportId/files/reportFragment`	Pobiera plik raportu zakodowany w UTF-8.
getIdMappingFile	`GET /agency/agencyId/advertiser/advertiserId/idmapping`	Pobiera plik CSV (zakodowany w formacie UTF-8) zawierający mapowania identyfikatorów między poprzednią a nową wersją Search Ads 360. W przypadku żądanego reklamodawcy plik zawiera wszystkie elementy podrzędne (np. konta wyszukiwarek, kampanie, grupy reklam itp.), które występują zarówno w poprzedniej, jak i w nowej wersji Search Ads 360.
prośba	`POST /reports`	Wstawia żądanie raportu do systemu raportowania.

SavedColumns

Szczegółowe informacje o zasobach znajdziesz na stronie reprezentacji zasobów.

Metoda	Żądanie HTTP	Opis
Identyfikatory URI względne wobec https://www.googleapis.com/doubleclicksearch/v2, o ile nie zaznaczono inaczej
list	`GET /agency/agencyId/advertiser/advertiserId/savedcolumns`	Pobierz listę zapisanych kolumn określonego reklamodawcy.