GenerateContentResponse

استجابة من النموذج الذي يدعم عدة مرشحين.

ملاحظة حول تقييمات الأمان وفلترة المحتوى ويتم الإبلاغ عنها لكل من الطلب في GenerateContentResponse.prompt_feedback ولكل مرشّح في finishReason وفي safetyRatings. بموجب عقد واجهة برمجة التطبيقات: إما أنّه يتم إرجاع جميع المرشحين المطلوبين أو عدم إرجاع أي مرشحين على الإطلاق، لا يتم إرجاع أي مرشحين فقط في حال حدوث خطأ في الطلب (راجِع promptFeedback) - يتم الإبلاغ عن الملاحظات حول كل مرشح في finishReason وsafetyRatings.

تمثيل JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
الحقول
candidates[]

object (Candidate)

ردود المرشحين من النموذج
promptFeedback

object (PromptFeedback)

عرض ملاحظات الطلب ذات الصلة بفلاتر المحتوى
usageMetadata

object (UsageMetadata)

النتائج فقط. البيانات الوصفية حول استخدام الرمز المميّز لطلبات الإنشاء

PromptFeedback

مجموعة من البيانات الوصفية للملاحظات للطلب المحدّد في GenerateContentRequest.content.

تمثيل JSON 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
الحقول
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

إجمالي عدد الرموز المميّزة لطلب الإنشاء (الطلب + الطلبات المرشحة)