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

الزامی. رشته پرس‌وجوی خام ارائه شده توسط کاربر، مانند "چگونه یک مخزن ذخیره‌سازی ابری ایجاد کنیم؟" را ارائه می‌دهد. طول پرس‌وجو نباید از ۵۰۰ کاراکتر بیشتر باشد؛ مقادیر طولانی‌تر از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

pageSize

integer

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

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

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

pageToken

string

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

filter

string

اختیاری. یک فیلتر سختگیرانه بر روی نتایج جستجو اعمال می‌کند. این عبارت از زیرمجموعه‌ای از سینتکس شرح داده شده در https://google.aip.dev/160 پشتیبانی می‌کند.

در حالی که documents.searchDocumentChunks مقدار DocumentChunk برمی‌گرداند، فیلتر روی فیلدهای DocumentChunk.document اعمال می‌شود.

فیلدهای پشتیبانی شده برای فیلتر کردن:

  • content_length_bytes (INTEGER): طول فیلد Document.content بر حسب بایت.
  • data_source (STRING): منبع سند، مثلاً docs.cloud.google.com . برای فهرست کامل منابع داده در مجموعه داده به https://developers.google.com/knowledge/reference/corpus-reference مراجعه کنید.
  • update_time (TIMESTAMP): مهر زمانی آخرین به‌روزرسانی معنادار سند. به‌روزرسانی معنادار، به‌روزرسانی‌ای است که محتوای markdown یا فراداده سند را تغییر می‌دهد.
  • uri (رشته): آدرس اینترنتی سند، مثلاً https://docs.cloud.google.com/bigquery/docs/tables .

فیلدهای عدد صحیح از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند.

فیلدهای STRING از عملگرهای = (برابر) و != (نه برابر) برای تطبیق دقیق در کل رشته پشتیبانی می‌کنند. تطبیق جزئی، تطبیق پیشوندی و تطبیق عبارت منظم پشتیبانی نمی‌شوند.

فیلدهای TIMESTAMP از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند. مهرهای زمانی باید در قالب RFC-3339 باشند، مثلاً "2025-01-01T00:00:00Z" .

نکته: نام فیلدها باید به صورت snake_case باشد (مثلاً data_source ). مقادیر سمت راست عبارات فیلترینگ باید رشته‌ای باشند که بین دو علامت نقل قول قرار گرفته‌اند (مثلاً "docs.cloud.google.com" ).

شما می‌توانید عبارات را با استفاده از عملگرهای منطقی AND ، OR و NOT (یا - ) ترکیب کنید. OR اولویت بالاتری نسبت به AND دارد. برای گروه‌بندی اولویت‌دار صریح، از پرانتز استفاده کنید.

مثال‌ها:

  • فیلتر بر اساس Document.content_length_bytes : content_length_bytes < 50000
  • data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"
  • data_source != "firebase.google.com"
  • update_time < "2024-01-01T00:00:00Z"
  • update_time >= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

رشته filter نباید بیش از ۵۰۰ کاراکتر باشد؛ مقادیر بیش از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

درخواست بدنه

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

بدنه پاسخ

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

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

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

object ( DocumentChunk )

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

nextPageToken

string

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

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

به یکی از حوزه‌های 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 .

،

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

درخواست HTTP

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

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

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

پارامترها
query

string

الزامی. رشته پرس‌وجوی خام ارائه شده توسط کاربر، مانند "چگونه یک مخزن ذخیره‌سازی ابری ایجاد کنیم؟" را ارائه می‌دهد. طول پرس‌وجو نباید از ۵۰۰ کاراکتر بیشتر باشد؛ مقادیر طولانی‌تر از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

pageSize

integer

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

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

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

pageToken

string

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

filter

string

اختیاری. یک فیلتر سختگیرانه بر روی نتایج جستجو اعمال می‌کند. این عبارت از زیرمجموعه‌ای از سینتکس شرح داده شده در https://google.aip.dev/160 پشتیبانی می‌کند.

در حالی که documents.searchDocumentChunks مقدار DocumentChunk برمی‌گرداند، فیلتر روی فیلدهای DocumentChunk.document اعمال می‌شود.

فیلدهای پشتیبانی شده برای فیلتر کردن:

  • content_length_bytes (INTEGER): طول فیلد Document.content بر حسب بایت.
  • data_source (STRING): منبع سند، مثلاً docs.cloud.google.com . برای فهرست کامل منابع داده در مجموعه داده به https://developers.google.com/knowledge/reference/corpus-reference مراجعه کنید.
  • update_time (TIMESTAMP): مهر زمانی آخرین به‌روزرسانی معنادار سند. به‌روزرسانی معنادار، به‌روزرسانی‌ای است که محتوای markdown یا فراداده سند را تغییر می‌دهد.
  • uri (رشته): آدرس اینترنتی سند، مثلاً https://docs.cloud.google.com/bigquery/docs/tables .

فیلدهای عدد صحیح از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند.

فیلدهای STRING از عملگرهای = (برابر) و != (نه برابر) برای تطبیق دقیق در کل رشته پشتیبانی می‌کنند. تطبیق جزئی، تطبیق پیشوندی و تطبیق عبارت منظم پشتیبانی نمی‌شوند.

فیلدهای TIMESTAMP از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند. مهرهای زمانی باید در قالب RFC-3339 باشند، مثلاً "2025-01-01T00:00:00Z" .

نکته: نام فیلدها باید به صورت snake_case باشد (مثلاً data_source ). مقادیر سمت راست عبارات فیلترینگ باید رشته‌ای باشند که بین دو علامت نقل قول قرار گرفته‌اند (مثلاً "docs.cloud.google.com" ).

شما می‌توانید عبارات را با استفاده از عملگرهای منطقی AND ، OR و NOT (یا - ) ترکیب کنید. OR اولویت بالاتری نسبت به AND دارد. برای گروه‌بندی اولویت‌دار صریح، از پرانتز استفاده کنید.

مثال‌ها:

  • فیلتر بر اساس Document.content_length_bytes : content_length_bytes < 50000
  • data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"
  • data_source != "firebase.google.com"
  • update_time < "2024-01-01T00:00:00Z"
  • update_time >= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

رشته filter نباید بیش از ۵۰۰ کاراکتر باشد؛ مقادیر بیش از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

درخواست بدنه

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

بدنه پاسخ

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

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

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

object ( DocumentChunk )

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

nextPageToken

string

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

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

به یکی از حوزه‌های 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 .

،

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

درخواست HTTP

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

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

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

پارامترها
query

string

الزامی. رشته پرس‌وجوی خام ارائه شده توسط کاربر، مانند "چگونه یک مخزن ذخیره‌سازی ابری ایجاد کنیم؟" را ارائه می‌دهد. طول پرس‌وجو نباید از ۵۰۰ کاراکتر بیشتر باشد؛ مقادیر طولانی‌تر از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

pageSize

integer

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

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

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

pageToken

string

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

filter

string

اختیاری. یک فیلتر سختگیرانه بر روی نتایج جستجو اعمال می‌کند. این عبارت از زیرمجموعه‌ای از سینتکس شرح داده شده در https://google.aip.dev/160 پشتیبانی می‌کند.

در حالی که documents.searchDocumentChunks مقدار DocumentChunk برمی‌گرداند، فیلتر روی فیلدهای DocumentChunk.document اعمال می‌شود.

فیلدهای پشتیبانی شده برای فیلتر کردن:

  • content_length_bytes (INTEGER): طول فیلد Document.content بر حسب بایت.
  • data_source (STRING): منبع سند، مثلاً docs.cloud.google.com . برای فهرست کامل منابع داده در مجموعه داده به https://developers.google.com/knowledge/reference/corpus-reference مراجعه کنید.
  • update_time (TIMESTAMP): مهر زمانی آخرین به‌روزرسانی معنادار سند. به‌روزرسانی معنادار، به‌روزرسانی‌ای است که محتوای markdown یا فراداده سند را تغییر می‌دهد.
  • uri (رشته): آدرس اینترنتی سند، مثلاً https://docs.cloud.google.com/bigquery/docs/tables .

فیلدهای عدد صحیح از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند.

فیلدهای STRING از عملگرهای = (برابر) و != (نه برابر) برای تطبیق دقیق در کل رشته پشتیبانی می‌کنند. تطبیق جزئی، تطبیق پیشوندی و تطبیق عبارت منظم پشتیبانی نمی‌شوند.

فیلدهای TIMESTAMP از عملگرهای = ، < ، <= ، > و >= پشتیبانی می‌کنند. مهرهای زمانی باید در قالب RFC-3339 باشند، مثلاً "2025-01-01T00:00:00Z" .

نکته: نام فیلدها باید به صورت snake_case باشد (مثلاً data_source ). مقادیر سمت راست عبارات فیلترینگ باید رشته‌ای باشند که بین دو علامت نقل قول قرار گرفته‌اند (مثلاً "docs.cloud.google.com" ).

شما می‌توانید عبارات را با استفاده از عملگرهای منطقی AND ، OR و NOT (یا - ) ترکیب کنید. OR اولویت بالاتری نسبت به AND دارد. برای گروه‌بندی اولویت‌دار صریح، از پرانتز استفاده کنید.

مثال‌ها:

  • فیلتر بر اساس Document.content_length_bytes : content_length_bytes < 50000
  • data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"
  • data_source != "firebase.google.com"
  • update_time < "2024-01-01T00:00:00Z"
  • update_time >= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

رشته filter نباید بیش از ۵۰۰ کاراکتر باشد؛ مقادیر بیش از ۵۰۰ کاراکتر منجر به خطای INVALID_ARGUMENT می‌شوند.

درخواست بدنه

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

بدنه پاسخ

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

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

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

object ( DocumentChunk )

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

nextPageToken

string

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

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

به یکی از حوزه‌های 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 .