Помимо доступа к мультимедийным элементам и их извлечения после их загрузки , вы также можете изменить их описания.
Требуемая область авторизации
Для изменения описаний контента, созданного приложением, требуется область данных photoslibrary.edit.appcreateddata
. Дополнительные сведения об областях см. в разделе Области авторизации .
Изменение описаний медиа-элементов
Чтобы изменить описание элемента мультимедиа, выполните media items update call
с идентификатором элемента мультимедиа и включите новое описание в запрос.
Чтобы изменить описание элемента мультимедиа, ваше приложение должно загрузить элемент мультимедиа, а его владельцем должен быть прошедший проверку подлинности пользователь. Описания не могут превышать 1000 символов.
Вот заголовок запроса PATCH для обновления описания медиа-элемента:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id ?updateMask=description
Этот запрос определяет, какие свойства обновляются, включая маску поля, указанную параметром updateMask
в URL-адресе.
Включите новое описание в тело запроса:
{ "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 " }