Gestisci elementi multimediali

Oltre ad accedere ai contenuti multimediali elementi dopo il caricamento, puoi ne modificano le descrizioni.

Ambito dell'autorizzazione richiesto

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

Modifica delle descrizioni degli elementi multimediali

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

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

REST

Di seguito è riportata un'intestazione di 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
}