Gestisci elementi multimediali

Oltre ad accedere e recuperare gli elementi multimediali dopo averli caricati, puoi anche modificarne le descrizioni.

Ambito dell'autorizzazione richiesto

Per modificare le descrizioni dei contenuti creati dall'app è necessario lo scopo photoslibrary.edit.appcreateddata. Per ulteriori informazioni sugli ambiti, consulta Ambiti di autorizzazione.

Modificare le descrizioni degli elementi multimediali

Per modificare la descrizione di un elemento multimediale, crea un 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, la tua app deve aver caricato l'elemento multimediale e l'utente attualmente autenticato deve essere il proprietario. Le descrizioni non possono avere più di 1000 caratteri.

REST

Ecco un'intestazione della 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 campi, indicata dal parametro updateMask nell'URL.

Includi la nuova descrizione nel corpo della richiesta:

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

In caso di 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"
}