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

メディアへのアクセスに加えて、 アップロードした後で、 説明も変更されます。

必要な承認スコープ

メディア アイテムの作成後にその説明を変更するには、 photoslibrary.edit.appcreateddata スコープ。

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

メディア アイテムの説明を変更するには、 media items update call をメディア アイテムの ID で置き換え、新しい説明を リクエストできます。

メディア アイテムの説明を変更するには、アプリがメディアをアップロードした必要があります。 現在認証されているユーザーが所有者である必要があります。説明文は 長さは 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"
}

Java

try {
  // Update the description of the media item.
  // The new description must not be null.
  MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description");
} catch (ApiException e) {
  // Handle error
}

PHP

try {

    // ID of the media item to update.
    $mediaItemId = "MEDIA_ITEM_ID";

    // New description of the media item.
    $newDescription = "new-media-item-description";

    // Update the description of the media item identified.
    $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription);

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}