출시 노트

이 출시 노트를 구독합니다. 구독

이 페이지는 Google 포토 API의 새로운 버전이 출시될 때마다 업데이트됩니다. 변경 로그에는 날짜별로 출시가 나열되며 새로운 기능, 버그 수정, 기타 변경사항이 포함됩니다.

문서 및 가이드에서는 사용할 최신 버전을 안내합니다.

2025년 4월 1일

참고

이 버전에서는 이전에 발표된 포토 API 변경사항을 구현합니다.

  • Library API에서 일부 범위가 삭제되었습니다.
  • 앱에서 만든 콘텐츠에서만 작동하도록 여러 메서드를 제한합니다.
  • 기존의 허용되는 사용 정책 대신 새로운 Photos API 사용자 데이터 및 개발자 정책이 적용됩니다.

자세한 내용은 Google 포토 API 업데이트를 참고하세요.

2024년 9월 16일

기능

  • 안전하고 사용자 친화적인 사진 선택을 위한 새로운 Picker API를 도입했습니다.

참고

이번 출시에서는 Library API의 주요 변경사항을 발표했습니다(2025년 3월 31일부터 적용됨).

  • 라이브러리 API는 앱에서 만든 사진과 동영상만 관리합니다.
  • photoslibrary.readonly, photoslibrary.sharing, photoslibrary 범위가 삭제되었습니다.
  • 여러 메서드를 앱에서 만든 콘텐츠로만 제한합니다.

자세한 내용은 Google 포토 API 업데이트 페이지를 참고하세요.

2022년 10월 27일

참고

  • 'Google 포토 및 Flutter로 사진 공유 앱 빌드' Codelab을 더 이상 사용할 수 없습니다. 기타 샘플을 검토하고 가이드 내의 샘플 코드를 참고하세요.

2022년 6월 1일

참고

  • 업로드 프로세스를 명확히 설명하고, 일반적인 오류와 이를 방지하는 방법을 설명하며, 업로드 효율성을 개선하기 위한 팁을 제공하는 업로드 권장사항을 추가했습니다.

2021년 10월 27일

기능

  • Google 포토 파트너 프로그램: 프리미어 등급 출시 프리미어 등급은 Google 포토의 강력한 머신 인텔리전스를 활용하는 향상된 API 기능 모음입니다.

2021년 9월 29일

기능

  • 날짜 필터 기반 검색을 정렬하는 새로운 옵션이 추가되었습니다. 결과는 최신순 또는 최상순으로 정렬할 수 있습니다. 이를 통해 더 나은 타겟팅 검색 결과를 제공하여 더 쉽게 검색하고 효율성을 높일 수 있습니다.

2021년 7월 21일

기능

  • 재생 버튼 오버레이 없이 썸네일을 로드하는 새로운 -no 동영상 기본 URL 매개변수 기본적으로 동영상 썸네일은 재생 버튼 오버레이와 함께 로드됩니다. 이 새 매개변수를 사용하면 동영상 썸네일에서 재생 버튼을 숨길 수 있습니다.

해결된 문제

  • 문제 181282432: 동영상 썸네일이 항상 재생 버튼 오버레이와 함께 표시됨

2021년 5월 25일

해결된 문제

2021년 5월 19일

참고

2021년 2월 11일

참고

  • 광고 및 데이터 사용 최소화에 관한 콘텐츠를 추가하여 서비스이용 정책을 업데이트했습니다.

2020년 7월 7일

기능

2020년 2월 17일

기능

  • 사진의 최대 업로드 파일 크기가 75MB에서 200MB로 늘어났습니다.
  • 이제 파일을 업로드할 때 바이트 업로드 단계에서 MIME 유형을 지정해야 합니다.
  • 이제 미디어 바이트를 업로드할 때가 아니라 미디어 항목을 만들 때 파일 이름을 지정합니다. simpleMediaItem의 새 fileName 속성은 UTF-8 문자열을 지원합니다. 미디어 바이트를 업로드할 때 미디어 항목의 파일 이름을 지정할 수는 있지만 구현을 업데이트하는 것이 좋습니다.

참고

  • 데이터 사용 및 저장소 최소화에 중점을 둔 추가 세부정보를 포함하여 서비스이용 정책이 업데이트되었습니다.
  • 모션 사진을 포함하도록 기본 URL 문서가 업데이트되었습니다.

2019년 8월 16일

기능

  • 문제 131874809: 사용자가 공유 앨범의 소유자인지 확인하는 새로운 속성 isOwned이 shareInfo에 추가되었습니다. 자세한 내용은 미디어 공유 개발자 가이드를 참고하세요.

해결된 문제

2019년 6월 12일

기능

참고

2019년 5월 7일

Codelab

2019년 4월 29일

기능

참고

2019년 2월 14일

참고

해결된 문제

2019년 1월 21일

해결된 문제

2019년 1월 7일

해결된 문제

  • 문제 118464845: mediaItems.list가 빈 페이지를 너무 많이 반환했습니다.
  • 문제 111714379: mediaItems.search가 pageSize의 절반을 반환했습니다.

2018년 11월 30일

기능

해결된 문제

  • 문제 113978705: mediaItems.batchCreate에 설정된 설명이 HTML 항목으로 변환되었습니다.
  • 문제 114462217: mediaItems.batchCreate에서 동영상 파일의 파일 이름을 설정할 수 없습니다.
  • 문제 118475587: 미디어 항목에 잘못된 제품 URL이 반환되었습니다.
  • 문제 111862704: 기본 URL에 액세스할 때 403 오류가 발생합니다.
  • 문제 115932469: 할당량 오류로 업로드가 실패합니다.

2018년 9월 6일

기능

참고

  • Google 포토 라이브러리 API가 정식 버전으로 출시되었습니다. Library API 개발자 프리뷰 기간 동안 보내주신 의견과 기능 요청에 감사드립니다.
  • Java 및 PHP 클라이언트 라이브러리를 시작하는 방법에 관한 새로운 가이드를 확인하세요.
  • 클라이언트 라이브러리의 사용을 보여주는 샘플 Java 및 PHP 코드 스니펫이 가이드에 추가되었습니다.

2018년 9월 5일

기능

해결된 문제

참고

  • 2018년 9월 5일 전에 ID (예: 앨범, 미디어 항목 또는 보강 항목의 ID)를 저장한 경우 형식이 변경되어 더 이상 작동하지 않습니다. 애플리케이션에 사용할 새 ID를 가져와야 합니다.
  • 앨범 리소스의 totalMediaItems 속성의 이름이 mediaItemsCount로 변경되었습니다.
  • mediaItems.list 및 mediaItems.search 호출의 pageSize 매개변수의 최대값이 100으로 변경되었습니다. pageSize 매개변수가 지정되지 않은 경우 반환되는 기본 미디어 항목 수가 25로 변경되었습니다.
  • 라이브러리 콘텐츠 표시, 미디어 공유, 미디어 항목 액세스 가이드가 2018년 7월 31일에 출시된 excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) 필터 기능으로 업데이트되었습니다.

2018년 7월 31일

기능

해결된 문제

  • 문제 79757390: 업로드 요청 중에 파일 이름이 설정되지 않았습니다. 미디어 업로드 가이드에서 X-Goog-Upload-File-Namefile 및 X-Goog-Upload-Protocol 필드를 참고하세요.
  • 문제 80182372: 재개 가능한 업로드에서 오류가 반환되었습니다. 업데이트된 프로토콜은 새로운 재개 가능한 업로드 가이드를 참고하세요.
  • 문제 79497397: albums.list 응답에 isWriteable 속성이 누락되었습니다.
  • 문제 111143493: PEOPLE 콘텐츠 카테고리 필터가 부정확한 결과를 반환했습니다.
  • 문제 111056278: BIRTHDAYS 콘텐츠 카테고리 필터가 오류를 반환했습니다.

미리보기 출시 - 2018년 5월 8일

Library API의 최초 출시입니다.

알려진 문제

  • 수신하는 미디어 항목 id이 공유 앨범의 미디어 항목이고 사용자가 소유하지 않은 경우 GET mediaItem에서 오류가 발생합니다.
  • batchCreate 호출의 응답은 mediaMetadata 또는 contributorInfo를 반환하지 않습니다.
  • 미디어 항목이 동영상인 경우 batchCreate 호출은 mimeType를 반환하지 않습니다.
  • batchCreate는 여러 항목을 업로드할 때 일관된 순서를 유지하지 않습니다.
  • batchCreate는 공유 앨범의 소유자로 공유 앨범에서 미디어 항목을 만들 때 순서 지정 (position 추가)을 지원하지 않습니다. 기본값은 앨범의 끝입니다.