Method: hashLists.batchGet

한 번에 여러 해시 목록을 가져옵니다.

클라이언트가 여러 해시 목록을 가져와야 하는 경우가 매우 많습니다. 일반 Get 메서드를 여러 번 사용하는 것보다 이 메서드를 사용하는 것이 더 좋습니다.

https://google.aip.dev/231에 정의된 표준 일괄 Get 메서드이며 HTTP 메서드도 GET입니다.

HTTP 요청

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
names[]

string

필수 항목입니다. 특정 해시 목록의 이름입니다. 목록은 위협 목록이거나 전역 캐시일 수 있습니다(MAY). 이름에는 중복을 포함해서는 안 됩니다. 충돌하면 클라이언트에 오류가 표시됩니다.

version[]

string (bytes format)

클라이언트에 이미 있는 해시 목록의 버전입니다. 클라이언트가 해시 목록을 처음 가져오는 경우 필드를 비워 두어야 합니다. 그렇지 않으면 클라이언트는 이전에 서버로부터 수신한 버전을 제공해야 합니다. 클라이언트는 이러한 바이트를 조작하면 안 됩니다(MUST NOT).

클라이언트는 상응하는 목록 이름과 동일한 순서로 버전을 전송할 필요가 없습니다. 클라이언트는 이름보다 더 적거나 더 많은 버전을 요청에 보낼 수 있습니다. 하지만 클라이언트는 동일한 이름에 상응하는 여러 버전을 전송하면 안 됩니다(MUST NOT). 충돌하면 클라이언트에 오류가 발생합니다.

이전 참고사항: API V4에서는 이를 states라고 했습니다. 이제 명확성을 위해 이름이 version로 변경되었습니다.

base64 인코딩 문자열입니다.

desiredHashLength

enum (HashLength)

반환된 해시의 원하는 해시 프리픽스 길이(바이트)입니다. 그러면 서버는 지정된 길이로 모든 해시 접두사를 반환합니다.

해시 목록마다 desiredHashLength 필드의 허용 가능한 값에 대한 요구사항이 다릅니다. HashListMetadatasupportedHashLengths 필드에서 확인할 수 있습니다. desiredHashLengthsupportedHashLengths 내의 값을 지정하지 않으면 클라이언트에 오류가 반환됩니다.

특히 BatchGetHashListsRequest의 경우 클라이언트가 여러 목록에 다른 desiredHashLength를 지정할 수 없습니다. 그렇게 해야 하는 경우 클라이언트는 여러 BatchGetHashListsRequest로 분할해야 합니다.

sizeConstraints

object (SizeConstraints)

각 목록의 크기 제한 생략할 경우 제약 조건이 없습니다. 여기에 표시된 크기는 목록별 값이며 모든 목록에서 집계되는 것은 아닙니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

여러 해시 목록이 포함된 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
필드
hashLists[]

object (HashList)

요청에 지정된 순서대로 해시가 나열됩니다.