Method: accountTypes.accounts.partnerLinks.search

搜索与给定账号的所有合作伙伴关联。

授权标头：

此方法支持以下可选标头，用于定义 API 如何授权请求访问：

  • login-account：（可选）凭据的 Google 账号是用户的账号的资源名称。如果未设置，则默认为请求的账号。格式： accountTypes/{loginAccountType}/accounts/{loginAccountId}

HTTP 请求

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/partnerLinks:search

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。用于搜索合作伙伴关联的账号。如果未指定 filter，则系统会返回此账号是 owningAccount 或 partnerAccount 的所有合作伙伴关联。

格式：accountTypes/{accountType}/accounts/{account}

查询参数

参数
pageSize

integer

要返回的合作伙伴关联数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 10 个合作伙伴关联。最大值为 100；大于 100 的值将被强制转换为 100。
pageToken

string

从之前的 partnerLinks.search 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 partnerLinks.search 的所有其他参数必须与提供页面令牌的调用匹配。
filter

string

可选。一个过滤条件字符串。所有字段都需要位于每个条件的左侧（例如：partner_link_id = 123456789）。字段必须使用全驼峰式大小写或全蛇形命名法指定。请勿混用驼峰式大小写和蛇形命名法。

支持的操作：

  • AND
  • =
  • !=

支持的字段：

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

示例：owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

请求正文

请求正文必须为空。

响应正文

来自 SearchPartnerLinksRequest 的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "partnerLinks": [
    {
      object (PartnerLink)
    }
  ],
  "nextPageToken": string
}
字段
nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/datamanager
  • https://www.googleapis.com/auth/datamanager.partnerlink