管理媒體項目

除了上傳後存取及擷取媒體項目，您還可以變更媒體項目的說明。

必要的授權範圍

如要變更應用程式建立內容的說明，您必須使用 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"
}