リリースノートを 配信登録してください。
このページは Google Photos Library API がリリースされるたびに更新されます。変更履歴には日付順にリリースが一覧表示され、新機能、バグの修正、その他の変更が記載されています。
ドキュメントとガイドは、使用できる最新バージョンを参照しています。
2022 年 10 月 27 日
メモ
- 「Google フォトと Flutter で写真共有アプリを作成する」Codelab は提供を終了しました。その他のサンプルと、ガイド内のサンプルコードをご覧ください。
2022 年 6 月 1 日
メモ
- アップロードに関するおすすめの方法を追加しました。アップロード プロセスを明確にし、よくあるエラーとその回避方法を説明し、アップロード効率を高めるためのヒントを紹介します。
2021 年 10 月 27 日
機能
- Google フォト パートナー プログラム: プレミア ティアを開始。 プレミア ティアは、Google フォトの強力なマシン インテリジェンスを活用した拡張 API のスイートです。
2021 年 9 月 29 日
機能
- 日付フィルタに基づいて検索を並べ替えるための新しいオプション。結果は新しい順または古い順に並べ替えることができます。これにより、検索が容易になり、ターゲットを絞った検索結果が提供されるため、効率が向上します。
2021 年 7 月 21 日
機能
- 再生ボタンのオーバーレイなしでサムネイルを読み込むための、動画のベース URL 用の新しい
-no
パラメータ。デフォルトでは、動画のサムネイルは再生ボタンのオーバーレイとともに読み込まれます。この新しいパラメータを使用すると、動画のサムネイルの再生ボタンを非表示にすることができます。
解決済みの問題
- 問題 181282432: 動画のサムネイルが常に再生ボタンのオーバーレイとともに表示される。
2021 年 5 月 25 日
解決済みの問題
- メディア アイテムの
photo
メタデータでexposureTime
プロパティが入力されていませんでした。
2021 年 5 月 19 日
メモ
- モーション フォトのベース URL ドキュメントを更新し、Android モーション フォトと iOS Live Photos の
=dv
パラメータの動作を明確にしました。
2021 年 2 月 11 日
メモ
- 利用規定が更新され、広告に関するコンテンツが追加され、データ使用量を最小限に抑えることができるようになりました。
2020 年 7 月 7 日
機能
- Google フォトの新しい共有管理をサポートするように API が更新されました。共有アルバムの
shareInfo
プロパティの一部として、新しいフィールドisJoinable
が返されるようになりました。isJoinable
がtrue
の場合、API で共有アルバムにユーザーを追加できます。オーナーが Google フォトでアルバムのリンク共有を無効にしている場合、isJoinable
はfalse
になり、API はそのアルバムにユーザーに参加できません。 - 問題 111405623、116379853、117685011: アルバムのタイトルとカバー写真の変更と、アプリが作成したメディア アイテムの説明を変更できるようになりました。更新アクセス用に、新しい
photoslibrary.edit.appcreateddata
認可スコープをリクエストします。
2020 年 2 月 17 日
機能
- 写真のアップロード ファイルのサイズの上限が 75 MB から 200 MB に引き上げられました。
- ファイルをアップロードするときに、バイト アップロード ステージで MIME タイプを指定する必要があります。
- メディアのバイトをアップロードするときではなく、メディア アイテムを作成するときにファイル名を指定するようになりました。
simpleMediaItem
の新しいfileName
プロパティは UTF-8 文字列をサポートしています。メディアバイトのアップロード時にもメディア アイテムのファイル名を指定できますが、実装を更新することを強くおすすめします。
メモ
- 利用規定が更新され、データの使用とストレージの最小化に重点を置いた詳細な情報が追加されました。
- ベース 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
)に一致するメディア アイテムをフィルタできるようになりました。
メモ
- UX ガイドラインを更新し、プロジェクトやアルバムの命名に関するガイダンスを追加しました。
2019 年 5 月 7 日
Codelab
- 新しい Codelab: Google フォトと Flutter で写真共有アプリを作成する。 Flutter で Google Photos Library API を使用して写真共有アプリを作成する方法を学習します。詳しくは、サンプルガイドをご覧ください。
2019 年 4 月 29 日
機能
問題 109505022: アルバムに対して既存のメディア アイテムを追加および削除する新しい呼び出し:
これらの呼び出しは、アプリによって作成されたメディア アイテムとアルバムをサポートします。詳しくは、アルバムの管理に関するデベロッパー ガイドをご覧ください。
メディア アイテムを作成するための REST 呼び出し
mediaItems.batchCreate
は、一部のメディア アイテムが作成されなかった場合に、部分的な成功を示す HTTP ステータス207 MULTI-STATUS
を返すようになりました。詳しくは、デベロッパー ガイドのメディアのアップロードをご覧ください。
メモ
- 最新バージョンのクライアント ライブラリには互換性を破る変更が含まれています。
MediaItem
、Album
、DateRange
に関連するクラスが新しい専用パッケージに移動しました。機能に変更はなく、クライアント ライブラリ内の場所のみが変更されました。Java クライアント ライブラリ(1.2.0)と PHP クライアント ライブラリ(1.2.0)のリリースノートをご覧ください。
2019 年 2 月 14 日
メモ
- ベース URL からメディアのバイトにアクセスするための新しい割り当て上限が適用されます。この割り当ては Google API Console でモニタリングできます。
解決済みの問題
- 問題 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 日
機能
- Java と PHP のクライアント ライブラリが利用できるようになりました。
メモ
- Google Photos Library API の一般提供が開始されました。Library API デベロッパー プレビュー期間中、フィードバックや機能リクエストをお送りいただき、ありがとうございました。
- Java と PHP のクライアント ライブラリの利用を開始するための新しいガイドをご覧ください。
- クライアント ライブラリの使用方法を示すために、Java と PHP のサンプル コード スニペットがガイドに追加されました。
2018 年 9 月 5 日
機能
- 新しい
sharedAlbums.get
を呼び出して、shareToken
を使用してアルバムを取得します。 - ユーザーが共有アルバムに参加したかどうかを識別する
shareInfo
の新しいプロパティisJoined
。
解決済みの問題
- 問題 79321120: 動画メディア アイテムの mediaItems.batchCreate レスポンスに
mimeType
プロパティが含まれていなかった。 - 問題 79319272: mediaItems.batchCreate のレスポンスに
mediaMetadata
、contributorInfo
などのプロパティが含まれていなかった。 - 問題 110237685: CORS 関連のファイルのアップロードに関する問題を修正しました。
- 問題 79318118: mediaItems.batchCreate 呼び出しで複数のアイテムをアルバムにアップロードすると、順序の一貫性が維持されない。
メモ
- 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
にカバー写真のメディア アイテム IDcoverPhotoMediaItemId
が含まれるようになりました。 - 問題 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 日
Library API の初回リリース。
既知の問題
GET mediaItem
は、受け取ったメディア アイテムid
が共有アルバムのメディア アイテムのもので、ユーザーが所有していない場合、エラーをスローします。batchCreate
呼び出しからのレスポンスでmediaMetadata
やcontributorInfo
は返されません。- メディア アイテムが動画の場合、
batchCreate
を呼び出してもmimeType
は返されません。 - 複数のアイテムをアップロードする際に、
batchCreate
では順序の一貫性が保たれません。 batchCreate
では、共有アルバムのオーナーとして共有アルバムにメディア アイテムを作成する場合の順序付け(position
への追加)はサポートされていません。デフォルトはアルバムの末尾です。