Method: documents.searchDocumentChunks

جستجوی دانش توسعه‌دهنده در اسناد توسعه‌دهندگان گوگل. بر اساس جستجوی کاربر، DocumentChunk ها را برمی‌گرداند. ممکن است تکه‌های زیادی از یک Document وجود داشته باشد. برای بازیابی اسناد کامل، DeveloperKnowledge.GetDocument یا DeveloperKnowledge.BatchGetDocuments با DocumentChunk.parent در SearchDocumentChunksResponse.results برگردانده شده است، استفاده کنید.

درخواست HTTP

GET https://developerknowledge.googleapis.com/v1alpha/documents:searchDocumentChunks

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
query

string

الزامی. رشته پرس‌وجوی خام ارائه شده توسط کاربر، مانند «چگونه یک مخزن ذخیره‌سازی ابری ایجاد کنیم؟» را ارائه می‌دهد.

pageSize

integer

اختیاری. حداکثر تعداد نتایجی که باید برگردانده شود را مشخص می‌کند. سرویس ممکن است کمتر از این مقدار را برگرداند.

اگر مشخص نشده باشد، حداکثر ۵ نتیجه برگردانده خواهد شد.

حداکثر مقدار ۲۰ است؛ مقادیر بالاتر از ۲۰ منجر به خطای INVALID_ARGUMENT می‌شوند.

pageToken

string

اختیاری. شامل یک نشانه صفحه است که از فراخوانی قبلی documents.searchDocumentChunks دریافت شده است. برای بازیابی صفحه بعدی، این را ارائه دهید.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پیام پاسخ برای DeveloperKnowledge.SearchDocumentChunks .

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ],
  "nextPageToken": string
}
فیلدها
results[]

object ( DocumentChunk )

شامل نتایج جستجو برای عبارت جستجو شده است. هر DocumentChunk در این لیست شامل یک قطعه از محتوای مرتبط با عبارت جستجو است. برای بازیابی محتوای کامل سند، از فیلد DocumentChunk.parent هر نتیجه به همراه DeveloperKnowledge.GetDocument یا DeveloperKnowledge.BatchGetDocuments استفاده کنید.

nextPageToken

string

اختیاری. یک توکن ارائه می‌دهد که می‌تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

دامنه‌های مجوز

Requires one of the following OAuth scopes:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

سندچانک

یک DocumentChunk نشان‌دهنده‌ی بخشی از محتوا از یک Document در مجموعه‌ی DeveloperKnowledge است. برای دریافت کل محتوای سند، parent به DeveloperKnowledge.GetDocument یا DeveloperKnowledge.BatchGetDocuments ارسال کنید.

نمایش JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
فیلدها
parent

string

فقط خروجی. شامل نام منبع سندی است که این قطعه از آن است. قالب: documents/{uri_without_scheme} مثال: documents/docs.cloud.google.com/storage/docs/creating-buckets

id

string

فقط خروجی. شناسه این قطعه را در سند مشخص می‌کند. شناسه قطعه در یک سند منحصر به فرد است، اما به صورت جهانی در بین اسناد منحصر به فرد نیست. شناسه قطعه پایدار نیست و ممکن است با گذشت زمان تغییر کند.

content

string

فقط خروجی. شامل محتوای بخش سند است.