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ć zastosowany w dokumencie. Umożliwia to wyświetlanie dokumentu ze wszystkimi sugestiami w tekście, zaakceptowanymi lub odrzuconymi. Jeśli nie zostanie określony, użyta zostanie wartość DEFAULT_FOR_CURRENT_ACCESS.

includeTabsContent

boolean

Określa, czy na platformie Document należy wypełniać pole Document.tabs zamiast pól treści tekstowych, takich jak body i documentStyle.

  • Gdy true: zawartość dokumentu jest wypełniana w polu Document.tabs zamiast w polach zawartości tekstu w Document.

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

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

commentsViewMode

enum (CommentsViewMode)

Tryb wyświetlania komentarzy, który ma zostać zastosowany do dokumentu. Dzięki temu możesz wyświetlać dokument z komentarzami lub bez nich. Jeśli nie zostanie określony, użyta zostanie wartość COMMENTS_VIEW_MODE_OMITTED.

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

Jeśli ustawisz parametr commentsViewMode na COMMENTS_VIEW_MODE_INCLUDED, musisz też wyraźnie ustawić parametr suggestionsViewMode na SUGGESTIONS_INLINE.

Jeśli ustawisz wartość commentsViewMode na COMMENTS_VIEW_MODE_INCLUDED lub COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, nie możesz ustawić wartości suggestionsViewMode na PREVIEW_WITHOUT_SUGGESTIONS ani PREVIEW_SUGGESTIONS_ACCEPTED.

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 po autoryzacji.