Method: hashList.get

해시 목록의 최신 콘텐츠를 가져옵니다. 해시 목록은 위협 목록이거나 위협 목록이 아닌 목록(예: 전역 캐시)일 수 있습니다.

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

HTTP 요청

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

경로 매개변수

매개변수
name

string

필수입니다. 이 특정 해시 목록의 이름입니다. 위협 목록일 수도 있고 글로벌 캐시일 수도 있습니다.

쿼리 매개변수

매개변수
version

string (bytes format)

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

V5의 새로운 기능: API의 V4에서는 이 속성을 states이라고 했지만 이제 명확성을 위해 version로 이름이 바뀌었습니다.

base64 인코딩 문자열입니다.
desiredHashLength
(deprecated)

enum (HashLength)

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

해시 목록마다 허용되는 desiredHashLength 필드 값에 대한 요구사항이 다릅니다. HashListMetadata의 supportedHashLengths 필드에서 확인할 수 있습니다. desiredHashLength가 supportedHashLengths 내에 값을 지정하지 않으면 오류가 반환됩니다.
sizeConstraints

object (SizeConstraints)

목록의 크기 제한입니다. 생략하면 제약 조건이 없습니다. 처리 능력, 대역폭 또는 저장용량이 제한된 모든 기기에는 제약 조건을 적용하는 것이 좋습니다.

요청 본문

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

응답 본문

성공한 경우 응답 본문에 HashList의 인스턴스가 포함됩니다.