출시 노트
버전 4.0
Safe Browsing API (v4)에는 다음 업데이트 및 새로운 기능이 포함되어 있습니다.
Lookup API (v4)
동일한 점:
- API에서는 여전히 클라이언트가 Google 세이프 브라우징 서버 및 세이프 브라우징 목록을 직접 쿼리하도록 합니다.
차이점:
- HTTP
GET 메서드는 더 이상 지원되지 않습니다. 대신 HTTP POST 메서드를 사용하세요.
- 이제
key 매개변수가 HTTP POST 요청 URL에 필요한 유일한 매개변수입니다.
- HTTP
POST 요청 및 응답 형식이 변경되었습니다. 일반 텍스트는 더 이상 지원되지 않습니다.
대신 JSON을 사용하세요.
Update API (v4)
동일한 점:
- API에는 클라이언트가 로컬 데이터베이스 목록의 SHA256 해시 프리픽스를 주기적으로 업데이트합니다.
- API에는 클라이언트가 해시 접두사 충돌이 발생할 때 SHA256 전체 길이 해시를 가져오기 위한 유사한 요청도 있습니다.
차이점:
- 이제
key 매개변수가 HTTP POST 요청 URL에 필요한 유일한 매개변수입니다.
- HTTP
POST 요청 및 응답 형식이 변경되었습니다. 일반 텍스트는 더 이상 지원되지 않습니다.
대신 JSON을 사용하세요.
- 업데이트 인코딩 방식이 변경되었습니다. 추가 및 하위 청크를 제공하는 대신 이제 API에서 간단한 버전 관리 프로토콜을 사용하여 diff를 제공합니다. 클라이언트는 요청된 업데이트와 함께 현재 상태를 서버에 전송합니다. 서버가 새로운 클라이언트 상태와 diff로 응답하여 클라이언트를 완전히 업데이트합니다.
- 클라이언트 제약조건을 수용할 때 보호 희생을 최소화하기 위해 API는 우선순위가 지정된 위협 목록을 제공합니다. 각 클라이언트에 가장 우선순위가 높은 위협 데이터를 제공하는 데 기기 리소스, 대역폭, 위치정보 및 기타 신호가 사용됩니다.
threatLists.list 메서드
새로운 메서드 threatLists.list가 현재 조회 또는 다운로드할 수 있는 세이프 브라우징 목록 목록을 반환합니다.
상태 코드
HTTP POST 요청에 대한 응답으로 서버에서 생성한 HTTP 상태 코드가 변경되었습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2023-12-02(UTC)
[null,null,["최종 업데이트: 2023-12-02(UTC)"],[[["Safe Browsing APIs v4 transitions to using HTTP `POST` requests with JSON format, replacing the previous `GET` method and plain text format."],["The Update API v4 introduces a new diff-based update system for efficient threat list management and prioritizes threat lists based on client context."],["A new `threatLists.list` method enables retrieval of available Safe Browsing lists."],["The `key` parameter is now the sole requirement in HTTP `POST` request URLs for both Lookup and Update APIs."],["Updated HTTP status codes reflect the changes in request and response handling within the v4 APIs."]]],["Safe Browsing API (v4) updates include changes to both the Lookup and Update APIs. The `GET` method is replaced by `POST`, and plain text is replaced by JSON for requests and responses. The `key` parameter is now the sole required URL parameter. Updates are now encoded as diffs using a versioning protocol. The API serves prioritized threat lists based on client constraints. A new `threatLists.list` method lists available Safe Browsing lists, and HTTP status codes have been revised.\n"]]
