최상의 결과를 위한 권장사항

Google Docs API를 사용할 때 따라야 할 몇 가지 원칙이 있습니다. 예를 들면 다음과 같습니다.

  • 효율성을 위해 역방향 수정
  • 공동작업 계획
  • 상태 일관성 보장: WriteControl 드림 필드
  • 탭 활용

다음 섹션에서는 이러한 원칙을 설명합니다.

효율성을 위해 역방향 수정

한 번의 호출에서 documents.batchUpdate 드림 메서드를 사용하여 색인 위치의 내림차순입니다. 이렇게 하면 각 특성의 처리 성능을 색인 생성의 일부를 변경할 수 있습니다.

공동작업 계획

문서 상태가 변경될 것으로 예상됩니다. 메서드 호출과 메서드 호출, 다른 메서드 호출 공동작업자는 다음 다이어그램과 같이 문서를 업데이트할 수 있습니다.

메서드 호출 간에 문서가 변경되는 방식

색인이 잘못된 경우 오류가 발생할 수 있습니다. 여러 사용자가 Google Docs가 이를 투명하게 처리합니다. 하지만 API 클라이언트로서 앱에서 이를 관리해야 합니다. 데이터 레이크를 함께 작업할 때, 방어적으로 프로그래밍하고 문서 상태가 일관되게 유지되는지 확인합니다 일관성을 보장하기 위한 한 가지 방법은 WriteControl 섹션을 검토하세요.

WriteControl로 상태 일관성 설정

문서를 읽고 업데이트할 때 경쟁 변경사항은 WriteControl 드림 documents.batchUpdate 메서드에 입력합니다. WriteControl에서 권한 제공 더 자세히 관리할 수 있습니다

사용 방법은 다음과 같습니다.

  1. 다음을 사용하여 문서를 가져옵니다. documents.get 메서드를 사용하고 저장합니다. revisionId 가져온 documents 리소스에서 삭제합니다.
  2. 업데이트 요청을 작성합니다.
  3. 선택사항인 WriteControl를 포함합니다. 객체를 다음 두 옵션 중 하나로 대체합니다.
    1. requiredRevisionId 필드는 revisionId 쓰기 요청이 적용되는 문서입니다. 문서가 수정된 경우 API 읽기 요청이기 때문에 쓰기 요청은 처리되지 않으며 오류가 반환됩니다.
    2. targetRevisionId 필드가 문서의 revisionId로 설정됩니다. 쓰기 요청이 적용되는 대상입니다. API 읽기 요청을 제출하면 쓰기 요청 변경사항이 공동작업자 변경사항. 쓰기 요청의 결과에는 새로운 쓰기 요청이 변경되고 문서의 수정 여부를 확인합니다. Docs 서버는 콘텐츠를 병합하는 데 사용됩니다.

WriteControl를 사용하여 일괄 요청을 구성하는 방법의 예시는 다음을 참조하세요. 이 일괄 요청 예시를 참조하세요.

탭 활용

단일 문서는 여러 탭을 포함할 수 있습니다. API 요청에 특정 처리가 필요합니다.

다음 사항을 기억하세요.

  1. 다음에서 includeTabsContent 매개변수를 true로 설정합니다. documents.get 메서드를 사용하여 문서의 모든 탭에서 콘텐츠를 검색할 수 있습니다. 기본적으로 모든 탭은 콘텐츠가 반환됩니다.
  2. 각 Request을 적용할 탭의 ID를 지정합니다. (으)로 documents.batchUpdate 메서드를 사용하여 축소하도록 요청합니다. 각 Request 업데이트를 적용할 탭을 지정하는 방법이 포함되어 있습니다. 기본적으로 탭이 지정되지 않은 경우 Request 대부분의 경우 문서의 첫 번째 탭에 적용됩니다. 자세한 내용은 Request초 문서를 참조하세요.