Google相片库API正式上线，让开发者在自家应用加入相簿功能

Google在今年I/O大会所发表的Google相片库API（Photos Library API），现在已经释出PHP和Java客户端API正式版本，开发者可以利用这些API在自家应用程序中读取、写入以及分享Google相簿中的照片以及影片。

这个Google相片库API是RESTful API，以Google产品Photos为概念，设计出整体API的架构，主要提供照片库、相簿、媒体档案以及分享功能。相片库API最重要的功能便是列出用户备份到Google相簿的媒体档案，可以列出特定相簿或是整个相片库的档案，开发者可以使用过滤器设置特定日期、内容类型或是档案类别，以存取特定的照片。该API包含多个用来存取媒体档案和相簿的可视范围（Scope），根据开发人员请求的可视范围，不同呼叫回传不同的媒体档案。

Google相片库API还可以让开发者，以相簿整理照片或是其他媒体档案，一个媒体档案可以与多个相簿关联，但要关联照片之前，应用程序需要先创建相簿。此外，还可以透过共享相簿来共享媒体，开发者的应用程序可以创建共享相簿，除了与其他使用者共享外，还能整合显示其他用户共享的相簿。应用程序的相簿权限为，仅能共享在使用者相簿中的媒体，也只能共享由应用程序创建的相簿，而且开发者的应用程序只能整合显示，由该应用程序所创建与共享的使用者相簿。

Google特别提醒了开发者，在呼叫照片内容列表之后，应用程序应该储存媒体档案的ID，而非回传的档案本身，因为媒体档案内容可能会有改变，并且在一定时间之后，回应的内容包括URL会过期，但媒体档案的ID则是唯一识别资讯。另外，开发者不应长时间快取使用者的资料，还需要遵守隐私义务。

相片库API最先在5月初时释出预览版，在经过4个月的测试开发后，终于释出了正式版，这次同时发布了PHP以及Java版本。Java客户端函式库至少需要Java 1.8+，可以选择使用Gradle或是Maven 3.0+建置工具，另外还需要为专案设置OAuth 2.0凭证。而PHP客户端函式库必须使用PHP相依性管理器Composer，且PHP安装时必须包括bcmath扩充套件，同样也需要在专案中设置OAuth 2.0凭证。

和其他Google REST API一样，相片库API也使用OAuth 2.0来处理身份验证和授权。开发者的应用程序可以透过API提供的各种授权可视范围，请求存取使用者的照片库，另外，相片库API不支援服务账户，使用者必须登入自己的Google账户。