Method: accountTypes.accounts.partnerLinks.search

搜尋指定帳戶的所有合作夥伴連結。

Authorization 標頭：

這個方法支援下列選用標頭，可定義 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

要傳回的合作夥伴連結數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個合作夥伴連結。許可的最大值為 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
  • featureSet

如果合作夥伴連結使用 FEATURE_SET_AD_EVENT_MANAGEMENT 特徵集，則也支援下列欄位：

  • partnerCustomerAccount.account_id
  • partnerLinkMetadata.implicit_accounts.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