Gerenciar itens de mídia

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"
}