SearchPartnerLinksRequest를 전송하여 PartnerLink 리소스를 가져옵니다.
요청의 parent 필드는 필수입니다. 다음 형식을 사용하여 parent를 특정 계정의 리소스 이름으로 설정합니다.
accountTypes/{account_type}/accounts/{account}
다양한 사용 사례에서 유연성을 제공하기 위해 SearchPartnerLinksResponse
에는 요청의 parent가 다음 중 하나인 모든 PartnerLink 리소스가 포함됩니다.
owner_account필드로 식별되는 계정partner_account필드로 식별되는 계정
요청 헤더를 설정합니다. parent 계정에 액세스하는 경우
파트너 링크, 상위 Google Ads 관리자 계정 또는 상위 Display & Video 360 파트너
계정을 사용합니다.
결과를 필터링하여 응답을 특정 속성이 있는 리소스로 제한합니다.
Search 메서드는 결과 페이지를 반환합니다. 요청의 모든 리소스를 가져오려면 next_page_token을 확인하고 결과를 페이지로 나눕니다.
요청 헤더 설정
Search 메서드는 login-account 헤더를 지원하여 요청의 parent 계정에 대한 사용자 인증 정보의 액세스 경로를 정의합니다. PartnerLinkService
메서드에서는 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
OR 대신 AND를 사용하도록 filter를 수정하면 반환된
리소스가 소유 계정의 계정 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 필드가 포함되지 않은 경우 더 이상 결과가 없음을 나타냅니다.