Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Dołącz do grupy dyskusyjnej Google searchads-api-announcements, aby na bieżąco otrzymywać informacje o nadchodzących ulepszeniach i wersjach.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie zakładamy, że znasz już przewodniki dla programistów dotyczące projektowania zorientowanego na zasoby i nazwisk zasobów, a także uzupełniające je szczegółowe informacje o wdrożeniu interfejsu Search Ads 360 Reporting API.
.
Projektowanie zorientowane na zasoby
Ogólnie rzecz biorąc, interfejs Search Ads 360 Reporting API jest oparty na zasobach i modelowany jako zbioryzasobów (rzeczownik interfejsu API).
Odwoływanie się do zasobów odbywa się za pomocą ich nazw i manipulacja przy użyciu niewielkiego zestawu metod (nazywanych też czasownikami lub operacjami).
Te nazwy zasobów i metody w połączeniu z określonym prefiksem wersji interfejsu API składają się na adresy URL interfejsu REST.
Na przykład adres URL poniżej można podzielić na te elementy zgodnie z tabelą:
Wszystkie adresy URL REST dla konkretnej wersji interfejsu API (np. v0) mają wspólny prefiks wersji interfejsu API. Nazwa zasobu i metoda razem określają, która usługa interfejsu API jest wywoływana.
Interfejs Search Ads 360 Reporting API intensywnie korzysta z metod niestandardowych, w przeciwieństwie do większości tradycyjnych interfejsów API REST, które korzystają ze standardowych metod REST, takich jak list i get. Interfejs Search Ads 360 Reporting API zawiera 2 metody niestandardowe: search i searchStream.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["The Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated."],["The API primarily uses custom methods like `search` and `searchStream` instead of traditional REST methods."],["API endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation."],["The guide's examples demonstrate API calls using HTTP, with further instructions available for using the `curl` command-line utility."],["Developers should be familiar with Resource Oriented Design and Resource Names before using this API."]]],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]
