Backwards Incompatible V2 API Changes

원문: Backwards Incompatible V2 API Changes (Zoom Developer Blog, 2020-04-03)

오늘의 결론

"Zoom의 V2 API 변경으로 인해 주의 추적 기능이 제거되어 API 사용 시 주의할 점이 많아졌습니다. 이러한 변경 사항에 대한 명확한 이해가 필수적입니다."

이 글이 "기술 발전"이 아닌 이유

이 글은 단순히 기술적 발전을 자랑하기 위한 것이 아닙니다. 오히려 Zoom의 API 변경이 사용자들에게 미칠 실질적인 영향과 그에 따른 API 사용 방법의 변화에 대한 깊은 통찰을 제공합니다.

내가 본 것:

1. [주의 추적 기능 제거]: Zoom에서 제공하던 주의 추적 기능이 제거됨에 따라, 관련 API의 응답에서 ‘attentiveness_score’ 필드가 항상 비어 있는 값으로 반환됩니다. 이는 API를 통해 회의 참가자의 집중도를 추적하고자 했던 기존의 방식을 근본적으로 변화시킵니다.
2. [API 응답의 변화]: 사용자, 그룹, 계정 API에서 ‘attention_tracking’ 필드가 제거되며, 해당 필드의 응답은 항상 ‘false’로 반환됩니다. 이로 인해 개발자들은 기존 API 요청을 수정해야 하며, 소프트웨어의 안정성을 유지하기 위한 추가적인 작업이 필요해집니다.
3. [비밀번호 관련 설정 변경]: K-12 교육 계정의 비밀번호 관련 설정이 변경되어 더 이상 수정할 수 없게 됩니다. 이는 교육 환경에서의 보안과 관련된 중요한 변화로, 사용자는 이제 비밀번호 설정을 고려한 새로운 운영 방안을 마련해야 합니다.

내가 가져갈 실행 포인트 3개

(1) [API 변경 사항 파악]: [변경 사항이 미치는 영향]

Zoom의 API 변경 사항을 철저히 파악하는 것이 중요합니다. ‘attentivenessscore’ 필드와 ‘attentiontracking’ 필드가 비어 있거나 ‘false’로 반환되는 점을 반드시 이해하고 이를 기반으로 API 호출을 업데이트해야 합니다. 이러한 변화에 대한 명확한 이해는 향후 API 사용에서의 오류를 줄일 수 있습니다.

(2) [비밀번호 설정 검토]: [교육 계정 관리]

K-12 교육 계정의 비밀번호 설정 변경 사항을 점검하여, 관리자 및 소유자가 설정을 변경할 수 있는지 여부를 파악해야 합니다. 이 변경 사항은 보안과 직결되므로, 관련 정책을 면밀히 검토하고 필요 시 사용자에게 공지하는 것이 필요합니다.

(3) [API 문서 업데이트]: [최신 문서 확인]

Zoom의 최신 API 문서를 정기적으로 확인하여 모든 변경 사항을 반영하는 것이 필요합니다. API의 변경 사항은 개발 환경에 직접적인 영향을 미치므로, 문서의 최신성을 유지하는 것은 개발자의 책임입니다. 이를 통해 팀 내에서 일관된 정보 전달이 가능해집니다.

내가 설계할 기준

Zoom API 변경 사항을 반영하여 효율적으로 운영하기 위한 기준

• 신규 회의 및 웨비나 개발 시 API 응답을 확인하는 절차
• 사용자의 비밀번호 관련 설정 검토 및 관리 체계 수립
• 팀 내부에서 API 변경에 대한 정보를 공유하는 회의 정기화

이 기술/접근법이 맞지 않는 경우

• Zoom API를 사용하지 않는 비즈니스 환경
• 비밀번호 관리에 대한 보안 규정이 없는 경우

실패를 줄이는 운영 체크리스트

• API 호출 시 변동 사항을 반영하지 않기
• K-12 교육 계정의 비밀번호 설정 변경을 간과하기
• API 응답 값에 대한 검증 절차를 생략하기
• 관련 문서 업데이트를 소홀히 하기
• 사용자에게 변경 사항을 충분히 설명하지 않기

이번 주에 할 1가지

• 대상: Zoom의 V2 API 관련 문서
• 측정: 문서 내 변경 사항 확인 및 팀 회의에서 공유 여부
• 성공 기준: 팀원 모두가 변경 사항에 대해 이해하고, 관련 API 호출을 업데이트했음을 확인하는 것

마무리

Zoom의 API 변경 사항은 단순한 기술적 변화가 아닙니다. 이는 사용자 경험과 보안에 중대한 영향을 미치는 요소입니다. 시간과 자원을 투자하여 이러한 변화에 적절히 대응하는 것이 IT 운영의 안정성을 높이는 기본입니다. Timeware는 이러한 변화에 발 빠르게 대응하여 고객의 기술적 문제를 해결하는 데 최선을 다하겠습니다.

FAQ

Q. Zoom의 API 변경 사항으로 무엇이 가장 많이 변했나요?

Zoom API의 주의 추적 기능 제거가 가장 큰 변화입니다. 이로 인해 기존의 보고서 및 데이터를 분석하는 방식이 근본적으로 달라졌습니다.

Q. API 변경 사항을 실무에 어떻게 반영해야 할까요?

API 호출을 수정하고, 관련 문서를 업데이트하여 팀 내에서 공유하는 것이 중요합니다. 또한 사용자에게 변경 사항을 명확히 설명해야 합니다.

Q. Timeware는 이것을 어떻게 활용하나요?

Timeware는 고객의 기술적 문제를 해결하기 위해 Zoom API의 변경 사항을 즉시 반영하고, 고객에게 필요한 정보를 제공하여 혼란을 최소화하고 있습니다.

Q. 이 흐름은 앞으로 어떻게 전개될까요?

Zoom은 지속적으로 사용자 피드백을 반영하여 API를 개선할 것입니다. 따라서, 개발자 및 운영자는 이러한 변화에 유연하게 대응할 수 있는 체계를 마련해야 합니다.