Google 포토 API 업데이트

2024년 9월 게시

이 페이지에서는 Google 포토 API에 적용되는 구체적인 변경사항에 관한 세부정보를 제공합니다. 이 페이지의 세부정보를 검토하여 사용하는 메서드와 범위에 미칠 수 있는 영향을 알아보세요. 관련 블로그 게시물에서 이번 변경사항에 관한 공지사항을 자세히 알아보세요.

라이브러리 API: 일반적인 사용 사례에 미치는 영향

다음 섹션에서는 예정된 변경사항이 일반적인 사용 사례에 미치는 영향을 자세히 설명합니다.

미디어 항목 업로드 및 앨범 만들기

변경사항: 변경사항이 없습니다. photoslibrary.appendonly 범위를 사용하여 미디어 항목을 계속 업로드하고 앨범을 만들 수 있습니다.

취할 수 있는 조치:

앱이 미디어 항목을 업로드하거나 앨범을 만드는 경우 photoslibrary 범위가 아닌 photoslibrary.appendonly 범위를 사용해야 합니다. photoslibrary 범위가 삭제됩니다.

미디어 항목 및 앨범 나열, 검색, 가져오기

변경사항: 이제 앱에서 만든 앨범 및 미디어 항목만 나열, 검색, 검색할 수 있습니다.

취할 수 있는 조치:

  • 앱에서 사용자가 전체 라이브러리에서 사진 또는 앨범을 선택해야 하는 경우 새 Google 포토 선택 도구 API를 사용하세요. 이를 통해 사용자는 안전하고 사용자 친화적인 방식으로 특정 콘텐츠에 대한 액세스 권한을 부여할 수 있습니다.
  • 앱에서 사용자의 전체 라이브러리에 액세스하는 경우 앱을 재평가하거나 다른 접근 방식을 고려해야 할 수 있습니다.

공유 및 공유 앨범

변경사항: 공유 앨범 및 관련 API 함수 (공유, 공유 취소, 가져오기, 참여, 탈퇴, 목록)는 2025년 3월 31일 이후 403 PERMISSION_DENIED를 반환합니다.

취할 수 있는 조치:

사용자를 Google 포토 앱으로 안내하여 공유를 직접 관리하도록 합니다. 앱 내에서 명확한 안내나 딥 링크를 제공하여 사용자를 안내할 수 있습니다.

앱에서 만든 앨범 관리: 보강 및 앨범 콘텐츠

변경사항: 개념적 일관성을 위해 다음 세 가지 메서드에 photoslibrary.edit.appcreateddata가 추가됩니다.

  • albums.addEnrichment
  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

취할 수 있는 조치:

  • 앱에서 이미 이러한 메서드를 사용하는 경우 승인 프로세스를 간소화하기 위해 photoslibrary.edit.appcreateddata 범위를 채택하는 것이 좋습니다.

Library API: 영향을 받는 범위 및 메서드

Google 포토 API 변경의 일환으로 다음과 같은 업데이트가 적용되었습니다.

업데이트된 승인 페이지에 표시된 대로 2025년 3월 31일 이후에는 다음 스코프가 Library API에서 삭제됩니다.

  • photoslibrary.readonly
  • photoslibrary.sharing
  • photoslibrary

다음 범위는 유지됩니다.

  • photoslibrary.appendonly
  • photoslibrary.readonly.appcreateddata
  • photoslibrary.edit.appcreateddata

이 표에는 영향을 받는 특정 라이브러리 API 메서드와 범위가 자세히 나와 있습니다.

업데이트 메서드 범위
이제 이러한 메서드는 앱에서 만든 앨범 및 미디어 항목에만 사용할 수 있습니다. 남은 범위:
  • photoslibrary.appendonly
삭제된 범위:
  • photoslibrary
  • photoslibrary.sharing
남은 범위:
  • photoslibrary.readonly.appcreateddata
삭제된 범위:
  • photoslibrary
  • photoslibrary.readonly
이러한 메서드는 더 이상 사용할 수 없습니다. 남은 범위:
  • 없음
삭제된 범위:
  • photoslibrary.sharing
이러한 메서드에는 photoslibrary.edit.appcreateddata가 추가됩니다.
이러한 메서드는 이제 앱에서 만든 앨범 및 미디어 항목에만 사용할 수 있습니다.		 남은 범위:
  • photoslibrary.appendonly
  • photoslibrary.edit.appcreateddata
삭제된 범위:
  • photoslibrary
남은 범위:
  • photoslibrary.edit.appcreateddata
삭제된 범위:
  • photoslibrary
이러한 메서드는 변경되지 않습니다. 남은 범위:
  • photoslibrary.edit.appcreateddata
삭제된 범위:
  • 없음

Photos API 정책 업데이트

기존 용인 사용 정책은 2025년 3월 31일 이후 새로운 Photos API 사용자 데이터 및 개발자 정책으로 대체됩니다. 새 정책은 현재 미리보기 버전으로 제공됩니다.

Photos API 문서 업데이트

예정된 업데이트를 반영하고 개발 환경을 지원하기 위해 Photos API 문서를 대폭 변경했습니다.

  • 통합된 포토 API 사이트: 모든 포토 API 리소스를 단일 위치 (이 사이트)로 통합하여 개발자에게 간소화된 환경을 제공합니다. 여기에서 다음을 확인할 수 있습니다.
  • Library API 콘텐츠 업데이트: 지원 종료 기간 후 Library API의 기능을 반영하도록 Library API 문서가 수정되었습니다.
  • 기존 문서 보존: 기존 통합을 이전해야 하는 개발자를 위해 원래 Library API 문서가 유지되었습니다. 새 프로젝트를 시작하는 경우 업데이트된 문서를 사용하세요. 기존 프로젝트를 업데이트하는 경우 이전 문서와 업데이트된 문서를 모두 참고하여 이전을 진행하세요.

자주 묻는 질문(FAQ)

Google 포토 API가 어떻게 변경되나요?

안전한 사진 선택을 위한 새로운 Google 포토 선택 도구 API를 도입하고 앱에서 만든 사진 및 동영상 관리에 중점을 두도록 기존 Library API를 업데이트합니다.

변경사항은 언제부터 적용되나요?

변경된 내용은 2025년 3월 31일부터 적용됩니다. 사진 선택을 위해 Library API를 사용하는 기존 통합이 있는 모든 사용자는 최대한 빨리 Picker API로 이전하는 것이 좋습니다.

Library API에는 어떤 영향을 미치나요?

photoslibrary.readonly, photoslibrary.sharing, photoslibrary 범위가 삭제됩니다. 이러한 범위만 사용하는 API 호출은 2025년 3월 31일 이후에 403 PERMISSION_DENIED를 반환합니다. 다른 여러 호출은 앱에서 만든 사진 및 동영상으로만 작동하도록 제한됩니다.

이 페이지의 영향을 받는 범위 및 메서드 표에서 전체 변경사항을 검토할 수 있습니다.

앱에서 현재 영향을 받는 범위 또는 메서드를 사용하는 경우 어떻게 해야 하나요?

앱에서 영향을 받는 범위 또는 메서드를 사용하는 경우 다음 단계를 따르는 것이 좋습니다.

  • 사진 선택: Google 포토 Picker API로 이전합니다.
  • 기타 기능: 업데이트된 Library API 문서를 검토하여 변경사항을 파악하고 더 이상 사용할 수 없는 앱의 기능을 식별합니다. 일부 사용 사례의 경우 앱의 기능을 조정하거나 대체 솔루션을 모색해야 할 수 있습니다.

Google 포토 선택 도구 API란 무엇인가요?

Picker API는 개발자가 사용자가 Google 포토 라이브러리에서 사진과 동영상을 선택하고 이를 애플리케이션으로 원활하게 전송할 수 있는 새로운 보안 방법입니다.

이 변경사항에 대한 자세한 내용은 어디에서 확인할 수 있나요?

현재 보고 있는 이 페이지에서는 모든 변경사항에 대한 개요와 요약을 확인할 수 있습니다.

사이트의 기타 문서는 업데이트된 API를 반영하도록 업데이트되었습니다.

변경사항을 알리는 블로그 게시물

추가 질문이 있거나 애플리케이션 이전에 도움이 필요한 경우 어떻게 해야 하나요?

개발자 문서에 관해 궁금한 점이 있으면 지원 페이지를 검토하여 도움을 받는 방법을 자세히 알아보세요.