Method: mediaItems.patch

使用指定的 id 更新媒體項目。系統只會讀取媒體項目的 iddescription 欄位。媒體項目必須由開發人員透過 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