The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
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,[]]