Method: searchAds360Fields.search
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
POST https://searchads360.googleapis.com/v0/searchAds360Fields:search
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"query": string,
"pageToken": string,
"pageSize": integer
} |
字段 |
query |
string
必需。查询字符串。
|
pageToken |
string
要检索的页面的令牌。如果未指定,则返回第一页的结果。使用上一个响应中从 nextPageToken 获取的值来请求下一页结果。
|
pageSize |
integer
要在单个页面中检索的元素数量。如果请求的网页太大,服务器可能会决定进一步限制返回的资源数量。
|
响应正文
JSON 表示法 |
{
"results": [
{
object (SearchAds360Field )
}
],
"nextPageToken": string,
"totalResultsCount": string
} |
字段 |
results[] |
object (SearchAds360Field )
与查询匹配的字段列表。
|
nextPageToken |
string
用于检索下一页结果的分页令牌。将此字符串的内容作为下一个请求的 pageToken 属性传递。系统不会为最后一页返回 nextPageToken 。
|
totalResultsCount |
string (int64 format)
与查询匹配的结果的总数(忽略 LIMIT 子句)。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/doubleclicksearch
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-04-02。
[null,null,["最后更新时间 (UTC):2025-04-02。"],[[["\u003cp\u003eSearch and retrieve SearchAds360 fields that match a specific query using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequests can specify query parameters for filtering, pagination, and the number of results to return.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a list of matching fields, pagination information, and the total number of results.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003ePotential errors include AuthenticationError, AuthorizationError, HeaderError, InternalError, QueryError, QuotaError, and RequestError.\u003c/p\u003e\n"]]],["This document details how to search for fields using the Search Ads 360 API. A `POST` request is sent to `https://searchads360.googleapis.com/v0/searchAds360Fields:search`, including a JSON body with a `query` string, optional `pageToken`, and `pageSize`. The response includes a list of matching field `results`, a `nextPageToken` for pagination, and a `totalResultsCount`. This operation requires the `https://www.googleapis.com/auth/doubleclicksearch` OAuth scope. Several errors such as `AuthenticationError` and `QuotaError` can be thrown.\n"],null,["# Method: searchAds360Fields.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchSearchAds360FieldsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details).\n\nList of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()\n\n### HTTP request\n\n`POST https://searchads360.googleapis.com/v0/searchAds360Fields:search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"query\": string, \"pageToken\": string, \"pageSize\": integer } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `string` Required. The query string. |\n| `pageToken` | `string` Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from `nextPageToken` in the previous response in order to request the next page of results. |\n| `pageSize` | `integer` Number of elements to retrieve in a single page. When too large a page is requested, the server may decide to further limit the number of returned resources. |\n\n### Response body\n\nResponse message for [SearchAds360FieldService.SearchSearchAds360Fields](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/search#google.ads.searchads360.v0.services.SearchAds360FieldService.SearchSearchAds360Fields).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"results\": [ { object (/search-ads/reporting/api/reference/rest/v0/searchAds360Fields#SearchAds360Field) } ], \"nextPageToken\": string, \"totalResultsCount\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `results[]` | `object (`[SearchAds360Field](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields#SearchAds360Field)`)` The list of fields that matched the query. |\n| `nextPageToken` | `string` Pagination token used to retrieve the next page of results. Pass the content of this string as the `pageToken` attribute of the next request. `nextPageToken` is not returned for the last page. |\n| `totalResultsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Total number of results that match the query ignoring the LIMIT clause. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclicksearch`"]]