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