Method: documents.get

Pobiera najnowszą wersję określonego dokumentu.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
documentId

string

Identyfikator dokumentu do pobrania.

Parametry zapytania

Parametry
suggestionsViewMode

enum (SuggestionsViewMode)

Tryb wyświetlania sugestii, który ma być stosowany w dokumencie. Umożliwia wyświetlanie dokumentu ze wszystkimi sugestiami w tekście, zaakceptowanymi lub odrzuconymi. Jeśli nie zostanie określony, używany jest tryb DEFAULT_FOR_CURRENT_ACCESS.

includeTabsContent

boolean

Określa, czy zamiast pól treści tekstowej, takich jak body i documentStyle, w elemencie Document ma być wypełniane pole Document.tabs.

  • Gdy wartość to true: treść dokumentu jest wypełniana w polu Document.tabs zamiast w polach treści tekstowej w elemencie Document.

  • Gdy wartość to false: treść pierwszej karty dokumentu wypełnia pola treści w elemencie Document z wyłączeniem pola Document.tabs. Jeśli dokument ma tylko jedną kartę, jest ona używana do wypełniania treści dokumentu. Document.tabs będzie puste.

Jeśli używasz maski pola, która odwołuje się do pola Document.tabs (lub dowolnego podpola), interfejs API traktuje żądanie tak, jakby ustawiono wartość true w polu includeTabsContent.

commentsViewMode

enum (CommentsViewMode)

Tryb wyświetlania komentarzy, który ma być stosowany w dokumencie. Umożliwia wyświetlanie dokumentu z pominiętymi lub uwzględnionymi komentarzami. Jeśli nie zostanie określony, używany jest tryb COMMENTS_VIEW_MODE_OMITTED.

Jeśli ustawisz wartość commentsViewMode, musisz też ustawić wartość true w polu includeTabsContent lub użyć maski pola, która odwołuje się do pola Document.tabs (lub dowolnego podpola).

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Document.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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

Więcej informacji znajdziesz w przewodniku Autoryzacja.