الطريقة: model.generateContent
تنشئ هذه الدالة استجابة من النموذج استنادًا إلى إدخال GenerateContentRequest
.
تختلف إمكانات الإدخال بين النماذج، بما في ذلك النماذج التي تم ضبطها. لمعرفة التفاصيل، يمكنك الاطّلاع على دليل النماذج ودليل الضبط.
نقطة نهاية
منشور
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
مَعلمات المسار
model
string
مطلوب. اسم Model
المطلوب استخدامه لإنشاء الإكمال.
التنسيق: name=models/{model}
ويكون على النحو models/{model}
.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
contents[]
object (Content
)
مطلوب. محتوى المحادثة الحالية مع النموذج.
بالنسبة إلى طلبات البحث الأحادية الاتجاه، هذا مجرد مثيل واحد. بالنسبة إلى طلبات البحث المتعددة الأدوار، هذا حقل متكرّر يحتوي على سجلّ المحادثات وآخر طلب.
tools[]
object (Tool
)
اختياريّ. قائمة بـ Tools
التي قد يستخدمها النموذج لإنشاء الرد التالي.
Tool
هو جزء من الرمز البرمجي يتيح للنظام التفاعل مع الأنظمة الخارجية لتنفيذ إجراء أو مجموعة إجراءات خارج نطاق المعرفة ونطاق النموذج. الأداة الوحيدة المتوافقة هي حاليًا Function
.
toolConfig
object (ToolConfig
)
اختياريّ. إعداد الأداة لأي Tool
محدد في الطلب.
safetySettings[]
object (SafetySetting
)
اختياريّ. قائمة بمثيلات SafetySetting
الفريدة لحظر المحتوى غير الآمن.
وسيتم فرض ذلك على GenerateContentRequest.contents
وGenerateContentResponse.candidates
. يجب ألا يكون هناك أكثر من إعداد واحد لكل نوع SafetyCategory
. ستحظر واجهة برمجة التطبيقات أي محتوى واستجابات لا تستوفي الحدود الدنيا التي حدّدتها هذه الإعدادات. تلغي هذه القائمة الإعدادات التلقائية لكل SafetyCategory
محدّدة في "إعدادات الأمان". في حال عدم توفّر SafetySetting
لعنصر SafetyCategory
معيّن في القائمة، ستستخدم واجهة برمجة التطبيقات إعداد الأمان التلقائي لهذه الفئة. فئات الضرر HARM_CATEGORY_HATE_SPEECH وHARM_CATEGORY_SEXUALLY_EXPLICIT وHARM_CATEGORY_DANGEROUS_CONTENT وHARM_CATEGORY_HARASSMENT متاحة.
systemInstruction
object (Content
)
اختياريّ. تعليمات بشأن ضبط النظام من قِبل المطوّر وهي متاحة حاليًا عبر الرسائل النصية فقط.
generationConfig
object (GenerationConfig
)
اختياريّ. خيارات الضبط لإنشاء النماذج والنتائج
cachedContent
string
اختياريّ. اسم المحتوى المخزَّن مؤقتًا كسياق لعرض التوقّع. ملاحظة: لا تُستخدم هذه الواجهة إلّا في التخزين المؤقت الصريح، حيث يمكن للمستخدمين التحكّم في التخزين المؤقت (مثل المحتوى المطلوب تخزينه مؤقتًا) والاستفادة من توفير مضمون من التكاليف. تنسيق الملف: cachedContents/{cachedContent}
مثال على الطلب
النص
Python
Node.js
Kotlin
Swift
Dart
Java
صورة
Python
Node.js
Kotlin
Swift
Dart
Java
الصوت
Python
Node.js
فيديو
Python
Node.js
دردشة
Python
Node.js
صَدفة
Kotlin
Swift
Dart
Java
ذاكرة التخزين المؤقت
Python
Node.js
نموذج تم ضبطه
Python
وضع JSON
Python
Node.js
Kotlin
Swift
Dart
Java
تنفيذ الرمز البرمجي
Python
Kotlin
Java
استدعاء الدالة
Python
Node.js
Kotlin
Swift
Dart
Java
إعدادات الإنشاء
Python
Node.js
صَدفة
Kotlin
Swift
Dart
Java
إعدادات الأمان
Python
Node.js
صَدفة
Kotlin
Swift
Dart
Java
تعليمات النظام
Python
Node.js
Kotlin
Swift
Dart
Java
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال GenerateContentResponse
.
الطريقة: model.streamGenerateContent
إنشاء رد متدفق من النموذج الذي يتم إدخاله في الحقل GenerateContentRequest
نقطة نهاية
منشور
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:streamGenerateContent
مَعلمات المسار
model
string
مطلوب. اسم Model
المطلوب استخدامه لإنشاء الإكمال.
التنسيق: name=models/{model}
ويكون على النحو models/{model}
.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
contents[]
object (Content
)
مطلوب. محتوى المحادثة الحالية مع النموذج.
بالنسبة إلى طلبات البحث الأحادية الاتجاه، هذا مجرد مثيل واحد. بالنسبة إلى طلبات البحث المتعددة الأدوار، هذا حقل متكرّر يحتوي على سجلّ المحادثات وآخر طلب.
tools[]
object (Tool
)
اختياريّ. قائمة بـ Tools
التي قد يستخدمها النموذج لإنشاء الرد التالي.
Tool
هو جزء من الرمز البرمجي يتيح للنظام التفاعل مع الأنظمة الخارجية لتنفيذ إجراء أو مجموعة إجراءات خارج نطاق المعرفة ونطاق النموذج. الأداة الوحيدة المتوافقة هي حاليًا Function
.
toolConfig
object (ToolConfig
)
اختياريّ. إعداد الأداة لأي Tool
محدد في الطلب.
safetySettings[]
object (SafetySetting
)
اختياريّ. قائمة بمثيلات SafetySetting
الفريدة لحظر المحتوى غير الآمن.
وسيتم فرض ذلك على GenerateContentRequest.contents
وGenerateContentResponse.candidates
. يجب ألا يكون هناك أكثر من إعداد واحد لكل نوع SafetyCategory
. ستحظر واجهة برمجة التطبيقات أي محتوى واستجابات لا تستوفي الحدود الدنيا التي حدّدتها هذه الإعدادات. تلغي هذه القائمة الإعدادات التلقائية لكل SafetyCategory
محدّدة في "إعدادات الأمان". في حال عدم توفّر SafetySetting
لعنصر SafetyCategory
معيّن في القائمة، ستستخدم واجهة برمجة التطبيقات إعداد الأمان التلقائي لهذه الفئة. فئات الضرر HARM_CATEGORY_HATE_SPEECH وHARM_CATEGORY_SEXUALLY_EXPLICIT وHARM_CATEGORY_DANGEROUS_CONTENT وHARM_CATEGORY_HARASSMENT متاحة.
systemInstruction
object (Content
)
اختياريّ. تعليمات بشأن ضبط النظام من قِبل المطوّر وهي متاحة حاليًا عبر الرسائل النصية فقط.
generationConfig
object (GenerationConfig
)
اختياريّ. خيارات الضبط لإنشاء النماذج والنتائج
cachedContent
string
اختياريّ. اسم المحتوى المخزَّن مؤقتًا كسياق لعرض التوقّع. ملاحظة: لا تُستخدم هذه الواجهة إلّا في التخزين المؤقت الصريح، حيث يمكن للمستخدمين التحكّم في التخزين المؤقت (مثل المحتوى المطلوب تخزينه مؤقتًا) والاستفادة من توفير مضمون من التكاليف. تنسيق الملف: cachedContents/{cachedContent}
مثال على الطلب
النص
Python
Node.js
Kotlin
Swift
Dart
Java
صورة
Python
Node.js
Kotlin
Swift
Dart
Java
فيديو
Python
Node.js
Kotlin
Java
دردشة
Python
Node.js
صَدفة
Kotlin
Swift
Dart
Java
نص الاستجابة
في حال النجاح، يحتوي نص الاستجابة على سلسلة من GenerateContentResponse
أمثلة.
GenerateContentResponse
استجابة من النموذج الذي يدعم عدة مرشحين.
ملاحظة حول تقييمات الأمان وفلترة المحتوى ويتم الإبلاغ عنها لكل من الطلب في GenerateContentResponse.prompt_feedback
ولكل مرشّح في finishReason
وفي safetyRatings
. بموجب عقد واجهة برمجة التطبيقات: إما أنّه يتم إرجاع جميع المرشحين المطلوبين أو عدم إرجاع أي مرشحين على الإطلاق، لا يتم إرجاع أي مرشحين فقط في حال حدوث خطأ في الطلب (راجِع promptFeedback
) - يتم الإبلاغ عن الملاحظات حول كل مرشح في finishReason
وsafetyRatings
.
تمثيل JSON |
---|
{ "candidates": [ { object ( |
candidates[]
object (Candidate
)
ردود المرشحين من النموذج
promptFeedback
object (PromptFeedback
)
عرض ملاحظات الطلب ذات الصلة بفلاتر المحتوى
usageMetadata
object (UsageMetadata
)
النتائج فقط. البيانات الوصفية حول طلبات الإنشاء' استخدام الرمز المميز.
PromptFeedback
مجموعة من البيانات الوصفية للملاحظات للطلب المحدّد في GenerateContentRequest.content
.
تمثيل JSON |
---|
{ "blockReason": enum ( |
blockReason
enum (BlockReason
)
اختياريّ. وفي حال ضبطها، تم حظر الطلب ولن يتم عرض أي مرشحات. أعِد صياغة طلبك.
safetyRatings[]
object (SafetyRating
)
التقييمات للتأكّد من أمان الطلب يتوفّر تقييم واحد كحدّ أقصى لكل فئة.
BlockReason
تحدّد هذه السياسة سبب حظر الطلب.
عمليات التعداد | |
---|---|
BLOCK_REASON_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدمة. |
SAFETY |
تم حظر الطلب لأسباب تتعلق بالسلامة. يمكنك فحص "safetyRatings " لمعرفة فئة الأمان التي حظرته. |
OTHER |
تم حظر الطلب لأسباب غير معروفة. |
UsageMetadata
البيانات الوصفية المتعلقة باستخدام الرمز المميّز لطلب الإنشاء
تمثيل JSON |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
promptTokenCount
integer
عدد الرموز المميّزة في الطلب عند ضبط cacheContent، يبقى هذا هو إجمالي حجم الطلب الفعال. بعبارة أخرى، وهذا يشمل عدد الرموز المميزة في المحتوى المخزن مؤقتًا.
cachedContentTokenCount
integer
عدد الرموز المميّزة في الجزء المخزّن مؤقتًا من الطلب، أي في المحتوى المخزّن مؤقتًا
candidatesTokenCount
integer
إجمالي عدد الرموز المميّزة على مستوى العناصر المحفّزة لعرض الإعلان
totalTokenCount
integer
إجمالي عدد الرموز المميّزة لطلب الإنشاء (الطلب + الطلبات المرشحة)
مرشح
- تمثيل JSON
- FinishReason
- GroundingAttribution
- AttributionSourceId
- GroundingPassageId
- SemanticRetrieverChunk
مرشّح للرد تم إنشاؤه من النموذج
تمثيل JSON |
---|
{ "content": { object ( |
content
object (Content
)
النتائج فقط. المحتوى الذي تم إنشاؤه وتم عرضه من النموذج
finishReason
enum (FinishReason
)
اختياريّ. النتائج فقط. سبب توقّف النموذج عن إنشاء الرموز المميّزة
وإذا كانت فارغة، هذا يعني أنّ النموذج لم يتوقف عن إنشاء الرموز المميّزة.
safetyRatings[]
object (SafetyRating
)
قائمة التقييمات الخاصة بأمان أحد المرشّحين للرد
يتوفّر تقييم واحد كحدّ أقصى لكل فئة.
citationMetadata
object (CitationMetadata
)
النتائج فقط. معلومات الاقتباس للمرشح الذي تم إنشاؤه من خلال النموذج
يمكن تعبئة هذا الحقل بمعلومات الإشادة لأي نص مضمّن في content
. هذه الفقرات التي يتم "تلائتها" من المواد المحمية بموجب حقوق الطبع والنشر في البيانات التدريبية الأساسية للنموذج اللغوي الكبير (LLM).
tokenCount
integer
النتائج فقط. عدد الرموز المميّزة لهذا المرشح.
groundingAttributions[]
object (GroundingAttribution
)
النتائج فقط. يشير ذلك المصطلح إلى معلومات عن تحديد المصدر للمصادر التي ساهمت في تقديم إجابة وافية.
تتم تعبئة هذا الحقل لمكالمات GenerateAnswer
.
index
integer
النتائج فقط. فهرس المرشّح في قائمة المرشحين.
FinishReason
تحدد هذه السمة سبب توقّف النموذج عن إنشاء رموز مميّزة.
عمليات التعداد | |
---|---|
FINISH_REASON_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدمة. |
STOP |
نقطة التوقّف الطبيعية للنموذج أو تسلسل التوقّف المُقدّم. |
MAX_TOKENS |
تم الوصول إلى الحدّ الأقصى لعدد الرموز المميّزة على النحو المحدّد في الطلب. |
SAFETY |
تم الإبلاغ عن المحتوى المرشّح لأسباب تتعلّق بالأمان. |
RECITATION |
تم الإبلاغ عن المحتوى المرشّح لأغراض القراءة. |
LANGUAGE |
تم الإبلاغ عن المحتوى المرشّح بسبب استخدام لغة غير متاحة. |
OTHER |
السبب غير معروف. |
GroundingAttribution
تحديد المصدر الذي ساهم في الحصول على إجابة
تمثيل JSON |
---|
{ "sourceId": { object ( |
sourceId
object (AttributionSourceId
)
النتائج فقط. معرّف للمصدر الذي يساهم في عملية تحديد المصدر هذه.
content
object (Content
)
يشير إلى محتوى المصدر الأساسي الذي يتألّف من عملية تحديد المصدر.
AttributionSourceId
معرّف للمصدر الذي يساهم في عملية تحديد المصدر هذه.
تمثيل JSON |
---|
{ // Union field |
حقل الاتحاد source
.
يمكن أن يكون source
واحدًا فقط مما يلي:
groundingPassage
object (GroundingPassageId
)
معرّف لفقرة مضمّنة.
semanticRetrieverChunk
object (SemanticRetrieverChunk
)
تم استرجاع معرّف Chunk
عبر أداة الاسترجاع الدلالي.
GroundingPassageId
معرّف لجزء داخل GroundingPassage
تمثيل JSON |
---|
{ "passageId": string, "partIndex": integer } |
passageId
string
النتائج فقط. رقم تعريف فقرة مطابقة لـ GroundingPassage.id
في GenerateAnswerRequest
partIndex
integer
النتائج فقط. فهرس الجزء ضمن GroundingPassage.content
في GenerateAnswerRequest
.
SemanticRetrieverChunk
تم استرداد معرِّف Chunk
عبر أداة استرداد الدلالات الدلالية المحدّدة في GenerateAnswerRequest
باستخدام SemanticRetrieverConfig
.
تمثيل JSON |
---|
{ "source": string, "chunk": string } |
source
string
النتائج فقط. اسم المصدر الذي يتطابق مع SemanticRetrieverConfig.source
للطلب مثال: corpora/123
أو corpora/123/documents/abc
chunk
string
النتائج فقط. اسم Chunk
الذي يحتوي على النص الذي تم تحديد مصدره. مثلاً: corpora/123/documents/abc/chunks/xyz
CitationMetadata
يشير ذلك المصطلح إلى مجموعة من عمليات تحديد المصدر الخاصة بجزء من المحتوى.
تمثيل JSON |
---|
{
"citationSources": [
{
object ( |
citationSources[]
object (CitationSource
)
الاقتباسات من مصادر ردّ محدّد
CitationSource
يشير إلى الاقتباس من مصدر لجزء من ردّ محدّد.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
startIndex
integer
اختياريّ. بداية شريحة الردّ المنسوبة إلى هذا المصدر
يشير المؤشر إلى بداية المقطع، ويتم قياسه بالبايت.
endIndex
integer
اختياريّ. نهاية المقطع الذي تم تحديد مصدره حصريًا.
uri
string
اختياريّ. هو معرّف موارد منتظم (URI) المنسوبة إليه كمصدر لجزء من النص.
license
string
اختياريّ. ترخيص مشروع GitHub الذي تم تحديده كمصدر للقسم
يجب إدخال معلومات الترخيص عند الاقتباس من الرموز.
GenerationConfig
خيارات الضبط لإنشاء النماذج والنتائج قد لا تكون كل المعلمات قابلة للتهيئة لكل نموذج.
تمثيل JSON |
---|
{
"stopSequences": [
string
],
"responseMimeType": string,
"responseSchema": {
object ( |
stopSequences[]
string
اختياريّ. تمثّل هذه السمة مجموعة تسلسلات الأحرف (ما يصل إلى 5) التي توقِف إنشاء النتائج. وفي حال تحديده، ستتوقّف واجهة برمجة التطبيقات عند أول ظهور لتسلسل محطات التوقف. ولن يتمّ تضمين تسلسل المحطة كجزء من الردّ.
responseMimeType
string
اختياريّ. نوع MIME لاستجابة الإخراج للنص المرشح الذي تم إنشاؤه. نوع mimetype المتوافق: text/plain
: إخراج النص (تلقائي) application/json
: استجابة JSON في العناصر المرشحة
responseSchema
object (Schema
)
اختياريّ. مخطَّط استجابة الإخراج للنص المرشح الذي تم إنشاؤه عندما يمكن أن يحتوي نوع MIME للاستجابة على مخطط. يمكن أن يكون المخطط كائنات أو عناصر أولية أو مصفوفات وهو مجموعة فرعية من مخطط OpenAPI.
في حال ضبطها، يجب أيضًا ضبط قيمة responseMimeType متوافقة. أنواع Mimetype المتوافقة: application/json
: مخطط لاستجابة JSON.
candidateCount
integer
اختياريّ. عدد الردود التي تم إنشاؤها لعرضها.
في الوقت الحالي، يمكن ضبط هذه القيمة على 1 فقط. في حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على 1.
maxOutputTokens
integer
اختياريّ. الحد الأقصى لعدد الرموز المميّزة المطلوب تضمينها في عنصر مرشح.
ملاحظة: تختلف القيمة التلقائية حسب النموذج، ويمكنك الاطّلاع على السمة Model.output_token_limit
لـ Model
التي يتم عرضها من الدالة getModel
.
temperature
number
اختياريّ. تتحكّم هذه السياسة في التوزيع العشوائي للمخرج.
ملاحظة: تختلف القيمة التلقائية حسب النموذج، ويمكنك الاطّلاع على السمة Model.temperature
لـ Model
التي يتم عرضها من الدالة getModel
.
يمكن أن تتراوح القيم من [0.0، 2.0].
topP
number
اختياريّ. يشير ذلك المصطلح إلى الحد الأقصى للاحتمالية التراكمية للرموز المميّزة التي يجب أخذها في الاعتبار عند جمع العيّنات.
يستخدم النموذج أخذ عينات من عينات عشوائية وخوارزمية النواة.
يتم ترتيب الرموز المميّزة استنادًا إلى الاحتمالات المحدّدة لها، لكي يتم أخذ الرموز الأكثر احتمالاً فقط في الاعتبار. ويحدّ أخذ العينات من المستوى الأعلى (K) مباشرةً من الحدّ الأقصى لعدد الرموز المميّزة التي يجب أخذها في الاعتبار، في حين أنّ أخذ العينات من النواة يحدّ من عدد الرموز المميّزة استنادًا إلى الاحتمالية التراكمية.
ملاحظة: تختلف القيمة التلقائية حسب النموذج، ويمكنك الاطّلاع على السمة Model.top_p
لـ Model
التي يتم عرضها من الدالة getModel
.
topK
integer
اختياريّ. يشير ذلك المصطلح إلى الحد الأقصى لعدد الرموز المميّزة التي يجب أخذها في الاعتبار عند جمع العيّنات.
تستخدم النماذج أخذ العيّنات النواة أو أخذ العيّنات النواة من المستوى الأعلى والنواة معًا. وفي أخذ العيّنات الأعلى درجة في الاعتبار، يتم جمع topK
من الرموز المميّزة الأكثر ترجيحًا. لا تسمح النماذج التي تعمل باستخدام عينات النواة بإعداد أعلىK.
ملاحظة: تختلف القيمة التلقائية حسب النموذج، ويمكنك الاطّلاع على السمة Model.top_k
لـ Model
التي يتم عرضها من الدالة getModel
. يشير الحقل topK
الفارغ في Model
إلى أنّ النموذج لا يطبّق أخذ العيّنات للأعلى ولا يسمح بإعداد topK
على الطلبات.
HarmCategory
فئة التقييم.
تتناول هذه الفئات أنواعًا مختلفة من الأضرار التي قد يرغب المطوّرون في تعديلها.
عمليات التعداد | |
---|---|
HARM_CATEGORY_UNSPECIFIED |
لم يتم تحديد الفئة. |
HARM_CATEGORY_DEROGATORY |
تعليقات سلبية أو ضارة تستهدف الهوية و/أو السمة المحمية |
HARM_CATEGORY_TOXICITY |
محتوى فظ أو مُهين أو مكتوب بلغة نابية |
HARM_CATEGORY_VIOLENCE |
تصف السيناريوهات التي تصور العنف ضد فرد أو جماعة، أو أوصافًا عامة للمحتوى الدموي. |
HARM_CATEGORY_SEXUAL |
يحتوي على إشارات إلى أفعال جنسية أو محتوى بذيء آخر. |
HARM_CATEGORY_MEDICAL |
يروّج للنصائح الطبية التي لم يتم التحقّق منها |
HARM_CATEGORY_DANGEROUS |
المحتوى الخطير الذي يروّج لأفعال ضارّة أو يسهّل تنفيذها أو يشجّع عليها |
HARM_CATEGORY_HARASSMENT |
المحتوى الذي يهدف إلى المضايقة: |
HARM_CATEGORY_HATE_SPEECH |
المحتوى والكلام الذي يحض على الكراهية: |
HARM_CATEGORY_SEXUALLY_EXPLICIT |
المحتوى الجنسي الفاضح: |
HARM_CATEGORY_DANGEROUS_CONTENT |
المحتوى الخطير: |
SafetyRating
تقييم الأمان لجزء من المحتوى
يتضمّن تقييم الأمان فئة الضرر ومستوى احتمالية الضرر في تلك الفئة لجزء من المحتوى. ويتم تصنيف المحتوى للحفاظ على السلامة ضمن عدد من فئات الضرر، وقد تم إدراج احتمالية وقوعه هنا.
تمثيل JSON |
---|
{ "category": enum ( |
category
enum (HarmCategory
)
مطلوب. فئة هذا التقييم.
probability
enum (HarmProbability
)
مطلوب. احتمالية الضرر لهذا المحتوى.
blocked
boolean
هل تم حظر هذا المحتوى بسبب هذا التقييم؟
HarmProbability
يشير ذلك المصطلح إلى احتمالية أن يكون جزء من المحتوى ضارًا.
يمنح نظام التصنيف احتمالية أن يكون المحتوى غير آمن. ولا يشير ذلك إلى خطورة الضرر الناتج عن محتوى معيّن.
عمليات التعداد | |
---|---|
HARM_PROBABILITY_UNSPECIFIED |
لم يتم تحديد الاحتمال. |
NEGLIGIBLE |
إن فرصة المحتوى غير آمنة ضئيلة. |
LOW |
إنّ احتمال أن يصبح المحتوى غير آمن بنسبة منخفضة. |
MEDIUM |
هناك احتمال متوسط بأن يكون المحتوى غير آمن. |
HIGH |
هناك احتمال كبير بأن يكون المحتوى غير آمن. |
SafetySetting
إعداد الأمان الذي يؤثر في سلوك حظر الأمان.
يؤدي ضبط إعداد الأمان لفئة معيّنة إلى تغيير الاحتمالية المسموح بحظر المحتوى.
تمثيل JSON |
---|
{ "category": enum ( |
category
enum (HarmCategory
)
مطلوب. الفئة لهذا الإعداد.
threshold
enum (HarmBlockThreshold
)
مطلوب. تتحكّم هذه السياسة في حدّ الاحتمال الذي يتم عنده حظر الضرر.
HarmBlockThreshold
الحظر عند احتمال الضرر المحدد أو تجاوزه
عمليات التعداد | |
---|---|
HARM_BLOCK_THRESHOLD_UNSPECIFIED |
الحدّ غير محدَّد. |
BLOCK_LOW_AND_ABOVE |
سيتم السماح بعرض المحتوى الذي يتضمن NEGLIGIBLE. |
BLOCK_MEDIUM_AND_ABOVE |
سيتم السماح بعرض المحتوى الذي يتضمن NEGLIGIBLE وLOW. |
BLOCK_ONLY_HIGH |
سيُسمَح بعرض المحتوى الذي يتضمّن NEGLIGIBLE وLOW وMEDIUM. |
BLOCK_NONE |
سيتم السماح بكل المحتوى. |