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.
Search Ads 360 Reporting API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Search Ads 360 API umożliwia programistom automatyczne pobieranie raportów z Search Ads 360.
Usługa: searchads360.googleapis.com
W celu wywołania tej usługi zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywołania tej usługi aplikacja musi używać własnych bibliotek, podczas tworzenia żądań do interfejsu API używaj podanych niżej informacji.
Dokument opisujący
Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i korzystanie z nich. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:
Punkt końcowy usługi
Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy, a wszystkie poniższe identyfikatory URI odnoszą się do niego:
https://searchads360.googleapis.com
| Metody |
listAccessibleCustomers |
GET /v0/customers:listAccessibleCustomers
Zwraca nazwy zasobów klientów, do których ma bezpośredni dostęp użytkownik uwierzytelniający połączenie. |
| Metody |
get |
GET /v0/{resourceName=customers/*/customColumns/*}
Zwraca szczegółowo żądaną kolumnę niestandardową. |
list |
GET /v0/customers/{customerId}/customColumns
Zwraca pełne szczegóły wszystkie kolumny niestandardowe powiązane z klientem. |
| Metody |
search |
POST /v0/customers/{customerId}/searchAds360:search
Zwraca wszystkie wiersze pasujące do wyszukiwanego hasła. |
searchStream |
POST /v0/customers/{customerId}/searchAds360:searchStream
Zwraca wszystkie wiersze pasujące do zapytania w strumieniu wyszukiwania. |
| Metody |
get |
GET /v0/{resourceName=searchAds360Fields/*}
Zwraca tylko żądane pole. |
search |
POST /v0/searchAds360Fields:search
Zwraca wszystkie pola pasujące do wyszukiwanego zapytania. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThe Search Ads 360 API enables developers to automate report downloads from Search Ads 360.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use Google-provided client libraries or their own libraries to interact with the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides access to various resources such as customers, custom columns, and Search Ads 360 data.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data using methods like \u003ccode\u003elistAccessibleCustomers\u003c/code\u003e, \u003ccode\u003esearch\u003c/code\u003e, and \u003ccode\u003esearchStream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDetailed information about API resources and methods is available through the provided links and discovery document.\u003c/p\u003e\n"]]],["The Search Ads 360 API enables automated report downloading, utilizing `searchads360.googleapis.com`. Key actions include: retrieving accessible customer resource names via `listAccessibleCustomers`; getting detailed custom columns with `get` and `list`; searching for rows matching queries through `search` and `searchStream`; and fetching field details via `get` and `search`. It is recommended that developers use Google-provided client libraries, or utilize the specified discovery document and service endpoint for custom libraries.\n"],null,["# Search Ads 360 Reporting API\n\nThe Search Ads 360 API allows developers to automate downloading reports from Search Ads 360.\n\n- [REST Resource: v0.customers](#v0.customers)\n- [REST Resource: v0.customers.customColumns](#v0.customers.customColumns)\n- [REST Resource: v0.customers.searchAds360](#v0.customers.searchAds360)\n- [REST Resource: v0.searchAds360Fields](#v0.searchAds360Fields)\n\nService: searchads360.googleapis.com\n------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://searchads360.googleapis.com/$discovery/rest?version=v0\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://searchads360.googleapis.com`\n\nREST Resource: [v0.customers](/search-ads/reporting/api/reference/rest/v0/customers)\n------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| [listAccessibleCustomers](/search-ads/reporting/api/reference/rest/v0/customers/listAccessibleCustomers) | `GET /v0/customers:listAccessibleCustomers` Returns resource names of customers directly accessible by the user authenticating the call. |\n\nREST Resource: [v0.customers.customColumns](/search-ads/reporting/api/reference/rest/v0/customers.customColumns)\n----------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| [get](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/get) | `GET /v0/{resourceName=customers/*/customColumns/*}` Returns the requested custom column in full detail. |\n| [list](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/list) | `GET /v0/customers/{customerId}/customColumns` Returns all the custom columns associated with the customer in full detail. |\n\nREST Resource: [v0.customers.searchAds360](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360)\n--------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [search](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360/search) | `POST /v0/customers/{customerId}/searchAds360:search` Returns all rows that match the search query. |\n| [searchStream](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360/searchStream) | `POST /v0/customers/{customerId}/searchAds360:searchStream` Returns all rows that match the search stream query. |\n\nREST Resource: [v0.searchAds360Fields](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields)\n------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/get) | `GET /v0/{resourceName=searchAds360Fields/*}` Returns just the requested field. |\n| [search](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/search) | `POST /v0/searchAds360Fields:search` Returns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details). |"]]
