Method: hashList.get
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
해시 목록의 최신 콘텐츠를 가져옵니다. 해시 목록은 위협 목록이거나 위협 목록이 아닌 목록(예: 전역 캐시)일 수 있습니다.
이는 https://google.aip.dev/131에 정의된 표준 Get 메서드이며 HTTP 메서드도 GET입니다.
HTTP 요청
GET https://safebrowsing.googleapis.com/v5/hashList/{name}
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
필수 항목입니다. 이 특정 해시 목록의 이름입니다. 위협 목록일 수도 있고 글로벌 캐시일 수도 있습니다.
|
쿼리 매개변수
| 매개변수 |
version |
string (bytes format)
클라이언트에 이미 있는 해시 목록의 버전입니다. 클라이언트가 해시 목록을 가져오는 것이 처음이라면 이 필드는 비워 두어야 합니다. 그렇지 않으면 클라이언트는 이전에 서버에서 수신한 버전을 제공해야 합니다. 클라이언트는 이러한 바이트를 조작하면 안 됩니다. V5의 새로운 기능: API의 V4에서는 이 속성을 states이라고 했지만 이제 명확성을 위해 version로 이름이 변경되었습니다. base64 인코딩 문자열입니다.
|
sizeConstraints |
object (SizeConstraints)
목록의 크기 제한입니다. 생략하면 제약 조건이 없습니다. 처리 능력, 대역폭 또는 저장용량이 제한된 모든 기기에는 제약 조건을 적용하는 것이 좋습니다.
|
응답 본문
성공한 경우 응답 본문에 HashList의 인스턴스가 포함됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: hashList.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nGet the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache.\n\nThis is a standard Get method as defined by \u003chttps://google.aip.dev/131\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashList/{name}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST be left empty. Otherwise, the client SHOULD supply the version previously received from the server. The client MUST NOT manipulate those bytes. **What's new in V5** : in V4 of the API, this was called `states`; it is now renamed to `version` for clarity. A base64-encoded string. |\n| `sizeConstraints` | `object (`[SizeConstraints](/safe-browsing/reference/rest/v5/SizeConstraints)`)` The size constraints on the list. If omitted, there are no constraints. Constraints are recommended on all devices with limited processing power, bandwidth, or storage. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [HashList](/safe-browsing/reference/rest/v5/hashList#HashList)."]]
