출시 노트 구독
이 페이지는 Google 포토 라이브러리 API가 새로 출시될 때마다 업데이트됩니다. 변경 로그는 날짜별로 출시 목록을 표시하고 새로운 기능, 버그 수정, 기타 변경사항을 포함합니다.
문서 및 가이드에서는 사용할 최신 버전을 알려줍니다.
2022년 10월 27일
Notes
- 'Google 포토와 Flutter로 사진 공유 앱 빌드' Codelab은 더 이상 사용할 수 없습니다. 다른 샘플을 검토하고 가이드에 있는 샘플 코드를 참조하세요.
2022년 6월 1일
Notes
- 업로드 프로세스를 명확히 하고, 일반적인 오류와 이를 방지하는 방법을 안내하고, 업로드 효율성 개선을 위한 팁을 제공할 수 있도록 업로드 권장사항을 추가했습니다.
2021년 10월 27일
기능
- Google 포토 파트너 프로그램: 프리미어 등급 출시 프리미어 등급은 Google 포토의 강력한 머신 인텔리전스를 활용하는 고급 API 기능 모음입니다.
2021년 9월 29일
기능
- 날짜 필터 기반 검색어를 정렬하는 새로운 옵션이 추가되었습니다. 결과는 최근 날짜순 또는 오래된 날짜순으로 정렬할 수 있습니다. 이렇게 하면 더 쉽게 검색할 수 있고 더 정확하게 타겟팅된 검색 결과를 제공하여 효율성을 개선할 수 있습니다.
2021년 7월 21일
기능
- 재생 버튼 오버레이 없이 썸네일을 로드하는 새로운
-no
동영상 기본 URL용 매개변수. 기본적으로 동영상 썸네일은 재생 버튼 오버레이와 함께 로드됩니다. 이 새로운 매개변수를 사용하면 동영상 썸네일의 재생 버튼을 숨길 수 있습니다.
해결된 문제
- 문제 181282432: 동영상 썸네일이 항상 재생 버튼 오버레이와 함께 표시됩니다.
2021년 5월 25일
해결된 문제
- 미디어 항목의
photo
메타데이터에 대해exposureTime
속성이 채워지지 않았습니다.
2021년 5월 19일
Notes
- Android 모션 사진 및 iOS Live Photos용
=dv
매개변수의 동작을 명확히 하기 위해 모션 사진의 기본 URL 문서가 업데이트되었습니다.
2021년 2월 11일
Notes
- 서비스이용 정책이 업데이트되어 광고에 관한 콘텐츠가 추가되고 데이터 사용이 최소화되었습니다.
2020년 7월 7일
기능
- Google 포토의 새로운 공유 제어를 지원하도록 API가 업데이트되었습니다.
이제 새 필드
isJoinable
가 공유 앨범의shareInfo
속성의 일부로 반환됩니다.isJoinable
가true
이면 API는 사용자를 공유 앨범에 참여할 수 있습니다. 소유자가 Google 포토의 앨범에서 링크 공유를 사용 중지한 경우isJoinable
는false
가 되며 API는 사용자를 해당 앨범에 조인할 수 없습니다. - 문제 111405623, 116379853, 117685011: 이제 앱에서 만든 미디어 항목의 앨범 제목과 표지 사진을 변경하고 설명을 변경할 수 있습니다. 업데이트 액세스의 새로운
photoslibrary.edit.appcreateddata
승인 범위를 요청합니다.
2020년 2월 17일
기능
- 사진의 최대 업로드 파일 크기가 75MB에서 200MB로 늘어났습니다.
- 이제 파일을 업로드할 때 바이트 업로드 단계에서 MIME 유형을 지정해야 합니다.
- 이제 미디어 바이트를 업로드할 때가 아니라 미디어 항목을 생성할 때 파일 이름을 지정합니다.
simpleMediaItem
의 새로운fileName
속성은 UTF-8 문자열을 지원합니다. 미디어 바이트를 업로드할 때 미디어 항목의 파일 이름을 지정할 수는 있지만 구현을 업데이트하는 것이 좋습니다.
Notes
- 서비스이용 정책이 업데이트되었으며 데이터 사용 및 스토리지 최소화에 중점을 둔 몇 가지 추가 세부정보가 추가되었습니다.
- 모션 사진을 포함하도록 기본 URL 문서가 업데이트되었습니다.
2019년 8월 16일
기능
- 문제 131874809: 사용자가 공유 앨범의 소유자인지 식별하기 위한
shareInfo
의 새 속성isOwned
이 추가되었습니다. 자세한 내용은 미디어 공유 개발자 가이드를 참고하세요.
해결된 문제
- 문제 131711405:
albums.list
응답에서shareableUrl
속성이 누락되었습니다. - 문제 113870729:
mediaItems.list
가 페이지 경계에서 중복된 미디어 항목을 반환하는 경우가 있었습니다. - 문제 93428763: 이제 동영상 메타데이터의
status
필드가 사용 가능한 최고 품질의 동영상의VideoProcessingStatus
를 올바르게 반환합니다.
2019년 6월 12일
기능
- 문제 110188560: 즐겨찾기로 표시된 미디어 항목을 선택하는 새로운 검색 필터(
FeatureFilter
)가 추가되었습니다. - 특정 카테고리와 일치하는 미디어 항목을 필터링하기 위한
ContentFilter
의 새 콘텐츠 카테고리:ARTS
,CRAFTS
,FASHION
,HOUSES
,GARDENS
,FLOWERS
,HOLIDAYS
Notes
- 프로젝트 및 앨범 이름 지정에 관한 추가 안내를 제공하는 UX 가이드라인을 업데이트했습니다.
2019년 5월 7일
Codelab
- 새로운 Codelab: Google 포토 및 Flutter로 사진 공유 앱 빌드 Flutter에서 Google 포토 라이브러리 API를 사용하여 사진 공유 앱을 빌드하는 방법을 알아봅니다. 자세한 내용은 샘플 가이드를 참고하세요.
2019년 4월 29일
기능
문제 109505022: 앨범에 기존 미디어 항목을 추가하고 삭제하는 새 호출이 발생합니다.
이러한 호출은 애플리케이션에서 만든 미디어 항목과 앨범을 지원합니다. 자세한 내용은 앨범 관리 개발자 가이드를 참고하세요.
미디어 항목
mediaItems.batchCreate
생성을 위한 REST 호출은 이제 일부 미디어 항목을 만들 수 없는 경우 부분적인 성공을 위해 HTTP 상태207 MULTI-STATUS
를 반환합니다. 자세한 내용은 미디어 업로드 개발자 가이드를 참고하세요.
Notes
- 최신 버전의 클라이언트 라이브러리에는 브레이킹 체인지가 포함되어 있습니다.
MediaItem
,Album
,DateRange
와 관련된 클래스가 새로운 전용 패키지로 이동했습니다. 해당 기능은 변경되지 않고 클라이언트 라이브러리에서의 위치만 변경됩니다. 자바 클라이언트 라이브러리(1.2.0) 및 PHP 클라이언트 라이브러리(1.2.0)의 출시 노트를 참고하세요.
2019년 2월 14일
Notes
- 기본 URL에서 미디어 바이트 액세스에 새로운 할당량 한도가 적용됩니다. Google API 콘솔에서 이 할당량을 모니터링할 수 있습니다.
해결된 문제
- 문제 124355983: 일부 공유 미디어 항목에 관해
mediaItems.get
를 호출할 때 500 오류가 발생합니다.
2019년 1월 21일
해결된 문제
- 문제 121998358:
albums.create
응답에서isWriteable
속성이 누락되었습니다.
2019년 1월 7일
해결된 문제
- 문제 118464845:
mediaItems.list
에서 빈 페이지를 너무 많이 반환했습니다. - 문제 111714379:
mediaItems.search
가pageSize
의 절반을 반환했습니다.
2018년 11월 30일
기능
mediaItems.batchGet
를 새로 호출하여 식별자로 여러 미디어 항목을 검색합니다.- 문제 111279349: 참여한 앨범에서 나가는
sharedAlbums.leave
를 새로 호출합니다. - 문제 111279347:
albums.unshare
를 새로 호출하여 공유 앨범을 비공개로 표시합니다.
해결된 문제
- 문제 113978705:
mediaItems.batchCreate
에 설정된 설명이 HTML 항목으로 변환되었습니다. - 문제 114462217:
mediaItems.batchCreate
에서 동영상 파일의 파일 이름을 설정할 수 없습니다. - 문제 118475587: 미디어 항목에 대해 잘못된 제품 URL이 반환되었습니다.
- 문제 111862704: 기본 URL에 액세스할 때 403 오류가 발생합니다.
- 문제 115932469: 할당량 오류로 인해 업로드가 실패합니다.
2018년 9월 6일
기능
- 이제 자바 및 PHP 클라이언트 라이브러리를 사용할 수 있습니다.
Notes
- Google 포토 라이브러리 API가 정식 버전으로 출시되었습니다. 라이브러리 API 개발자 프리뷰 기간 동안 의견과 기능 요청을 보내 주셔서 감사합니다.
- 자바 및 PHP 클라이언트 라이브러리를 시작하기 위한 새로운 가이드를 확인하세요.
- 클라이언트 라이브러리 사용법을 보여주는 샘플 자바 및 PHP 코드 스니펫이 가이드에 추가되었습니다.
2018년 9월 5일
기능
sharedAlbums.get
를 새로 호출하여shareToken
를 사용하여 앨범을 가져옵니다.- 사용자가 공유 앨범에 참여했는지 식별하기 위한
shareInfo
의 새 속성isJoined
해결된 문제
- 문제 79321120: 동영상 미디어 항목의 mediaItems.batchCreate 응답에
mimeType
속성이 누락되었습니다. - 문제 79319272: mediaItems.batchCreate 응답에서
mediaMetadata
,contributorInfo
등의 속성이 누락되었습니다. - 문제 110237685: CORS 관련 파일 업로드 문제가 수정되었습니다.
- 문제 79318118: mediaItems.batchCreate 호출에서 앨범에 여러 항목을 업로드할 때 일관된 순서가 유지되지 않았습니다.
Notes
- 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일
기능
mediaItems.list
를 새로 호출하여 미디어 항목을 나열합니다.- 새로운 필터
excludeNonAppCreatedData
를 사용하여 앱에서 만든 항목을 검색하거나 앨범을 나열합니다. - 이미지에 액세스하기 위한 새 매개변수:
- 문제 79871479: 이미지를 정확한 크기로 자르기 위한
c
자르기 매개변수. - 문제 110343547, 문제 111228390: 원본 이미지를 다운로드하기 위한
d
다운로드 매개변수.
- 문제 79871479: 이미지를 정확한 크기로 자르기 위한
- 이제
sharedAlbums.join
호출은 앨범을 반환합니다. - 문제 109655786: 이제
album
에 표지 사진coverPhotoMediaItemId
의 미디어 항목 ID가 포함됩니다. - 문제 79656863: 이제
mediaItem
에 미디어 항목의 파일 이름filename
가 포함됩니다.
해결된 문제
- 문제 79757390: 업로드 요청 중에 파일 이름이 설정되지 않았습니다. 미디어 업로드 가이드에서
X-Goog-Upload-File-Namefile
및X-Goog-Upload-Protocol
필드를 참고하세요. - 문제 80182372: 재개 가능한 업로드에서 오류를 반환했습니다. 업데이트된 프로토콜은 새로운 재개 가능한 업로드 가이드를 참고하세요.
- 문제 79497397: albums.list 응답에
isWriteable
속성이 누락되었습니다. - 문제 111143493:
PEOPLE
콘텐츠 카테고리 필터가 부정확한 결과를 반환했습니다. - 문제 111056278:
BIRTHDAYS
콘텐츠 카테고리 필터가 오류를 반환했습니다.
미리보기 출시 - 2018년 5월 8일
라이브러리 API의 최초 출시입니다.
알려진 문제
- 수신한 미디어 항목
id
가 공유 앨범에 있고 사용자가 소유하지 않은 미디어 항목일 경우GET mediaItem
에서 오류가 발생합니다. batchCreate
호출의 응답은mediaMetadata
또는contributorInfo
를 반환하지 않습니다.- 미디어 항목이 동영상인 경우
batchCreate
호출은mimeType
를 반환하지 않습니다. batchCreate
에서는 여러 항목을 업로드할 때 일관된 순서를 유지하지 않습니다.batchCreate
는 공유 앨범의 소유자로 미디어 항목을 만들 때 순서 (position
에 추가)를 지원하지 않습니다. 기본적으로 앨범의 끝부분에 배치됩니다.