除了在accessing媒体项后对其进行访问之外,您还可以更改其说明。
所需的授权范围
如需在媒体内容创建后更改其说明,请使用 photoslibrary.edit.appcreateddata
范围。
更改媒体内容说明
如需更改媒体内容的说明,请创建一个包含媒体内容标识符的 media items update call
,并在请求中包含新的说明。
如需更改媒体项的说明,您的应用必须已上传媒体项,并且当前经过身份验证的用户必须是所有者。说明的长度不得超过 1000 个字符。
REST
以下是用于更新媒体内容说明的 PATCH 请求标头:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
此请求通过添加字段掩码(由网址中的 updateMask
参数来指示)来确定要更新的属性。
在请求正文中包含新说明:
{ "description": "new-media-item-description" }
如果成功,响应将返回更新后的媒体内容:
{ "id": "media-item-id", "description": "new-media-item-description", "productUrl": "media-item-product-url", "baseUrl": "media-items-in-album", "mimeType": "mime-type-of-media", "mediaMetadata": { ... }, "contributorInfo": { ... }, "fileName": "item-filename" }
Java
try { // Update the description of the media item. // The new description must not be null. MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description"); } catch (ApiException e) { // Handle error }
PHP
try { // ID of the media item to update. $mediaItemId = "MEDIA_ITEM_ID"; // New description of the media item. $newDescription = "new-media-item-description"; // Update the description of the media item identified. $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription); } catch (\Google\ApiCore\ApiException $e) { // Handle error }