Method: answerQuery

يجيب عن طلب بحث باستخدام الجيل المستند إلى البيانات.

طلب HTTP

POST https://developerknowledge.googleapis.com/v1:answerQuery

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "query": string
}
الحقول
query

string

الحقل مطلوب. طلب البحث الذي يجب الإجابة عنه

نص الاستجابة

رسالة الاستجابة لـ DeveloperKnowledge.AnswerQuery

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "answer": {
    object (Answer)
  }
}
الحقول
answer

object (Answer)

الإجابة عن طلب البحث

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

الإجابة

إجابة عن طلب بحث

تمثيل JSON 
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
الحقول
answerText

string

يحتوي على نص الإجابة.
citations[]

object (AnswerCitation)

هذه القيمة هي ناتج فقط. يحتوي على الاقتباسات للإجابة.
references[]

object (AnswerReference)

هذه القيمة هي ناتج فقط. يحتوي على مراجع للإجابة.

AnswerCitation

معلومات الاقتباس لجزء معيّن

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
الحقول
startIndex

integer

هذه القيمة هي ناتج فقط. يشير إلى بداية الجزء، ويتم قياسه بالبايت (Unicode بتنسيق UTF-8)، ويشمل هذا البايت. إذا كانت هناك أحرف متعددة البايت، مثل الأحرف بتنسيق غير ASCII، يكون قياس الفهرس أطول من طول السلسلة.
endIndex

integer

هذه القيمة هي ناتج فقط. يشير إلى نهاية الجزء، ويتم قياسه بالبايت (Unicode بتنسيق UTF-8)، ولا يشمل هذا البايت. إذا كانت هناك أحرف متعددة البايت، مثل الأحرف بتنسيق غير ASCII، يكون قياس الفهرس أطول من طول السلسلة.
sources[]

object (CitationSource)

هذه القيمة هي ناتج فقط. يحتوي على مصادر الاقتباس للجزء المنسوب.

CitationSource

مصدر الاقتباس

تمثيل JSON 
{
  "referenceIndex": integer
}
الحقول
referenceIndex

integer

هذه القيمة هي ناتج فقط. يحتوي على فهرس Answer.AnswerReference في الحقل المتكرّر references

AnswerReference

يمثّل مرجعًا لمصدر

تمثيل JSON 
{

  // Union field content can be only one of the following:
  "documentReference": {
    object (DocumentReference)
  }
  // End of list of possible types for union field content.
}
الحقول
حقل الربط content يحتوي على محتوى المرجع. لا يمكن أن يكون content إلا أحد الخيارات التالية:
documentReference

object (DocumentReference)

هذه القيمة هي ناتج فقط. المستند المرجعي

DocumentReference

يمثّل مرجعًا لمستند

تمثيل JSON 
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
الحقول
documentChunk

object (DocumentChunk)

هذه القيمة هي ناتج فقط. يحتوي على جزء المستند. لم يتم ضبط الحقل documentChunk.id وسيكون فارغًا.