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à 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 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 tối đa các đường liên kết đến đối tác cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 10 đường liên kết đến đối tác. Giá trị tối đa là 100; các giá trị lớn hơ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 giữa kiểu lạc đà và kiểu rắn.

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

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

Câu trả lờ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ó trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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