Method: accountTypes.accounts.partnerLinks.search

Tìm kiếm tất cả các mối liên kết với đối tác đến và đi từ một tài khoản nhất định.

Tiêu đề uỷ quyền:

Phương thức này hỗ trợ các tiêu đề không bắt buộc sau đây để xác định cách API cho phép truy cập vào yêu cầu:

  • login-account: (Không bắt buộc) Tên tài nguyên của tài khoản mà Tài khoản Google của thông tin đăng nhập là một người dùng. Nếu không được đặt, giá trị mặc định sẽ là tài khoản của yêu cầu. Định dạng: accountTypes/{loginAccountType}/accounts/{loginAccountId}

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tài khoản để tìm kiếm các mối liên kết với đối tác. Nếu bạn không chỉ định filter, thì tất cả các mối liên kết với đối tác mà tài khoản này là owningAccount hoặc partnerAccount đều được trả về.

Định dạng accountTypes/{accountType}/accounts/{account}

Tham số truy vấn

Thông số
pageSize

integer

Số lượng đường liên kết đến đối tác tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 50 đường liên kết đến đối tác sẽ được trả về. Giá trị tối đa là 100; các giá trị trên 100 sẽ được chuyển đổi thành 100.
pageToken

string

Mã thông báo trang nhận được từ một lệnh gọi partnerLinks.search trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho partnerLinks.search phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Một chuỗi bộ lọc. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: partner_link_id = 123456789). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp kiểu viết lạc đà và kiểu viết thường phân tách bằng dấu gạch dưới.

Các thao tác được hỗ trợ:

  • AND
  • =
  • !=

Các trường được hỗ trợ:

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

Đối với các đường liên kết đến đối tác có bộ tính năng FEATURE_SET_AD_EVENT_MANAGEMENT, các trường sau đây cũng được hỗ trợ:

  • partnerCustomerAccount.account_id
  • partnerLinkMetadata.implicit_accounts.account_id

Ví dụ: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi của SearchPartnerLinksRequest.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "partnerLinks": [
    {
      object (PartnerLink)
    }
  ],
  "nextPageToken": string
}
Trường
nextPageToken

string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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