Gestisci elementi multimediali

Oltre ad accessing agli elementi multimediali dopo averli caricati, puoi anche modificarne le descrizioni.

Ambito dell'autorizzazione obbligatorio

Per modificare le descrizioni degli elementi multimediali dopo la loro creazione, utilizza l'ambito photoslibrary.edit.appcreateddata.

Modifica delle descrizioni degli elementi multimediali

Per modificare la descrizione di un elemento multimediale, crea un elemento media items update call con l'identificatore dell'elemento multimediale e includi la nuova descrizione nella richiesta.

Per modificare la descrizione di un elemento multimediale, l'app deve aver caricato l'elemento multimediale e l'utente attualmente autenticato deve essere il proprietario. Le descrizioni non possono contenere più di 1000 caratteri.

REST

Di seguito è riportata l'intestazione di una richiesta PATCH per aggiornare la descrizione di un elemento multimediale:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Questa richiesta determina quali proprietà vengono aggiornate includendo una maschera di campo, indicata dal parametro updateMask nell'URL.

Includi la nuova descrizione nel corpo della richiesta:

{
  "description": "new-media-item-description"
}

Se l'esito è positivo, la risposta restituisce l'elemento multimediale aggiornato:

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