除了在上傳後accessing媒體項目之外,也可以變更其說明。
必要的授權範圍
如要在建立媒體項目後變更說明,請使用 photoslibrary.edit.appcreateddata
範圍。
變更媒體項目說明
如要變更媒體項目的說明,請使用媒體項目的 ID 建立 media items update call
,並在要求中加入新的說明。
如要變更媒體項目的說明,應用程式必須上傳媒體項目,而且目前驗證的使用者必須是擁有者。說明長度不得超過 1,000 個字元。
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 }