REST Resource: hashList

ทรัพยากร: HashList

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

การแสดง JSON 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": 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.

  // Union field checksum can be only one of the following:
  "sha256Checksum": string
  // End of list of possible types for union field checksum.
}
ช่อง
name

string

ชื่อของรายการแฮช โปรดทราบว่า Global Cache เป็นเพียงรายการแฮชที่สามารถอ้างอิงถึงได้ที่นี่
version

string (bytes format)

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

สตริงที่เข้ารหัสฐาน 64
partialUpdate

boolean

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

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

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

object (RiceDeltaEncoded32Bit)

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

string (Duration format)

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

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

object (HashListMetadata)

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

object (RiceDeltaEncoded32Bit)

ข้อมูลที่เพิ่มเข้ามาแบบ 4 ไบต์
additionsEightBytes

object (RiceDeltaEncoded64Bit)

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

object (RiceDeltaEncoded128Bit)

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

object (RiceDeltaEncoded256Bit)

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

string (bytes format)

รายการแฮชทั้งหมดที่จัดเรียงแล้ว ซึ่งแฮชอีกครั้งด้วย SHA256

สตริงที่เข้ารหัสฐาน 64

RiceDeltaEncrypted32 บิต

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

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

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

การแสดง 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

สตริงที่เข้ารหัสฐาน 64

การเข้ารหัส RiceDelta64 บิต

เหมือนกับ 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

สตริงที่เข้ารหัสฐาน 64

การเข้ารหัส RiceDelta128 บิต

เหมือนกับ 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

สตริงที่เข้ารหัสฐาน 64

RiceDeltaEncrypted256 บิต

เหมือนกับ 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

สตริงที่เข้ารหัสฐาน 64

HashListMetadata

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

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

enum (ThreatType)

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

enum (LikelySafeType)

รายการที่ไม่เรียงลำดับ หากไม่ว่างเปล่า จะระบุว่ารายการแฮชแสดงรายการของแฮชที่น่าจะปลอดภัย และแจกแจงวิธีที่ระบบพิจารณาว่าน่าจะปลอดภัย ช่องนี้แยกต่างหากพร้อมกับช่อง ThreatTypes
mobileOptimized

boolean

เพิ่มประสิทธิภาพรายการสำหรับอุปกรณ์เคลื่อนที่ (Android และ iOS) หรือไม่
description

string

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

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 ไม่ได้ระบุความยาว เซิร์ฟเวอร์จะไม่ส่งคืนค่านี้ในการตอบกลับไปยังไคลเอ็นต์ (ในช่อง supportedHashLengths) แต่ไคลเอ็นต์จะส่งค่านี้ไปยังเซิร์ฟเวอร์ได้ (ในช่อง desiredHashLength) ซึ่งในกรณีนี้เซิร์ฟเวอร์จะเลือกค่าโดยอัตโนมัติ ไคลเอ็นต์ควรให้เซิร์ฟเวอร์เลือกค่า
FOUR_BYTES แฮชแต่ละรายการจะเป็นคำนำหน้าแบบ 4 ไบต์
EIGHT_BYTES แฮชแต่ละรายการจะขึ้นต้นด้วย 8 ไบต์
SIXTEEN_BYTES แฮชแต่ละรายการจะขึ้นต้นด้วย 16 ไบต์
THIRTY_TWO_BYTES แฮชแต่ละรายการจะเป็นแฮชแบบเต็ม 32 ไบต์

วิธีการ

get

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