Method: documents.batchGet

يستردّ هذا الإجراء مستندات متعددة، يحتوي كل منها على محتوى Markdown الكامل.

طلب HTTP

GET https://developerknowledge.googleapis.com/v1/documents:batchGet

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

مَعلمات طلب البحث

المَعلمات
names[]

string

الحقل مطلوب. تحدّد هذه السمة أسماء المستندات المطلوب استردادها. يمكن استرداد 20 مستندًا كحد أقصى في دفعة واحدة. يتم عرض المستندات بالترتيب نفسه الذي يظهر به names في الطلب.

التنسيق: documents/{uri_without_scheme} مثال: documents/docs.cloud.google.com/storage/docs/creating-buckets
view

enum (DocumentView)

اختياريّ. تحدّد هذه السمة DocumentView المستند. إذا لم يتم تحديدها، تكون القيمة التلقائية لـ DeveloperKnowledge.BatchGetDocuments هي DOCUMENT_VIEW_CONTENT.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على DeveloperKnowledge.BatchGetDocuments

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

تمثيل JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
الحقول
documents[]

object (Document)

يحتوي على المستندات المطلوبة.

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

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

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

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