Além de acessar e recuperar itens de mídia depois de fazer o upload, você também pode mudar as descrições deles.
Escopo de autorização obrigatório
A alteração das descrições de conteúdo criado pelo app requer o
escopo photoslibrary.edit.appcreateddata. Para mais informações sobre escopos, consulte
Escpos de autorização.
Como mudar as descrições dos itens de mídia
Para mudar a descrição de um item de mídia, faça uma media items update
call com o identificador
do item de mídia e inclua a nova descrição na solicitação.
Para mudar a descrição de um item de mídia, seu app precisa ter feito o upload do item e o usuário autenticado precisa ser o proprietário. As descrições não podem ter mais de 1.000 caracteres.
REST
Confira 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 incluindo 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-sucedido, a resposta vai 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"
}