출시 노트

버전 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 상태 코드가 변경되었습니다.