Method: accountTypes.accounts.partnerLinks.search

搜索指定账号的所有合作伙伴链接。

授权标头：

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

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

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

可选。过滤字符串。所有字段都需要位于每个条件的左侧（例如：partnerLinkId = 123456789）。

支持的操作：

  • AND
  • =
  • !=

支持的字段：

  • partnerLinkId
  • owningAccount.account_type
  • owningAccount.account_id
  • partnerAccount.account_type
  • partnerAccount.account_id

示例：owningAccount.account_type = "GOOGLE_ADS" OR partnerAccount.account_id = 987654321

请求正文

请求正文必须为空。

响应正文

来自 SearchPartnerLinksRequest 的回答。

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

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

string

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

授权范围

需要以下 OAuth 作用域：

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