Truy xuất tài nguyên PartnerLink bằng cách gửi SearchPartnerLinksRequest.
Trường parent của yêu cầu là bắt buộc. Đặt parent thành tên tài nguyên của một tài khoản cụ thể, sử dụng định dạng:
accountTypes/{account_type}/accounts/{account}
Để linh hoạt trong nhiều trường hợp sử dụng, SearchPartnerLinksResponse chứa tất cả tài nguyên PartnerLink, trong đó parent trong yêu cầu là:
- Tài khoản được xác định bằng trường
owner_account - Tài khoản được xác định bằng trường
partner_account
Đặt tiêu đề của yêu cầu nếu bạn đang truy cập vào tài khoản parent bằng đường liên kết của đối tác, tài khoản người quản lý Google Ads chính hoặc tài khoản đối tác Display & Video 360 chính.
Lọc kết quả để giới hạn phản hồi cho các tài nguyên có thuộc tính cụ thể.
Phương thức Search trả về các trang kết quả. Để truy xuất tất cả tài nguyên cho một yêu cầu, hãy kiểm tra next_page_token và phân trang kết quả.
Đặt tiêu đề của yêu cầu
Phương thức Search hỗ trợ tiêu đề login-account để xác định đường dẫn truy cập của thông tin xác thực đến tài khoản parent trong yêu cầu. Tiêu đề linked-account không được hỗ trợ cho các phương thức PartnerLinkService.
Hãy tham khảo phần Đích đến và tiêu đề để biết thông tin chi tiết và hướng dẫn về cách đặt tiêu đề cho các trường hợp truy cập khác nhau.
Lọc kết quả
Sử dụng trường filter của yêu cầu để truy xuất các đường liên kết cụ thể của đối tác. Trường filter là một chuỗi xác định nhóm điều kiện mà bạn muốn áp dụng, cùng với việc API có nên kết hợp các điều kiện bằng AND hay OR hay không.
Đọc thêm về các lựa chọn và cú pháp lọc trong AIP-160: Lọc.
Bạn có thể xác định filter bằng cách sử dụng account_id của tài khoản chủ sở hữu hoặc tài khoản đối tác:
owning_account.account_id:account_idcủa tài khoản chủ sở hữu.partner_account.account_id:account_idcủa tài khoản đối tác.
Ví dụ: dưới đây là một filter trả về tất cả các mối liên kết đối tác mà tài khoản sở hữu có mã tài khoản là OWNING_ACCOUNT_ID:
owning_account.account_id = OWNING_ACCOUNT_ID
Sau đây là một ví dụ khác về filter. Thao tác này sẽ trả về tất cả các đường liên kết của đối tác, trong đó tài khoản chủ sở hữu có mã tài khoản là OWNING_ACCOUNT_ID hoặc tài khoản đối tác có mã tài khoản là PARTNER_ACCOUNT_ID:
owning_account.account_id = OWNING_ACCOUNT_ID OR partner_account.account_id = PARTNER_ACCOUNT_ID
Việc sửa đổi filter đó để sử dụng AND thay vì OR sẽ giới hạn tài nguyên được trả về cho các đường liên kết đối tác, trong đó cả tài khoản chủ sở hữu đều có mã tài khoản OWNING_ACCOUNT_ID và tài khoản đối tác có mã tài khoản PARTNER_ACCOUNT_ID:
owning_account.account_id = OWNING_ACCOUNT_ID AND partner_account.account_id = PARTNER_ACCOUNT_ID
Phân trang kết quả
Sử dụng trường page_size để kiểm soát số lượng kết quả được trả về trong một phản hồi. Ví dụ: nếu bạn đặt page_size thành 10, thì API sẽ trả về tối đa 10 kết quả cho mỗi phản hồi. API có thể trả về ít hơn 10 kết quả nếu có ít hơn 10 kết quả khớp với yêu cầu của bạn.
page_size mặc định là 50 và tối đa là 1000.
Nếu có nhiều kết quả hơn mức có thể chứa trong một phản hồi, thì phản hồi đó sẽ
bao gồm next_page_token. Để truy xuất trang tiếp theo hoặc tập hợp kết quả tiếp theo, hãy gửi lại cùng một yêu cầu với trường page_token được đặt thành giá trị này. Tất cả các tham số khác phải giống với yêu cầu trước đó.
Nếu trường next_page_token không có trong phản hồi, thì tức là không còn kết quả nào khác.