Method: mediaItems.patch

將媒體項目更新為指定的 id。系統只會讀取媒體項目的 id 和 description 欄位。媒體項目必須由開發人員透過 API 建立，且擁有者必須為使用者。

HTTP 要求

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
mediaItem.id

string

媒體項目的 ID。這是一個永久性 ID，可在各工作階段之間用來識別這個媒體項目。

查詢參數

參數
updateMask

string (FieldMask format)

必要欄位。指出提供的媒體項目中要更新的欄位。唯一的有效值是 description。

此為以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。

要求主體

要求主體包含 MediaItem 的例項。

回應主體

如果成功，回應主體會包含 MediaItem 的執行例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata