미디어 항목 관리

미디어 항목을 업로드한 후 미디어 항목의 액세스 및 검색 외에 항목 설명도 변경할 수 있습니다.

필수 승인 범위

앱에서 생성된 콘텐츠의 설명을 변경하려면 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"
}