Além de accessing os itens de mídia após o upload deles, também é possível mudar as descrições deles.
Escopo de autorização obrigatório
Para mudar as descrições de itens de mídia após a criação, use o
escopo photoslibrary.edit.appcreateddata
.
Como mudar descrições de itens de mídia
Para mudar a descrição de um item de mídia, crie um
media items update call
com o identificador desse item e inclua a nova descrição na
solicitação.
Para mudar a descrição de um item de mídia, o app precisa ter feito upload desse item, e o usuário autenticado no momento precisa ser o proprietário. As descrições não podem ter mais de 1.000 caracteres.
REST
Este é um cabeçalho de solicitação PATCH para atualizar a descrição de um item de mídia:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
Essa solicitação determina quais propriedades estão sendo atualizadas ao incluir uma máscara de campo, indicada pelo parâmetro updateMask
no URL.
Inclua a nova descrição no corpo da solicitação:
{ "description": "new-media-item-description" }
Se for bem-sucedida, a resposta retornará o item de mídia atualizado:
{ "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 }