Method: documents.get

آخرین نسخه از سند مشخص شده را دریافت می‌کند.

درخواست HTTP

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

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

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

پارامترها
documentId

string

The ID of the document to retrieve.

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

پارامترها
suggestionsViewMode

enum ( SuggestionsViewMode )

The suggestions view mode to apply to the document. This allows viewing the document with all suggestions inline, accepted or rejected. If one is not specified, DEFAULT_FOR_CURRENT_ACCESS is used.

includeTabsContent

boolean

آیا فیلد Document.tabs به جای فیلدهای محتوای متن مانند body و documentStyle در Document پر شود یا خیر.

  • وقتی true : محتوای سند به جای فیلدهای محتوای متن در Document در فیلد Document.tabs قرار می‌گیرد.

  • وقتی false : محتوای اولین تب سند، فیلدهای محتوا در Document را به جز Document.tabs پر می‌کند. اگر سندی فقط یک تب داشته باشد، از آن تب برای پر کردن محتوای سند استفاده می‌شود. Document.tabs خالی خواهد بود.

اگر از یک ماسک فیلد استفاده کنید که به فیلد Document.tabs (یا هر زیرفیلد دیگری) ارجاع می‌دهد، API به طور ضمنی با درخواست طوری رفتار می‌کند که انگار includeTabsContent روی true تنظیم کرده‌اید.

commentsViewMode

enum ( CommentsViewMode )

حالت نمایش نظرات برای اعمال به سند. این حالت امکان مشاهده سند را با نظرات حذف شده یا اضافه شده فراهم می‌کند. اگر نظری مشخص نشده باشد، COMMENTS_VIEW_MODE_OMITTED استفاده می‌شود.

اگر commentsViewMode روی هر مقداری تنظیم کنید، باید includeTabsContent نیز روی true تنظیم کنید یا از یک ماسک فیلد استفاده کنید که به فیلد Document.tabs (یا هر زیرفیلدی) ارجاع دهد.

اگر commentsViewMode روی COMMENTS_VIEW_MODE_INCLUDED تنظیم کنید، باید suggestionsViewMode نیز صریحاً روی SUGGESTIONS_INLINE تنظیم کنید.

If you set commentsViewMode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS , you may not set suggestionsViewMode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED .

Request body

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

بدنه پاسخ

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

Authorization scopes

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

For more information, see the Authorization guide .