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

عندما تكون القيمة true، يكون هذا الاختلاف جزئيًا ويتضمّن عمليات إضافة وإزالة استنادًا إلى ما يتوفّر لدى العميل. عندما تكون القيمة false، تكون هذه القائمة الكاملة لقيم التجزئة.

عندما تكون القيمة خطأ، على العميل حذف أي نسخة مخزّنة محليًا من قائمة التجزئة هذه. وهذا يعني أنّ الإصدار الذي يملكه العميل قديم جدًا أو يُعتقد أنّ بيانات العميل تالفة. سيكون الحقل compressedRemovals فارغًا.

عندما تكون القيمة صحيحة، على العميل تطبيق تحديث تدريجي من خلال تطبيق عمليات الإزالة ثم عمليات الإضافة.
compressedRemovals

object (RiceDeltaEncoded32Bit)

نسخة مؤلَّفة من فهارس الإزالة باستخدام ترميز Rice-delta بما أنّ كل قائمة تجزئة تحتوي بالتأكيد على أقل من 2^32 إدخالاً، يتم التعامل مع الفهارس على أنّها أعداد صحيحة ذات 32 بت ويتم ترميزها.
minimumWaitDuration

string (Duration format)

على العملاء الانتظار لهذه المدة على الأقل للحصول على قائمة التجزئة مرة أخرى. في حال حذفها أو ضبطها على صفر، على العملاء استرداد البيانات على الفور لأنّ ذلك يشير إلى أنّ الخادم لديه تعديل إضافي سيتم إرساله إلى العميل، ولكن تعذّر ذلك بسبب القيود التي حدّدها العميل.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
sha256Checksum

string (bytes format)

القائمة التي تم فرزها لجميع قيم التجزئة، والتي تم تجزئتها مرة أخرى باستخدام خوارزمية SHA256 هذا هو المجموع الاختباري للقائمة المصنّفة لجميع التجزئات المتوفّرة في قاعدة البيانات بعد تطبيق التحديث المقدَّم. في حال عدم توفير أي تحديثات، سيحذف الخادم هذا الحقل للإشارة إلى أنّ على العميل استخدام المجموع الاختباري الحالي.

سلسلة مرمّزة باستخدام Base64
metadata

object (HashListMetadata)

بيانات وصفية حول قائمة التجزئة لا تتم تعبئة هذا الحقل باستخدام طريقة hashList.get، ولكن تتم تعبئته باستخدام طريقة ListHashLists.
حقل الربط 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 بت بالضبط.

بشكل عام، إذا رتّبنا جميع الإدخالات معجميًا، سنلاحظ أنّ البتات ذات الترتيب الأعلى لا تتغيّر عادةً بوتيرة البتات ذات الترتيب الأدنى. وهذا يعني أنّه إذا أخذنا أيضًا الفرق المجاور بين الإدخالات، فإنّ البتات ذات الترتيب الأعلى يكون احتمال أن تكون صفرًا كبيرًا. يستغل هذا الترميز الاحتمال الكبير للصفر من خلال اختيار عدد معيّن من البتات، ومن المرجّح أن تكون جميع البتات الأكثر أهمية من هذا العدد صفرًا، لذا نستخدم الترميز الأحادي. الاطّلاع على حقل riceParameter

ملاحظة تاريخية: تم استخدام ترميز دلتا رايس لأول مرة في الإصدار 4 من واجهة برمجة التطبيقات هذه. في الإصدار 5، تم إجراء تحسينَين مهمَّين: أولاً، أصبح ترميز Rice-delta متاحًا الآن مع بادئات تجزئة أطول من 4 بايتات؛ ثانيًا، يتم الآن التعامل مع البيانات المرمّزة على أنّها big-endian لتجنُّب خطوة ترتيب مكلفة.

تمثيل JSON 
{
  "firstValue": integer,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
الحقول
firstValue

integer (uint32 format)

الإدخال الأول في البيانات المرمّزة (التجزئات أو الفهارس)، أو قيمة هذا الإدخال إذا تم ترميز بادئة تجزئة أو فهرس واحد فقط إذا كان الحقل فارغًا، تكون القيمة صفرًا.
riceParameter

integer

تمثّل هذه السمة مَعلمة Golomb-Rice. يُضمَن أن تكون هذه المَعلمة بين 3 و30، بما في ذلك هذان الرقمان.
entriesCount

integer

عدد الإدخالات التي تم تشفيرها باستخدام الترميز التفاضلي في البيانات المرمّزة إذا تم ترميز عدد صحيح واحد فقط، ستكون هذه القيمة صفرًا وسيتم تخزين القيمة الفردية في firstValue.
encodedData

string (bytes format)

القيم الدلتا المشفّرة التي تم تشفيرها باستخدام برنامج الترميز Golomb-Rice

سلسلة مرمّزة باستخدام Base64

‫RiceDeltaEncoded64Bit

هي نفسها RiceDeltaEncoded32Bit باستثناء أنّها ترمّز أرقامًا مؤلّفة من 64 بت.

تمثيل JSON 
{
  "firstValue": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
الحقول
firstValue

string

الإدخال الأول في البيانات المرمّزة (التجزئات)، أو قيمة هذا الإدخال إذا تم ترميز بادئة تجزئة واحدة فقط إذا كان الحقل فارغًا، تكون القيمة صفرًا.
riceParameter

integer

تمثّل هذه السمة مَعلمة Golomb-Rice. يُضمَن أن تكون هذه المَعلمة بين 35 و62، بما في ذلك هذان الرقمان.
entriesCount

integer

عدد الإدخالات التي تم تشفيرها باستخدام الترميز التفاضلي في البيانات المرمّزة إذا تم ترميز عدد صحيح واحد فقط، ستكون هذه القيمة صفرًا وسيتم تخزين القيمة الفردية في 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 العليا صفرًا.
firstValueLo

string (uint64 format)

تمثّل هذه السمة 64 بت السفلى من الإدخال الأول في البيانات المرمّزة (التجزئات). إذا كان الحقل فارغًا، تكون الـ 64 بت السفلى كلها أصفارًا.
riceParameter

integer

تمثّل هذه السمة مَعلمة Golomb-Rice. من المضمون أن تكون هذه المَعلمة بين 99 و126، بما في ذلك هذان الرقمان.
entriesCount

integer

عدد الإدخالات التي تم تشفيرها باستخدام الترميز التفاضلي في البيانات المرمّزة إذا تم ترميز عدد صحيح واحد فقط، ستكون هذه القيمة صفرًا وسيتم تخزين القيمة الفردية في 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 وحدة بت كلها أصفارًا.
firstValueSecondPart

string (uint64 format)

البتات من 65 إلى 128 من الإدخال الأول في البيانات المرمّزة (التجزئات) إذا كان الحقل فارغًا، تكون جميع البتات من 65 إلى 128 صفرًا.
firstValueThirdPart

string (uint64 format)

بتات من 129 إلى 192 من الإدخال الأول في البيانات المرمّزة (التجزئات) إذا كان الحقل فارغًا، تكون جميع البتات من 129 إلى 192 صفرًا.
firstValueFourthPart

string (uint64 format)

آخر 64 بت من الإدخال الأول في البيانات المرمّزة (التجزئات) إذا كان الحقل فارغًا، تكون آخر 64 بت كلها صفرًا.
riceParameter

integer

تمثّل هذه السمة مَعلمة Golomb-Rice. يُضمَن أن تتراوح قيمة هذه المَعلمة بين 227 و254، ضِمنًا.
entriesCount

integer

عدد الإدخالات التي تم تشفيرها باستخدام الترميز التفاضلي في البيانات المرمّزة إذا تم ترميز عدد صحيح واحد فقط، ستكون هذه القيمة صفرًا وسيتم تخزين القيمة الفردية في 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)

طول التجزئة المتوافق مع قائمة التجزئة هذه ستتيح كل قائمة تجزئة طولًا واحدًا فقط. في حال توفير طول تجزئة مختلف لمجموعة أنواع التهديدات أو أنواع المحتوى الآمن نفسها، سيتم توفيرها كقائمة منفصلة باسم مميز ومجموعة طول تجزئة خاصة بها.

ThreatType

أنواع التهديدات

عمليات التعداد
THREAT_TYPE_UNSPECIFIED نوع التهديد غير معروف. إذا تم عرض هذا الرمز من خلال الخادم، على البرنامج تجاهل FullHashDetail بالكامل.
MALWARE

نوع تهديد البرامج الضارة البرامج الضارّة هي أي تطبيق للأجهزة الجوّالة أو برنامج تم تصميمه خصيصًا لإلحاق الضرر بجهاز الكمبيوتر أو بالجهاز الجوّال أو ببرامج الجهاز أو بمستخدميه. وتُظهِر البرامج الضارة سلوكًا خبيثًا يمكن أن يشمل تثبيت برامج بدون موافقة المستخدم وتثبيت برامج ضارة، مثل الفيروسات.

يمكنك الاطّلاع على مزيد من المعلومات هنا.
SOCIAL_ENGINEERING

نوع تهديد الهندسة الاجتماعية تتظاهر صفحات الهندسة الاجتماعية بشكل زائف بأنّها تتصرّف نيابةً عن جهة خارجية بهدف تضليل المشاهدين وحثّهم على تنفيذ إجراء لا يثقون إلا في وكيل حقيقي لتلك الجهة الخارجية. التصيّد الاحتيالي هو نوع من الهندسة الاجتماعية يخدع المشاهد لحثّه على تنفيذ إجراء محدّد، مثل تقديم معلومات، مثل بيانات اعتماد تسجيل الدخول.

يمكنك الاطّلاع على مزيد من المعلومات هنا.
UNWANTED_SOFTWARE نوع التهديد الذي تمثله البرامج غير المرغوب فيها البرامج غير المرغوب فيها هي أي برامج لا تلتزم بمبادئ البرامج في Google ولكنّها ليست برامج ضارة.
POTENTIALLY_HARMFUL_APPLICATION نوع التهديد الذي تمثله التطبيقات التي قد تتسبّب بضرر كما تستخدمه خدمة "Google Play للحماية" في "متجر Play"

LikelySafeType

أنواع المواقع الإلكترونية التي يُحتمل أن تكون آمنة

يُرجى العِلم أنّ SearchHashesResponse لا يحتوي عمدًا على LikelySafeType.

عمليات التعداد
LIKELY_SAFE_TYPE_UNSPECIFIED غير معروف.
GENERAL_BROWSING من المحتمل أن يكون هذا الموقع الإلكتروني آمنًا بما يكفي لتصفّحه بشكل عام. يُعرف هذا أيضًا باسم ذاكرة التخزين المؤقت العامة.
CSD من المحتمل أن يكون هذا الموقع الإلكتروني آمنًا بما يكفي لعدم الحاجة إلى تشغيل نماذج "الرصد من جهة العميل" أو عمليات التحقّق من حماية كلمة المرور.
DOWNLOAD من المحتمل أنّ هذا الموقع الإلكتروني آمن بما يكفي لعدم الحاجة إلى التحقّق من عمليات التنزيل منه.

HashLength

طول التجزئات في قائمة التجزئات

عمليات التعداد
HASH_LENGTH_UNSPECIFIED طول غير محدّد
FOUR_BYTES كل تجزئة هي بادئة من أربعة بايتات.
EIGHT_BYTES كل تجزئة هي بادئة من ثمانية بايتات.
SIXTEEN_BYTES كل تجزئة هي بادئة مؤلفة من ستة عشر بايت.
THIRTY_TWO_BYTES كل قيمة تجزئة هي قيمة تجزئة كاملة تتألف من 32 بايت.

الطُرق

get

 تعرض هذه الطريقة أحدث محتوى لقائمة تجزئة.