Google Docs API를 사용할 때 따라야 할 몇 가지 원칙이 있습니다. 예를 들면 다음과 같습니다.
- 효율성을 위해 역방향 수정
- 공동작업 계획
- 상태 일관성 보장:
WriteControl
필드 - 탭 활용
다음 섹션에서는 이러한 원칙을 설명합니다.
효율성을 위해 역방향 수정
한 번의 호출에서
documents.batchUpdate
메서드를 사용하여
색인 위치의 내림차순입니다. 이렇게 하면 각 특성의 처리 성능을
색인 생성의 일부를 변경할 수 있습니다.
공동작업 계획
문서 상태가 변경될 것으로 예상됩니다. 메서드 호출과 메서드 호출, 다른 메서드 호출 공동작업자는 다음 다이어그램과 같이 문서를 업데이트할 수 있습니다.
색인이 잘못된 경우 오류가 발생할 수 있습니다. 여러 사용자가
Google Docs가 이를 투명하게 처리합니다. 하지만
API 클라이언트로서 앱에서 이를 관리해야 합니다. 데이터 레이크를
함께 작업할 때, 방어적으로 프로그래밍하고
문서 상태가 일관되게 유지되는지 확인합니다 일관성을 보장하기 위한 한 가지 방법은
WriteControl
섹션을 검토하세요.
WriteControl로 상태 일관성 설정
문서를 읽고 업데이트할 때
경쟁 변경사항은
WriteControl
documents.batchUpdate
메서드에 입력합니다. WriteControl
에서 권한 제공
더 자세히 관리할 수 있습니다
사용 방법은 다음과 같습니다.
- 다음을 사용하여 문서를 가져옵니다.
documents.get
메서드를 사용하고 저장합니다.revisionId
가져온documents
리소스에서 삭제합니다. - 업데이트 요청을 작성합니다.
- 선택사항인
WriteControl
를 포함합니다. 객체를 다음 두 옵션 중 하나로 대체합니다.requiredRevisionId
필드는revisionId
쓰기 요청이 적용되는 문서입니다. 문서가 수정된 경우 API 읽기 요청이기 때문에 쓰기 요청은 처리되지 않으며 오류가 반환됩니다.targetRevisionId
필드가 문서의revisionId
로 설정됩니다. 쓰기 요청이 적용되는 대상입니다. API 읽기 요청을 제출하면 쓰기 요청 변경사항이 공동작업자 변경사항. 쓰기 요청의 결과에는 새로운 쓰기 요청이 변경되고 문서의 수정 여부를 확인합니다. Docs 서버는 콘텐츠를 병합하는 데 사용됩니다.
WriteControl
를 사용하여 일괄 요청을 구성하는 방법의 예시는 다음을 참조하세요.
이 일괄 요청 예시를 참조하세요.
탭 활용
단일 문서는 여러 탭을 포함할 수 있습니다. API 요청에 특정 처리가 필요합니다.
다음 사항을 기억하세요.
- 다음에서
includeTabsContent
매개변수를true
로 설정합니다.documents.get
메서드를 사용하여 문서의 모든 탭에서 콘텐츠를 검색할 수 있습니다. 기본적으로 모든 탭은 콘텐츠가 반환됩니다. - 각
Request
을 적용할 탭의 ID를 지정합니다. (으)로documents.batchUpdate
메서드를 사용하여 축소하도록 요청합니다. 각Request
업데이트를 적용할 탭을 지정하는 방법이 포함되어 있습니다. 기본적으로 탭이 지정되지 않은 경우Request
대부분의 경우 문서의 첫 번째 탭에 적용됩니다. 자세한 내용은Request
초 문서를 참조하세요.