Method: documents.create

요청에 지정된 제목을 사용하여 빈 문서를 만듭니다. 제공된 콘텐츠를 포함하여 요청의 다른 필드는 무시됩니다.

생성된 문서를 반환합니다.

HTTP 요청

POST https://docs.googleapis.com/v1/documents

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "documentId": string,
  "title": string,
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
필드
documentId

string

출력 전용. 문서의 ID입니다.
title

string

문서의 제목입니다.
body

object (Body)

출력 전용. 문서의 본문입니다.
headers

map (key: string, value: object (Header))

출력 전용. 헤더 ID로 키가 지정된 문서의 헤더입니다.
footers

map (key: string, value: object (Footer))

출력 전용. 바닥글 ID로 키가 지정된 문서의 바닥글입니다.
footnotes

map (key: string, value: object (Footnote))

출력 전용. 각주 ID로 키가 지정된 문서의 각주
documentStyle

object (DocumentStyle)

출력 전용. 문서의 스타일입니다.
suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

출력 전용. 제안 스타일이 문서 스타일을 변경하고 제안 ID로 키가 지정됩니다.
namedStyles

object (NamedStyles)

출력 전용. 문서의 이름이 지정된 스타일
suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

출력 전용. 제안된 이름이 문서의 이름이 지정된 스타일에 변경되며 추천 ID로 키가 지정됩니다.
lists

map (key: string, value: object (List))

출력 전용. 목록 ID로 키가 지정된 문서의 목록입니다.
namedRanges

map (key: string, value: object (NamedRanges))

출력 전용. 문서의 이름이 지정된 범위로 이름이 키로 지정됩니다.
revisionId

string

출력 전용. 문서의 버전 ID입니다. 업데이트를 적용할 문서의 버전을 지정하고 업데이트 이후에 문서가 수정된 경우 요청이 어떻게 동작하는지 업데이트 요청에 사용할 수 있습니다. 사용자에게 문서에 대한 수정 액세스 권한이 있는 경우에만 채워집니다.

버전 ID는 순차 번호가 아니라 불투명 문자열입니다. 버전 ID의 형식은 시간이 지나면 변경될 수 있습니다. 반환된 버전 ID는 반환 후 24시간 동안만 유효하며 여러 사용자와 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않으면 문서가 변경되지 않은 것입니다. 반대로 동일한 사용자 및 다른 사용자의 ID는 일반적으로 문서가 업데이트되었음을 의미합니다. 하지만 변경된 ID는 ID 형식 변경과 같은 내부 요인으로 인해 발생할 수도 있습니다.
suggestionsViewMode

enum (SuggestionsViewMode)

출력 전용. 제안사항 보기 모드가 문서에 적용됩니다.

참고: 문서를 수정할 때 SUGGESTIONS_INLINE가 있는 문서를 기반으로 변경해야 합니다.
inlineObjects

map (key: string, value: object (InlineObject))

출력 전용. 객체 ID로 키가 지정된 문서의 인라인 객체
positionedObjects

map (key: string, value: object (PositionedObject))

출력 전용. 문서에 배치된 객체를 객체 ID로 키가 지정됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Document의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.