의견 보내기
요청 및 응답
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드에서는 Google Docs API를 구성하는 기본 요청 및 응답 메서드와 문서를 일괄 업데이트하는 방법을 소개합니다.
HTTP 요청 또는 메서드
언어별 클라이언트 라이브러리 에서 호출
이는 대체로 동일합니다.
Google Docs API는 일반적으로 결과가 포함된 HTTP 응답을 반환합니다.
요청 호출의 전체 크기입니다. 클라이언트 라이브러리를 사용하여 요청을 수행할 때
언어별 방식으로 반환됩니다.
요청 메서드
Docs API는 다음 메서드를 지원합니다.
documents.get
및 documents.batchUpdate
메서드에는 documentId
가 필요합니다.
를 매개변수로 사용하여 대상 문서를 지정합니다. documents.create
메서드
는 생성된 문서의 인스턴스를 반환하며, 여기에서
documentId
입니다. documentId
에 대한 자세한 내용은 문서 ID 를 참고하세요.
일괄 업데이트
documents.batchUpdate
메서드는
request
객체(각각 하나씩)
단일 요청을 지정하여 수행할 수 있습니다 예를 들어 단락의 서식을 지정한 다음
인라인 이미지를 추가합니다. 각 요청은 적용 전에 검증되며
요청은 일괄 요청에 나타나는 순서에 따라 처리됩니다.
일괄 업데이트의 모든 요청은 원자적으로 적용됩니다. 즉, 만약 요청이
유효하지 않은 경우 전체 업데이트가 실패하고
변경사항이 적용됩니다.
다른 사용자가 문서를 수정하고 있을 수 있으므로
변경할 수 있습니다 공동작업자가 없는 경우 업데이트된 문서에 변경사항이 정확하게 반영됩니다. 두 경우 모두 업데이트는
여전히 원자적으로 수행됩니다.
일부 documents.batchUpdate
메서드는
확인할 수 있습니다 이러한 메서드는 응답을 반환합니다.
본문 을
response
목록 포함
객체입니다. 다른 요청은 정보를 반환할 필요가 없으며 빈
답글 달기 응답 목록의 객체는
요청을 수행합니다.
일괄 요청을 할 때 많이 사용되는 패턴은 다음과 같습니다.
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
다음에 관한 자세한 내용은 일괄 요청 권장사항 을 참고하세요.
문서 API 호출을 일괄 처리하는 방법과
documents.batchUpdate
요청 및 응답 유형에 대한 참조 문서를 확인하세요.
batchUpdate
을 사용할 수 있으며 사용해야 합니다
가능하면 여러 요청을 단일 호출로 그룹화합니다. 이렇게 하면
성능을 향상시킬 수 있습니다 자세한 내용은 사용량 한도 를 참고하세요.
일괄 업데이트 작업
일괄 업데이트 요청에는 다양한 유형이 있습니다. 이 분류는 다음과 같습니다.
요청 유형 으로 그룹화되며
확인할 수 있습니다
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-11(UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]
의견을 전달하고 싶나요?
{"lastModified": "\ucd5c\uc885 \uc5c5\ub370\uc774\ud2b8: 2024-09-11(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-09-11(UTC)"]]