Stai visualizzando la documentazione precedente relativa all'API della libreria di Google Foto.
Method: albums.patch
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Aggiorna l'album con il id specificato. Vengono letti solo i campi id, title e coverPhotoMediaItemId dell'album. L'album deve essere stato creato dallo sviluppatore tramite l'API e deve essere di proprietà dell'utente.
Richiesta HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
album.id |
string
Identificatore dell'album. Si tratta di un identificatore permanente che può essere utilizzato tra le sessioni per identificare l'album.
|
Parametri di query
| Parametri |
updateMask |
string (FieldMask format)
Obbligatorio. Indica quali campi dell'album fornito aggiornare. Gli unici valori validi sono title e coverPhotoMediaItemId. Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Album.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Album.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
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-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis API updates an album with a specified ID, modifying only the title and cover photo, if provided in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe album being updated must have been created by the developer via the API and be owned by the user.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003ePATCH\u003c/code\u003e request is used, targeting the album's ID in the URL.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003eupdateMask\u003c/code\u003e query parameter is required to specify which album fields (title, coverPhotoMediaItemId) are being updated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eAlbum\u003c/code\u003e object with the updated fields, and the response, if successful, also contains an \u003ccode\u003eAlbum\u003c/code\u003e object.\u003c/p\u003e\n"]]],["This describes updating an album using a PATCH request to `https://photoslibrary.googleapis.com/v1/albums/{album.id}`. The `album.id` path parameter identifies the target album. The `updateMask` query parameter, with values `title` or `coverPhotoMediaItemId`, specifies which album fields to update. The request body contains the updated album information, while the successful response body returns the updated album. This operation requires the `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata` authorization scope. Only albums created via the API and owned by the user can be modified.\n"],null,["# Method: albums.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdate the album with the specified `id`. Only the `id`, `title` and `coverPhotoMediaItemId` fields of the album are read. The album must have been created by the developer via the API and must be owned by the user.\n\n### HTTP request\n\n`PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------|\n| `album.id` | `string` Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. Indicate what fields in the provided album to update. The only valid values are `title` and `coverPhotoMediaItemId`. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Response body\n\nIf successful, the response body contains an instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata`"]]
