의견 보내기
Method: documents.create
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
요청에 지정된 제목을 사용하여 빈 문서를 만듭니다. 제공된 콘텐츠를 비롯한 요청의 다른 필드는 무시됩니다.
생성된 문서를 반환합니다.
HTTP 요청
POST https://docs.googleapis.com/v1/documents
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현
{
"documentId" : string ,
"title" : string ,
"tabs" : [
{
object (Tab
)
}
] ,
"revisionId" : string ,
"suggestionsViewMode" : enum (SuggestionsViewMode
) ,
"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
)
} ,
...
} ,
"inlineObjects" : {
string : {
object (InlineObject
)
} ,
...
} ,
"positionedObjects" : {
string : {
object (PositionedObject
)
} ,
...
}
}
필드
document Id
string
출력 전용입니다. 문서의 ID입니다.
title
string
문서의 제목입니다.
tabs[]
object (Tab
)
문서의 일부인 탭
탭에는 하위 탭(다른 탭 내에 중첩된 탭)이 포함될 수 있습니다. 하위 탭은 Tab.childTabs
필드로 표시됩니다.
revision Id
string
출력 전용입니다. 문서의 버전 ID입니다. 업데이트 요청에서 업데이트를 적용할 문서의 버전과 해당 버전 이후에 문서가 수정된 경우 요청이 어떻게 작동해야 하는지 지정하는 데 사용할 수 있습니다. 사용자에게 문서에 대한 수정 액세스 권한이 있는 경우에만 채워집니다.
버전 ID는 순차 번호가 아니라 불투명한 문자열입니다. 버전 ID의 형식은 시간이 지남에 따라 변경될 수 있습니다. 반환된 버전 ID는 반환 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않으면 문서가 변경되지 않은 것입니다. 반대로 동일한 문서 및 사용자의 ID가 변경된 경우 일반적으로 문서가 업데이트되었음을 의미합니다. 하지만 ID 형식 변경과 같은 내부 요인으로 인해 ID가 변경될 수도 있습니다.
suggestions View Mode
enum (SuggestionsViewMode
)
출력 전용입니다. 문서에 적용된 제안 뷰 모드입니다.
참고: 문서를 수정할 때는 SUGGESTIONS_INLINE
가 있는 문서를 기반으로 변경해야 합니다.
body
object (Body
)
출력 전용입니다. 문서의 본문입니다.
기존 필드: 대신 Document.tabs.documentTab.body
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
headers
map (key: string, value: object (Header
))
출력 전용입니다. 헤더 ID를 키로 하는 문서의 헤더입니다.
기존 필드: 대신 Document.tabs.documentTab.headers
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
footers
map (key: string, value: object (Footer
))
출력 전용입니다. 문서의 바닥글로, 바닥글 ID를 키로 사용합니다.
기존 필드: 대신 includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭에서 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.footers
를 사용합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
footnotes
map (key: string, value: object (Footnote
))
출력 전용입니다. 각주 ID를 키로 하는 문서의 각주입니다.
기존 필드: 대신 Document.tabs.documentTab.footnotes
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
document Style
object (DocumentStyle
)
출력 전용입니다. 문서의 스타일입니다.
기존 필드: 대신 Document.tabs.documentTab.documentStyle
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
suggested Document Style Changes
map (key: string, value: object (SuggestedDocumentStyle
))
출력 전용입니다. 문서 스타일에 대한 추천 변경사항으로, 추천 ID를 키로 사용합니다.
기존 필드: 대신 Document.tabs.documentTab.suggestedDocumentStyleChanges
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
named Styles
object (NamedStyles
)
출력 전용입니다. 문서의 이름이 지정된 스타일입니다.
기존 필드: 대신 Document.tabs.documentTab.namedStyles
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
suggested Named Styles Changes
map (key: string, value: object (SuggestedNamedStyles
))
출력 전용입니다. 문서의 이름이 지정된 스타일에 대한 추천 변경사항으로, 추천 ID를 키로 사용합니다.
기존 필드: 대신 Document.tabs.documentTab.suggestedNamedStylesChanges
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
lists
map (key: string, value: object (List
))
출력 전용입니다. 목록 ID로 키가 지정된 문서의 목록입니다.
기존 필드: 대신 Document.tabs.documentTab.lists
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
named Ranges
map (key: string, value: object (NamedRanges
))
출력 전용입니다. 문서의 이름이 지정된 범위로, 이름을 키로 사용합니다.
기존 필드: 대신 Document.tabs.documentTab.namedRanges
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
inline Objects
map (key: string, value: object (InlineObject
))
출력 전용입니다. 문서의 인라인 객체로, 객체 ID를 키로 사용합니다.
기존 필드: 대신 Document.tabs.documentTab.inlineObjects
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
positioned Objects
map (key: string, value: object (PositionedObject
))
출력 전용입니다. 문서에 배치된 객체로, 객체 ID를 키로 사용합니다.
기존 필드: 대신 Document.tabs.documentTab.positionedObjects
를 사용하세요. includeTabsContent
매개변수가 true
로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출합니다. false
이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Document
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
자세한 내용은 승인 가이드 를 참고하세요.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-09(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-11-09(UTC)"],[[["Creates a new Google Docs document with the specified title, leaving all other content blank."],["Uses a POST request to `https://docs.googleapis.com/v1/documents` with the document title in the request body."],["Returns the newly created document object in the response."],["Requires authorization with specific Google Docs or Drive scopes."]]],[]]