Method: albums.share
将影集标记为共享影集,以供其他用户访问。您只能在由开发者通过 API 创建的影集上执行该操作。
HTTP 请求
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:share
网址采用 gRPC 转码语法。
路径参数
参数 |
albumId |
string
必需。要分享的影集的标识符。此 albumId 必须属于由开发者创建的影集。
|
请求正文
请求正文中包含结构如下的数据:
字段 |
sharedAlbumOptions |
object (SharedAlbumOptions )
将影集转换为共享影集时要设置的选项。
|
响应正文
影集分享成功的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"shareInfo": {
object (ShareInfo )
}
} |
字段 |
shareInfo |
object (ShareInfo )
仅限输出。共享影集的相关信息。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/photoslibrary.sharing
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-07。
[null,null,["最后更新时间 (UTC):2024-11-07。"],[[["This method shares an existing album, making it accessible to others, but only for albums created via the API."],["The album is shared by sending a POST request to a specific URL, including the album's ID in the path."],["Request and response bodies utilize JSON format to provide and retrieve information about the shared album and its settings."],["The method requires specific authorization using the `https://www.googleapis.com/auth/photoslibrary.sharing` scope."],["This method will be deprecated starting March 31, 2025, and developers should consult the Photos APIs updates for alternatives."]]],["This document outlines the process for sharing an album via the Google Photos API, which will be deprecated after March 31, 2025. It details using a `POST` request to `https://photoslibrary.googleapis.com/v1/albums/{albumId}:share`, including the required `albumId` path parameter and a request body with `sharedAlbumOptions`. The API call needs the `https://www.googleapis.com/auth/photoslibrary.sharing` authorization scope. A successful response returns a `shareInfo` object. This only applies to albums the developer created.\n"]]