이 가이드에서는 Google Drive Activity API v1과 v2의 차이점과 v2 API를 지원하도록 v1 애플리케이션을 변경하는 방법을 설명합니다.
승인
v1 API에서 사용한 범위:
https://www.googleapis.com/auth/activity
v2 API에는 다음 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drive.activityhttps://www.googleapis.com/auth/drive.activity.readonly
리소스 이름
v1 API에서 Google Drive 항목 및 사용자와 같은 객체의 식별자는 불투명 문자열입니다. v2 API에서 이러한 객체는 일반적으로 리소스 이름을 사용하여 참조됩니다. 자세한 내용은 Cloud API 디자인 가이드를 참조하세요.
이러한 식별자는 일반적으로 변환 가능합니다. 예를 들어 v2 API의 Drive 항목은 리소스 이름 items/ITEM_ID_V1를 사용하여 참조됩니다.
요청
v2의 요청 형식은 v1의 요청 형식과 유사합니다. 특히 Drive 파일이나 Drive 상위 항목에 대한 활동을 요청할 수 있지만 요청 매개변수의 형식을 items/로 지정하여 리소스 이름 형식으로 지정해야 합니다.
이제 '그룹화'가 통합이라고 하며 source 및 userId 요청 매개변수가 삭제되었습니다.
응답에 반환되는 활동 데이터 유형을 제한할 수 있는 새로운 필터 옵션도 있습니다.
작업
v1 API에서 활동 유형과 활동 관련 데이터는 별도의 필드에 있었습니다. 예를 들어 primaryEventType 필드에 move 값이 포함되어 있으면 앱은 최상위 move 필드가 추가 및 삭제된 상위 요소로 채워졌다고 가정합니다.
v2 API에서 이러한 필드는 더 이상 구별되지 않습니다. ActionDetail 메시지에는 정확히 하나의 필드가 설정되어 있습니다. 작업 유형을 나타내며 이 작업과 관련된 세부정보를 포함합니다. 예를 들어 이동을 나타내는 ActionDetail는 move 필드만 설정하며 이 필드는 추가 및 삭제된 상위 요소를 나열합니다.
v1 API primaryEventType 필드는 대략 v2 primaryActionDetail에 해당합니다.
배우
v1 API에서 반환된 활동에는 행위자가 알려진 사용자인 경우 User가 포함되었고 특별한 경우에 fromUserDeletion와 같은 최상위 필드가 선택적으로 포함됩니다.
v2 API에서는 더 풍부한 Actor 유형 집합을 사용할 수 있으며, 행위자가 알려진 사용자인 경우 user.knownUser가 채워집니다. 애플리케이션에서 사용자에 관한 자세한 정보가 필요한 경우 KnownUser 필드 personName를 people.get 메서드에 전달하여 People API에서 쿼리할 수 있습니다.
대상
v1 API에서 대상은 항상 Drive 항목이었습니다. v2 API에서는 Drive에 있는 다른 유형의 객체가 대상일 수 있습니다. 예를 들어 드라이브 변경사항은 대상 유형이 Drive입니다. 공유 드라이브의 루트 폴더는 root 필드에 DriveItem로 계속 반환되지만 활동의 직접적인 대상은 아닙니다. FileComment 리소스에도 유사한 개념이 적용되며, 이 리소스의 parent 필드는 대상 댓글 대화목록이 포함된 Drive 항목을 참조합니다.
통합 활동
v1 API에서는 통합 ('그룹화') 전략이 설정될 때 응답 스타일이 변경되었습니다. 특히 통합이 사용 설정된 경우 각 활동에는 구성 요소 singleEvents 및 이러한 구성 이벤트 간의 공통 활동을 요약한 combinedEvent가 포함되었습니다. 통합이 사용 중지될 때 combinedEvent 필드에는 각 활동의 비통합된 원래의 이벤트가 포함되었습니다. 이러한 이벤트는 공유와 함께 만들기와 같이 둘 이상의 작업을 나타낼 수 있습니다.
v2 API에서는 반환된 DriveActivity에 항상 전체 작업 수행자, 대상, 작업 집합이 포함되므로 응답 스타일이 통합 전략에 따라 변경되지 않습니다.