Gerenciar itens de mídia

Além de acessar mídias itens após fazer o upload deles, é possível também mudam suas descrições.

Escopo de autorização obrigatório

Para alterar as descrições de itens de mídia após a criação, use o método escopo photoslibrary.edit.appcreateddata.

Como mudar descrições de itens de mídia

Para alterar 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 no solicitação.

Para mudar a descrição de um item de mídia, o app precisa ter feito upload da mídia item, e o usuário autenticado no momento precisa ser o proprietário. As descrições podem ter no máximo 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 incluindo um 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
}