REST Resource: hashList

ทรัพยากร: HashList

รายการแฮชที่ระบุตามชื่อ

การแสดง JSON 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": string,
  "sha256Checksum": string,
  "metadata": {
    object (HashListMetadata)
  },

  // Union field compressed_additions can be only one of the following:
  "additionsFourBytes": {
    object (RiceDeltaEncoded32Bit)
  },
  "additionsEightBytes": {
    object (RiceDeltaEncoded64Bit)
  },
  "additionsSixteenBytes": {
    object (RiceDeltaEncoded128Bit)
  },
  "additionsThirtyTwoBytes": {
    object (RiceDeltaEncoded256Bit)
  }
  // End of list of possible types for union field compressed_additions.
}
ช่อง
name

string

ชื่อของรายการแฮช โปรดทราบว่าแคชส่วนกลางเป็นเพียงรายการแฮชและดูได้ที่นี่
version

string (bytes format)

เวอร์ชันของรายการแฮช ไคลเอ็นต์ต้องไม่แก้ไขไบต์เหล่านั้น

สตริงที่เข้ารหัส Base64
partialUpdate

boolean

หากเป็นจริง นี่คือความแตกต่างบางส่วนที่มีการเพิ่มและการนำออกตามสิ่งที่ไคลเอ็นต์มีอยู่แล้ว หากเป็นเท็จ รายการนี้จะเป็นรายการแฮชที่สมบูรณ์

หากเป็นเท็จ ไคลเอ็นต์ต้องลบเวอร์ชันที่จัดเก็บไว้ในเครื่องสำหรับรายการแฮชนี้ ซึ่งหมายความว่าเวอร์ชันที่ไคลเอ็นต์มีนั้นล้าสมัยอย่างมาก หรือระบบเชื่อว่าข้อมูลไคลเอ็นต์เสียหาย ฟิลด์ compressedRemovals จะว่างเปล่า

หากเป็นจริง ไคลเอ็นต์ต้องใช้การอัปเดตแบบเพิ่มทีละรายการโดยใช้การนำออกก่อน แล้วจึงเพิ่ม
compressedRemovals

object (RiceDeltaEncoded32Bit)

ดัชนีการนำออกเวอร์ชันที่เข้ารหัส Rice-delta เนื่องจากรายการแฮชแต่ละรายการมีรายการน้อยกว่า 2^32 รายการอย่างแน่นอน ระบบจึงถือว่าดัชนีเป็นจำนวนเต็ม 32 บิตและเข้ารหัส
minimumWaitDuration

string (Duration format)

ไคลเอ็นต์ควรรออย่างน้อยเท่านี้เพื่อรับรายการแฮชอีกครั้ง หากไม่มีหรือเป็น 0 ไคลเอ็นต์ควรดึงข้อมูลทันทีเนื่องจากแสดงว่าเซิร์ฟเวอร์มีการอัปเดตเพิ่มเติมที่จะส่งไปยังไคลเอ็นต์ แต่ส่งไม่ได้เนื่องจากข้อจำกัดที่ไคลเอ็นต์ระบุ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
sha256Checksum

string (bytes format)

รายการแฮชทั้งหมดที่จัดเรียงแล้ว ซึ่งแฮชอีกครั้งด้วย SHA256 นี่คือผลรวมตรวจสอบสำหรับรายการแฮชทั้งหมดที่เรียงลำดับแล้วซึ่งอยู่ในฐานข้อมูลหลังจากใช้การอัปเดตที่ระบุ ในกรณีที่ไม่มีการอัปเดต เซิร์ฟเวอร์จะละเว้นฟิลด์นี้เพื่อระบุว่าไคลเอ็นต์ควรใช้ผลรวมตรวจสอบที่มีอยู่

สตริงที่เข้ารหัส Base64
metadata

object (HashListMetadata)

ข้อมูลเมตาเกี่ยวกับรายการแฮช hashList.get ไม่ได้สร้างข้อมูลนี้ แต่ ListHashLists สร้างข้อมูลนี้
ฟิลด์ Union compressed_additions เวอร์ชันที่เข้ารหัส Rice-delta ของการเพิ่ม ความยาวของคำนำหน้าแฮชของการเพิ่มจะเหมือนกันในการเพิ่มทั้งหมดในรายการ compressed_additions ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
additionsFourBytes

object (RiceDeltaEncoded32Bit)

การเพิ่ม 4 ไบต์
additionsEightBytes

object (RiceDeltaEncoded64Bit)

การเพิ่ม 8 ไบต์
additionsSixteenBytes

object (RiceDeltaEncoded128Bit)

การเพิ่ม 16 ไบต์
additionsThirtyTwoBytes

object (RiceDeltaEncoded256Bit)

การเพิ่ม 32 ไบต์

RiceDeltaEncoded32Bit

ข้อมูลที่เข้ารหัส Rice-Golomb ใช้สำหรับแฮชหรือดัชนีการนำออก เรารับประกันว่าแฮชหรือดัชนีทุกรายการที่นี่มีความยาวเท่ากัน และความยาวนี้คือ 32 บิต

โดยทั่วไปแล้ว หากเราจัดเรียงรายการทั้งหมดตามพจนานุกรม เราจะพบว่าบิตที่มีลำดับสูงมักจะไม่เปลี่ยนแปลงบ่อยเท่าบิตที่มีลำดับต่ำ ซึ่งหมายความว่าหากเราพิจารณาความแตกต่างที่อยู่ติดกันระหว่างรายการต่างๆ บิตที่มีลำดับสูงกว่าก็มีโอกาสสูงที่จะเป็น 0 ซึ่งใช้ประโยชน์จากความน่าจะเป็นสูงที่ค่าจะเป็น 0 โดยการเลือกจำนวนบิตที่แน่นอน โดยบิตทั้งหมดที่มีความสำคัญมากกว่านี้มีแนวโน้มที่จะเป็น 0 ดังนั้นเราจึงใช้การเข้ารหัสแบบเอกภาค ดูฟิลด์ riceParameter

หมายเหตุเกี่ยวกับประวัติ: การเข้ารหัสเดลต้ารายการแรกใช้ใน API เวอร์ชัน 4 ใน V5 มีการปรับปรุงที่สำคัญ 2 อย่าง ได้แก่ ประการแรก การเข้ารหัส Rice-delta พร้อมใช้งานแล้วโดยมีคำนำหน้าแฮชยาวกว่า 4 ไบต์ ประการที่สอง ตอนนี้ระบบจะถือว่าข้อมูลที่เข้ารหัสเป็นแบบ Big-Endian เพื่อหลีกเลี่ยงขั้นตอนการจัดเรียงที่มีค่าใช้จ่ายสูง

การแสดง JSON 
{
  "firstValue": integer,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ช่อง
firstValue

integer (uint32 format)

รายการแรกในข้อมูลที่เข้ารหัส (แฮชหรือดัชนี) หรือค่าของรายการนั้นหากมีการเข้ารหัสเฉพาะคำนำหน้าแฮชหรือดัชนีเดียว หากช่องว่างเปล่า รายการจะเป็น 0
riceParameter

integer

พารามิเตอร์ Golomb-Rice พารามิเตอร์นี้รับประกันว่าจะมีค่าอยู่ระหว่าง 3 ถึง 30
entriesCount

integer

จำนวนรายการที่เข้ารหัสเดลต้าในข้อมูลที่เข้ารหัส หากมีการเข้ารหัสจำนวนเต็มเพียงค่าเดียว ค่านี้จะเป็น 0 และระบบจะจัดเก็บค่าเดียวใน firstValue
encodedData

string (bytes format)

เดลต้าที่เข้ารหัสซึ่งเข้ารหัสโดยใช้ตัวเข้ารหัส Golomb-Rice

สตริงที่เข้ารหัส Base64

RiceDeltaEncoded64Bit

เหมือนกับ RiceDeltaEncoded32Bit ยกเว้นว่าตัวนี้จะเข้ารหัสตัวเลข 64 บิต

การแสดง JSON 
{
  "firstValue": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ช่อง
firstValue

string

รายการแรกในข้อมูลที่เข้ารหัส (แฮช) หรือค่าของรายการนั้นหากมีการเข้ารหัสเฉพาะคำนำหน้าแฮชรายการเดียว หากช่องว่างเปล่า รายการจะเป็น 0
riceParameter

integer

พารามิเตอร์ Golomb-Rice พารามิเตอร์นี้รับประกันว่าจะมีค่าอยู่ระหว่าง 35 ถึง 62
entriesCount

integer

จำนวนรายการที่เข้ารหัสเดลต้าในข้อมูลที่เข้ารหัส หากมีการเข้ารหัสจำนวนเต็มเพียงค่าเดียว ค่านี้จะเป็น 0 และระบบจะจัดเก็บค่าเดียวใน firstValue
encodedData

string (bytes format)

เดลต้าที่เข้ารหัสซึ่งเข้ารหัสโดยใช้ตัวเข้ารหัส Golomb-Rice

สตริงที่เข้ารหัส Base64

RiceDeltaEncoded128Bit

เหมือนกับ RiceDeltaEncoded32Bit ยกเว้นว่าฟังก์ชันนี้จะเข้ารหัสตัวเลข 128 บิต

การแสดง JSON 
{
  "firstValueHi": string,
  "firstValueLo": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ช่อง
firstValueHi

string

บิต 64 บิตบนของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากฟิลด์ว่างเปล่า บิต 64 บิตบนจะเป็น 0 ทั้งหมด
firstValueLo

string (uint64 format)

64 บิตล่างของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากฟิลด์ว่าง บิตล่างสุด 64 บิตจะเป็น 0 ทั้งหมด
riceParameter

integer

พารามิเตอร์ Golomb-Rice เรารับประกันว่าพารามิเตอร์นี้จะมีค่าอยู่ระหว่าง 99 ถึง 126
entriesCount

integer

จำนวนรายการที่เข้ารหัสเดลต้าในข้อมูลที่เข้ารหัส หากมีการเข้ารหัสจำนวนเต็มเพียงค่าเดียว ค่านี้จะเป็น 0 และระบบจะจัดเก็บค่าเดียวใน firstValue
encodedData

string (bytes format)

เดลต้าที่เข้ารหัสซึ่งเข้ารหัสโดยใช้ตัวเข้ารหัส Golomb-Rice

สตริงที่เข้ารหัส Base64

RiceDeltaEncoded256Bit

เหมือนกับ RiceDeltaEncoded32Bit ยกเว้นว่าตัวนี้จะเข้ารหัสตัวเลข 256 บิต

การแสดง JSON 
{
  "firstValueFirstPart": string,
  "firstValueSecondPart": string,
  "firstValueThirdPart": string,
  "firstValueFourthPart": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ช่อง
firstValueFirstPart

string

64 บิตแรกของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากฟิลด์ว่าง บิตแรก 64 บิตจะเป็น 0 ทั้งหมด
firstValueSecondPart

string (uint64 format)

บิตที่ 65 ถึง 128 ของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากช่องว่าง บิตที่ 65 ถึง 128 จะเป็น 0 ทั้งหมด
firstValueThirdPart

string (uint64 format)

บิตที่ 129 ถึง 192 ของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากช่องว่าง บิตที่ 129 ถึง 192 จะเป็น 0 ทั้งหมด
firstValueFourthPart

string (uint64 format)

บิต 64 บิตสุดท้ายของรายการแรกในข้อมูลที่เข้ารหัส (แฮช) หากฟิลด์ว่างเปล่า บิต 64 บิตสุดท้ายจะเป็น 0 ทั้งหมด
riceParameter

integer

พารามิเตอร์ Golomb-Rice พารามิเตอร์นี้รับประกันว่าจะมีค่าอยู่ระหว่าง 227 ถึง 254 (รวมค่าแรกและค่าสุดท้าย)
entriesCount

integer

จำนวนรายการที่เข้ารหัสเดลต้าในข้อมูลที่เข้ารหัส หากมีการเข้ารหัสจำนวนเต็มเพียงค่าเดียว ค่านี้จะเป็น 0 และระบบจะจัดเก็บค่าเดียวใน firstValue
encodedData

string (bytes format)

เดลต้าที่เข้ารหัสซึ่งเข้ารหัสโดยใช้ตัวเข้ารหัส Golomb-Rice

สตริงที่เข้ารหัส Base64

HashListMetadata

ข้อมูลเมตาเกี่ยวกับรายการแฮชที่เฉพาะเจาะจง

การแสดง JSON 
{
  "threatTypes": [
    enum (ThreatType)
  ],
  "likelySafeTypes": [
    enum (LikelySafeType)
  ],
  "description": string,
  "hashLength": enum (HashLength)
}
ช่อง
threatTypes[]

enum (ThreatType)

รายการที่ไม่เรียงลำดับ หากไม่ว่างเปล่า จะระบุว่ารายการแฮชเป็นรายการภัยคุกคาม และจะแจงนับประเภทภัยคุกคามที่เชื่อมโยงกับแฮชหรือคำนำหน้าแฮชในรายการแฮชนี้ ค่านี้อาจเว้นว่างไว้ได้หากรายการไม่ได้แสดงถึงภัยคุกคาม เช่น ในกรณีที่รายการแสดงถึงประเภทที่น่าจะปลอดภัย
likelySafeTypes[]

enum (LikelySafeType)

รายการที่ไม่เรียงลำดับ หากไม่ว่างเปล่า จะระบุว่ารายการแฮชแสดงรายการแฮชที่น่าจะปลอดภัย และจะแสดงวิธีที่ระบบพิจารณาว่าแฮชเหล่านี้น่าจะปลอดภัย ฟิลด์นี้จะใช้ร่วมกับฟิลด์ threatTypes ไม่ได้
description

string

คำอธิบายที่มนุษย์อ่านได้เกี่ยวกับรายการนี้ เป็นภาษาอังกฤษ
hashLength

enum (HashLength)

ความยาวของแฮชที่รองรับสำหรับรายการแฮชนี้ รายการแฮชแต่ละรายการจะรองรับความยาวได้เพียง 1 รายการ หากมีการนำความยาวแฮชที่แตกต่างกันมาใช้สำหรับชุดประเภทภัยคุกคามหรือประเภทที่ปลอดภัยชุดเดียวกัน ระบบจะนำมาใช้เป็นรายการแยกต่างหากที่มีชื่อเฉพาะและชุดความยาวแฮชที่เกี่ยวข้อง

ThreatType

ประเภทของภัยคุกคาม

Enum
THREAT_TYPE_UNSPECIFIED ประเภทภัยคุกคามที่ไม่รู้จัก หากเซิร์ฟเวอร์ส่งคืนค่านี้ ไคลเอ็นต์จะไม่สนใจ FullHashDetail ทั้งหมด
MALWARE

ประเภทภัยคุกคามจากมัลแวร์ มัลแวร์คือซอฟต์แวร์หรือแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ใดๆ ก็ตามที่ออกแบบมาเพื่อสร้างความเสียหายแก่คอมพิวเตอร์ อุปกรณ์เคลื่อนที่ ซอฟต์แวร์ที่ทำงานอยู่ หรือผู้ใช้ซอฟต์แวร์นั้นๆ มัลแวร์มีลักษณะการทำงานที่เป็นอันตราย ซึ่งอาจรวมถึงการติดตั้งซอฟต์แวร์โดยไม่ได้รับคำยินยอมจากผู้ใช้ และการติดตั้งซอฟต์แวร์ที่เป็นอันตรายอย่างเช่น ไวรัส

ดูข้อมูลเพิ่มเติมได้ที่นี่
SOCIAL_ENGINEERING

ประเภทภัยคุกคามแบบวิศวกรรมสังคม หน้าวิศวกรรมสังคมแอบอ้างว่าดำเนินการในนามของบุคคลที่สามโดยมีเจตนาที่จะทำให้ผู้ชมสับสนและดำเนินการในสิ่งที่ผู้ชมจะเชื่อถือเฉพาะตัวแทนที่แท้จริงของบุคคลที่สามรายนั้น ฟิชชิงเป็นวิศวกรรมสังคมประเภทหนึ่งที่หลอกลวงให้ผู้ชมดำเนินการที่เจาะจงในการให้ข้อมูล เช่น ข้อมูลเข้าสู่ระบบ

ดูข้อมูลเพิ่มเติมได้ที่นี่
UNWANTED_SOFTWARE ประเภทภัยคุกคามของซอฟต์แวร์ไม่พึงประสงค์ ซอฟต์แวร์ไม่พึงประสงค์คือซอฟต์แวร์ที่ไม่เป็นไปตามหลักการด้านซอฟต์แวร์ของ Google แต่ไม่ใช่มัลแวร์
POTENTIALLY_HARMFUL_APPLICATION ประเภทภัยคุกคามของแอปพลิเคชันที่อาจเป็นอันตรายตามที่ Google Play Protect ใช้สำหรับ Play Store

LikelySafeType

ประเภทของเว็บไซต์ที่น่าจะปลอดภัย

โปรดทราบว่า SearchHashesResponse ไม่มี LikelySafeType โดยตั้งใจ

Enum
LIKELY_SAFE_TYPE_UNSPECIFIED ไม่รู้จัก
GENERAL_BROWSING เว็บไซต์นี้อาจปลอดภัยเพียงพอสำหรับการท่องเว็บทั่วไป หรือที่เรียกว่าแคชส่วนกลาง
CSD เว็บไซต์นี้มีแนวโน้มที่จะปลอดภัยเพียงพอ จึงไม่จำเป็นต้องเรียกใช้โมเดลการตรวจหาฝั่งไคลเอ็นต์หรือการตรวจสอบการป้องกันด้วยรหัสผ่าน
DOWNLOAD เว็บไซต์นี้อาจปลอดภัยเพียงพอจนไม่จำเป็นต้องตรวจสอบการดาวน์โหลดจากเว็บไซต์

HashLength

ความยาวของแฮชในรายการแฮช

Enum
HASH_LENGTH_UNSPECIFIED ความยาวที่ไม่ได้ระบุ
FOUR_BYTES แฮชแต่ละรายการเป็นคำนำหน้า 4 ไบต์
EIGHT_BYTES แฮชแต่ละรายการเป็นคำนำหน้า 8 ไบต์
SIXTEEN_BYTES แฮชแต่ละรายการเป็นคำนำหน้า 16 ไบต์
THIRTY_TWO_BYTES แฮชแต่ละรายการเป็นแฮชแบบเต็มขนาด 32 ไบต์

เมธอด

get

 รับเนื้อหาล่าสุดของรายการแฮช