Method: documents.get

Belirtilen belgenin en son sürümünü alır.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
documentId

string

Alınacak belgenin kimliği.

Sorgu parametreleri

Parametreler
suggestionsViewMode

enum (SuggestionsViewMode)

Dokümana uygulanacak öneriler görüntüleme modu. Bu işlem, dokümanın tüm öneriler satır içi, kabul edilmiş veya reddedilmiş şekilde görüntülenmesine olanak tanır. Belirtilmezse DEFAULT_FOR_CURRENT_ACCESS kullanılır.

includeTabsContent

boolean

Document üzerinde body ve documentStyle gibi metin içeriği alanları yerine Document.tabs alanının doldurulup doldurulmayacağı.

  • Ne zaman true: Belge içeriği, Document içindeki metin içeriği alanları yerine Document.tabs alanına doldurulur.

  • Ne zaman false: Dokümanın ilk sekmesindeki içerik, Document içindeki içerik alanlarını Document.tabs hariç olmak üzere doldurur. Bir dokümanda yalnızca bir sekme varsa doküman içeriğini doldurmak için bu sekme kullanılır. Document.tabs boş olacaktır.

Document.tabs alanına (veya herhangi bir alt alana) referans veren bir alan maskesi kullanırsanız API, isteği includeTabsContent alanını true olarak ayarlamışsınız gibi değerlendirir.

commentsViewMode

enum (CommentsViewMode)

Dokümana uygulanacak yorum görüntüleme modu. Bu sayede, dokümanı yorumlar çıkarılmış veya eklenmiş şekilde görüntüleyebilirsiniz. Belirtilmezse COMMENTS_VIEW_MODE_OMITTED kullanılır.

commentsViewMode değerini ayarlarsanız includeTabsContent değerini de true olarak ayarlamanız veya Document.tabs alanına (ya da herhangi bir alt alana) referans veren bir alan maskesi kullanmanız gerekir.

commentsViewMode özelliğini COMMENTS_VIEW_MODE_INCLUDED olarak ayarlarsanız suggestionsViewMode özelliğini de SUGGESTIONS_INLINE olarak ayarlamanız gerekir.

commentsViewMode değerini COMMENTS_VIEW_MODE_INCLUDED veya COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS olarak ayarlarsanız suggestionsViewMode değerini PREVIEW_WITHOUT_SUGGESTIONS veya PREVIEW_SUGGESTIONS_ACCEPTED olarak ayarlayamazsınız.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, Document öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Daha fazla bilgi için Yetkilendirme kılavuzu'nu inceleyin.