미디어 항목 관리

미디어에 액세스하고 항목을 업로드한 후에는 설명도 변경할 수 있습니다

필수 승인 범위

미디어 항목을 만든 후 해당 설명을 변경하려면 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"
}

자바

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
}