미디어 항목 관리

미디어 항목을 업로드한 후 미디어 항목에 accessing하는 것 외에 설명을 변경할 수도 있습니다.

필수 승인 범위

미디어 항목을 만든 후 설명을 변경하려면 photoslibrary.edit.appcreateddata 범위를 사용합니다.

미디어 항목 설명 변경

미디어 항목의 설명을 변경하려면 미디어 항목의 식별자로 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"
}

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
}

2,399필리핀

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
}