SearchPartnerLinksRequest를 전송하여 PartnerLink 리소스를 가져옵니다.
요청의 parent 필드는 필수입니다. 다음 형식을 사용하여 parent을 특정 계정의 리소스 이름으로 설정합니다.
accountTypes/{account_type}/accounts/{account}
다양한 사용 사례에서 유연성을 확보하기 위해 SearchPartnerLinksResponse에는 요청의 parent이 다음 중 하나인 모든 PartnerLink 리소스가 포함됩니다.
owner_account필드로 식별되는 계정partner_account필드로 식별되는 계정
파트너 링크, 상위 Google Ads 관리자 계정 또는 상위 Display & Video 360 파트너 계정을 사용하여 parent 계정에 액세스하는 경우 요청 헤더를 설정합니다.
결과를 필터링하여 특정 속성이 있는 리소스로 응답을 제한합니다.
Search 메서드는 결과 페이지를 반환합니다. 요청의 모든 리소스를 가져오려면 next_page_token 및 결과 페이지로 나누기를 확인하세요.
요청 헤더 설정
Search 메서드는 요청에서 parent 계정에 대한 사용자 인증 정보의 액세스 경로를 정의하기 위해 login-account 및 linked-account 헤더를 지원합니다. 다양한 액세스 시나리오에 대한 헤더를 설정하는 방법과 세부정보는 대상 및 헤더를 참고하세요.
검색 결과 필터링
요청의 filter 필드를 사용하여 특정 파트너 링크를 가져옵니다. filter 필드는 적용하려는 조건 집합과 API가 AND 또는 OR를 사용하여 조건을 결합해야 하는지 여부를 정의하는 문자열입니다.
필터링 옵션 및 구문에 대한 자세한 내용은 AIP-160: 필터링을 참고하세요.
소유 계정 또는 파트너 계정의 account_id를 사용하여 filter를 정의할 수 있습니다.
owning_account.account_id: 소유 계정의account_id입니다.partner_account.account_id: 파트너 계정의account_id입니다.
예를 들어 소유 계정의 계정 ID가 OWNING_ACCOUNT_ID인 모든 파트너 링크를 반환하는 filter는 다음과 같습니다.
owning_account.account_id = OWNING_ACCOUNT_ID
filter의 또 다른 예는 다음과 같습니다. 소유 계정의 계정 ID가 OWNING_ACCOUNT_ID이거나 파트너 계정의 계정 ID가 PARTNER_ACCOUNT_ID인 모든 파트너 링크를 반환합니다.
owning_account.account_id = OWNING_ACCOUNT_ID OR partner_account.account_id = PARTNER_ACCOUNT_ID
filter를 OR 대신 AND를 사용하도록 수정하면 반환되는 리소스가 소유 계정의 계정 ID가 OWNING_ACCOUNT_ID 이고 파트너 계정의 계정 ID가 PARTNER_ACCOUNT_ID인 파트너 링크로 제한됩니다.
owning_account.account_id = OWNING_ACCOUNT_ID AND partner_account.account_id = PARTNER_ACCOUNT_ID
결과를 페이지로 나누기
page_size 필드를 사용하여 단일 응답으로 반환되는 결과 수를 제어합니다. 예를 들어 page_size을 10으로 설정하면 API는 응답당 최대 10개의 결과를 반환합니다. 요청과 일치하는 결과가 10개 미만인 경우 API에서 10개 미만의 결과를 반환할 수 있습니다.
기본값 page_size은 50이고 최댓값은 1,000입니다.
단일 응답에 들어갈 수 있는 것보다 많은 결과가 있는 경우 응답에 next_page_token이 포함됩니다. 다음 페이지 또는 결과 집합을 가져오려면 page_token 필드가 이 값으로 설정된 동일한 요청을 다시 전송합니다. 다른 모든 매개변수는 이전 요청과 동일해야 합니다.
next_page_token 필드가 응답에 포함되지 않으면 더 이상 결과가 없음을 나타냅니다.