- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات الأذونات
- الإجابة
- AnswerCitation
- CitationSource
- AnswerReference
- DocumentReference
يجيب عن طلب بحث باستخدام الجيل المستند إلى البيانات.
طلب HTTP
POST https://developerknowledge.googleapis.com/v1alpha:answerQuery
يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.
نص الطلب
يتضمن نص الطلب بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{ "query": string } |
| الحقول | |
|---|---|
query |
الحقل مطلوب. طلب البحث الذي يجب الإجابة عنه |
نص الاستجابة
رسالة الاستجابة لـ DeveloperKnowledge.AnswerQuery
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{
"answer": {
object ( |
| الحقول | |
|---|---|
answer |
الإجابة عن طلب البحث |
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/devprofiles.full_controlhttps://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
الإجابة
إجابة عن طلب بحث
| تمثيل JSON |
|---|
{ "answerText": string, "citations": [ { object ( |
| الحقول | |
|---|---|
answerText |
يحتوي على نص الإجابة. |
citations[] |
هذه القيمة هي ناتج فقط. يحتوي على الاقتباسات للإجابة. |
references[] |
هذه القيمة هي ناتج فقط. يحتوي على مراجع للإجابة. |
AnswerCitation
معلومات الاقتباس لشريحة
| تمثيل JSON |
|---|
{
"startIndex": integer,
"endIndex": integer,
"sources": [
{
object ( |
| الحقول | |
|---|---|
startIndex |
هذه القيمة هي ناتج فقط. يشير إلى بداية الشريحة، ويتم قياسها بالبايت (Unicode بتنسيق UTF-8)، بما في ذلك البايت الأول. إذا كانت هناك أحرف متعددة البايتات، مثل الأحرف بتنسيق غير ASCII، يكون قياس الفهرس أطول من طول السلسلة. |
endIndex |
هذه القيمة هي ناتج فقط. يشير إلى نهاية الشريحة، ويتم قياسها بالبايت (Unicode بتنسيق UTF-8)، باستثناء البايت الأخير. إذا كانت هناك أحرف متعددة البايتات، مثل الأحرف بتنسيق غير ASCII، يكون قياس الفهرس أطول من طول السلسلة. |
sources[] |
هذه القيمة هي ناتج فقط. يحتوي على مصادر الاقتباس للشريحة المنسوبة. |
CitationSource
مصدر الاقتباس
| تمثيل JSON |
|---|
{ "referenceIndex": integer } |
| الحقول | |
|---|---|
referenceIndex |
هذه القيمة هي ناتج فقط. يحتوي على فهرس |
AnswerReference
يمثّل مرجعًا لمصدر
| تمثيل JSON |
|---|
{ // Union field |
| الحقول | |
|---|---|
حقل الربط content يحتوي على محتوى المرجع. لا يمكن أن يكون content إلا أحد الخيارات التالية: |
|
documentReference |
هذه القيمة هي ناتج فقط. المستند المرجعي |
DocumentReference
يمثّل مرجعًا لمستند
| تمثيل JSON |
|---|
{
"documentChunk": {
object ( |
| الحقول | |
|---|---|
documentChunk |
هذه القيمة هي ناتج فقط. يحتوي على شريحة المستند. لم يتم ضبط الحقل |