Il 1° aprile 2025 sono stati rimossi alcuni ambiti nell'API Library.
Scopri di più qui.
Gestisci elementi multimediali
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
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"
}
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eAfter uploading media items to Google Photos, you can change their descriptions using the Google Photos API.\u003c/p\u003e\n"],["\u003cp\u003eModifying descriptions of app-created content requires the \u003ccode\u003ephotoslibrary.edit.appcreateddata\u003c/code\u003e scope and ownership by the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eTo update a description, use the \u003ccode\u003emediaItems/patch\u003c/code\u003e endpoint with the item's ID and a request body containing the new description.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eupdateMask\u003c/code\u003e parameter in the request URL specifies that only the description is being modified.\u003c/p\u003e\n"],["\u003cp\u003eThe response to a successful update request will return the complete updated media item object.\u003c/p\u003e\n"]]],["To modify a media item's description, use a `media items update call` with a PATCH request, specifying the item's ID and the `updateMask` parameter. Include the new description in the request body, ensuring it's under 1,000 characters. This requires the `photoslibrary.edit.appcreateddata` scope, with the app having uploaded the media, and the authenticated user must be the owner. A successful request returns the updated media item details, including the new description.\n"],null,["# Manage media items\n\nIn addition to [accessing and\nretrieving](/photos/library/guides/access-media-items) media items after you\n[upload](/photos/library/guides/upload-media) them, you can also change their\ndescriptions.\n\nRequired authorization scope\n----------------------------\n\nChanging descriptions of app-created content requires the\n`photoslibrary.edit.appcreateddata` scope. For more information on scopes, see\n[Authorization scopes](/photos/overview/authorization).\n\nChanging media item descriptions\n--------------------------------\n\nTo change a media item's description, make a [`media items update\ncall`](/photos/library/reference/rest/v1/mediaItems/patch) with the identifier\nof the media item, and include the new description in the request.\n\nTo change a media item's description, your app must have uploaded the media\nitem, and the currently authenticated user must be the owner. Descriptions can\nbe no more than 1,000 characters in length. \n\n### REST\n\nHere's a PATCH request header to update a media item description: \n\n```\nPATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description\n```\n\nThis request determines what properties are being updated by including a\nfield mask, indicated by the `updateMask` parameter in the URL.\n\nInclude the new description in the body of the request: \n\n```restructuredtext\n{\n \"description\": \"new-media-item-description\"\n}\n```\n\nIf successful, the response returns the updated media item: \n\n```restructuredtext\n{\n \"id\": \"media-item-id\",\n \"description\": \"\u003cvar translate=\"no\"\u003enew-media-item-description\u003c/var\u003e\",\n \"productUrl\": \"media-item-product-url\",\n \"baseUrl\": \"media-items-in-album\",\n \"mimeType\": \"mime-type-of-media\",\n \"mediaMetadata\": {\n ...\n },\n \"contributorInfo\": {\n ...\n },\n \"fileName\": \"\u003cvar translate=\"no\"\u003eitem-filename\u003c/var\u003e\"\n}\n```"]]
