한 번에 여러 해시 목록을 가져옵니다.
클라이언트가 여러 해시 목록을 가져와야 하는 경우가 매우 많습니다. 일반 Get 메서드를 여러 번 사용하는 것보다 이 메서드를 사용하는 것이 더 좋습니다.
이는 https://google.aip.dev/231에 정의된 표준 일괄 Get 메서드이며 HTTP 메서드도 GET입니다.
HTTP 요청
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
names[] |
필수 항목입니다. 특정 해시 목록의 이름입니다. 목록은 위협 목록이거나 전역 캐시일 수 있습니다(MAY). 이름에는 중복을 포함해서는 안 됩니다. 충돌하면 클라이언트에 오류가 표시됩니다. |
version[] |
클라이언트에 이미 있는 해시 목록의 버전입니다. 클라이언트가 해시 목록을 처음 가져오는 경우 필드를 비워 두어야 합니다. 그렇지 않으면 클라이언트는 이전에 서버로부터 수신한 버전을 제공해야 합니다. 클라이언트는 이러한 바이트를 조작하면 안 됩니다(MUST NOT). 클라이언트는 상응하는 목록 이름과 동일한 순서로 버전을 전송할 필요가 없습니다. 클라이언트가 요청에서 이름보다 더 적거나 더 많은 버전을 보낼 수 있습니다. 하지만 클라이언트는 동일한 이름에 상응하는 여러 버전을 전송하면 안 됩니다(MUST NOT). 충돌하면 클라이언트에 오류가 발생합니다. 이전 참고사항: API V4에서는 이를 base64 인코딩 문자열입니다. |
desiredHashLength |
반환된 해시의 원하는 해시 프리픽스 길이(바이트)입니다. 그러면 서버는 지정된 길이로 모든 해시 접두사를 반환합니다. 해시 목록마다 특히 |
sizeConstraints |
각 목록의 크기 제한 생략할 경우 제약 조건이 없습니다. 여기에 표시된 크기는 목록별 값이며 모든 목록에서 집계되는 것은 아닙니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
여러 해시 목록이 포함된 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"hashLists": [
{
object ( |
필드 | |
---|---|
hashLists[] |
요청에 지정된 순서대로 해시가 나열됩니다. |