Method: hashLists.batchGet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على قوائم تجزئة متعددة في الوقت نفسه
من الشائع جدًا أن يحتاج العميل إلى الحصول على قوائم تجزئة متعددة. يُفضَّل استخدام هذه الطريقة بدلاً من استخدام طريقة Get العادية عدة مرات.
هذه طريقة الحصول على دُفعة عادية على النحو المحدّد في https://google.aip.dev/231، وطريقة HTTP هي أيضًا GET.
طلب HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات |
names[] |
string
مطلوب. تمثّل هذه السمة أسماء قوائم علامات التجزئة المحدّدة. قد تكون القائمة على شكل قائمة تهديدات أو قد تكون ذاكرة التخزين المؤقت العمومية. يجب ألا تحتوي الأسماء على تكرارات؛ فإذا حدث ذلك، فسيحصل العميل على خطأ.
|
version[] |
string (bytes format)
تمثّل هذه السمة إصدارات قائمة التجزئة المتوفّرة لدى العميل. إذا كانت هذه هي المرة الأولى التي يجلب فيها العميل قوائم علامات التجزئة، يجب ترك الحقل فارغًا. بخلاف ذلك، يجب على العميل توفير الإصدارات التي تم استلامها سابقًا من الخادم. يجب ألا يعالج العميل وحدات البايت هذه. لا يحتاج العميل إلى إرسال الإصدارات بنفس ترتيب أسماء القوائم المقابلة. ويمكن أن يرسل العميل نُسخًا أقل أو أكثر في الطلب من الأسماء. ومع ذلك، يجب ألا يرسل العميل نُسخًا متعددة تتوافق مع الاسم نفسه؛ فإذا حدث ذلك، فسيحصل العميل على خطأ. ملاحظة سابقة: في الإصدار 4 من واجهة برمجة التطبيقات، كان يُطلق على ذلك اسم states . تم تغيير تسميته الآن إلى version لمزيد من الوضوح. سلسلة بترميز base64.
|
desiredHashLength |
enum (HashLength )
يشير ذلك المصطلح إلى طول بادئة التجزئة المطلوبة للتجزئات المعروضة بالبايت. سيعرض الخادم جميع بادئات التجزئة بهذا الطول المحدد. يجب أن تستوفي قوائم التجزئة المختلفة متطلبات مختلفة بشأن القيم المقبولة للحقل desiredHashLength . ويمكن العثور على ذلك في الحقل supportedHashLengths في HashListMetadata . إذا لم يحدّد desiredHashLength قيمة داخل supportedHashLengths ، سيتم عرض خطأ للعملاء. بالنسبة إلى BatchGetHashListsRequest على وجه الخصوص، لا يمكن للعملاء تحديد desiredHashLength مختلف لقوائم مختلفة. وفي هذه الحالة، يجب تقسيم العميل إلى عدة BatchGetHashListsRequest .
|
sizeConstraints |
object (SizeConstraints )
قيود الحجم على كل قائمة. في حال حذفه، لن تُفرض أي قيود. تجدر الإشارة إلى أن الأحجام هنا تكون لكل قائمة، وليست مجمّعة عبر كل القوائم.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تمثّل هذه السمة الردّ الذي يحتوي على قوائم تجزئة متعدّدة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"hashLists": [
{
object (HashList )
}
]
} |
الحقول |
hashLists[] |
object (HashList )
قوائم التجزئة بالترتيب نفسه الوارد في الطلب
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-12 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)"]]