Method: documents.get

تعرض هذه الطريقة أحدث إصدار من المستند المحدّد.

طلب HTTP

GET https://docs.googleapis.com/v1/documents/{documentId}

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

مَعلمات المسار

المعلمات
documentId

string

معرّف المستند المطلوب استرداده

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

المعلمات
suggestionsViewMode

enum (SuggestionsViewMode)

وضع عرض الاقتراحات الذي سيتم تطبيقه على المستند. يتيح ذلك عرض المستند مع جميع الاقتراحات المضمّنة، سواء تم قبولها أو رفضها. إذا لم يتم تحديد أيّ منها، يتم استخدام DEFAULT_FOR_CURRENT_ACCESS.

includeTabsContent

boolean

تحديد ما إذا كان سيتم ملء الحقل Document.tabs بدلاً من حقول المحتوى النصي، مثل body وdocumentStyle، على Document

  • عندما تكون القيمة True: يتم ملء حقل Document.tabs بمحتوى المستند بدلاً من حقول المحتوى النصي في Document.

  • عندما تكون القيمة False: تتم تعبئة حقول المحتوى في Document بمحتوى علامة التبويب الأولى في المستند، باستثناء Document.tabs. إذا كان المستند يحتوي على علامة تبويب واحدة فقط، يتم استخدام علامة التبويب هذه لتعبئة محتوى المستند. سيكون الحقل Document.tabs فارغًا.

commentsViewMode

enum (CommentsViewMode)

وضع عرض التعليقات الذي سيتم تطبيقه على المستند. يتيح ذلك عرض المستند مع إغفال التعليقات أو تضمينها. إذا لم يتم تحديد أيّ منها، يتم استخدام COMMENTS_VIEW_MODE_OMITTED.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Document.

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

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

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/documents.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.