メディア アイテムを管理する

メディア アイテムをアップロードした後、アクセスして取得できるだけでなく、説明を変更することもできます。

必要な認可スコープ

アプリ作成コンテンツの説明を変更するには、photoslibrary.edit.appcreateddata スコープが必要です。スコープの詳細については、認可スコープをご覧ください。

メディア アイテムの説明の変更

メディア アイテムの説明を変更するには、メディア アイテムの ID を指定して media items update call を作成し、リクエストに新しい説明を含めます。

メディア アイテムの説明を変更するには、アプリがメディア アイテムをアップロードし、現在認証されているユーザーがオーナーである必要があります。説明は 1,000 文字以内にしてください。

REST

メディア アイテムの説明を更新する PATCH リクエスト ヘッダーは次のとおりです。

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

このリクエストでは、URL の 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"
}