Stai visualizzando la documentazione precedente relativa all'API della libreria di Google Foto.
Method: albums.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea un album nella raccolta di Google Foto di un utente.
Richiesta HTTP
POST https://photoslibrary.googleapis.com/v1/albums
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"album": {
object (Album)
}
} |
| Campi |
album |
object (Album)
Obbligatorio. L'album da creare.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Album appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/photoslibraryhttps://www.googleapis.com/auth/photoslibrary.appendonlyhttps://www.googleapis.com/auth/photoslibrary.sharing
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\u003eCreates a new album within a user's Google Photos library using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the album details in JSON format, specifying properties like title and description.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the newly created album object with its assigned ID and other relevant information.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using one of the specified OAuth scopes to access and modify the user's Google Photos library.\u003c/p\u003e\n"]]],["A user can create a new album in their Google Photos library by sending a `POST` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body must include an \"album\" object. Successful requests return the newly created album. This action requires authorization through one of three OAuth scopes: `photoslibrary`, `photoslibrary.appendonly`, or `photoslibrary.sharing`. The album is to be made using a JSON structured representation.\n"],null,["# Method: albums.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an album in a user's Google Photos library.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/albums`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"album\": { object (/photos/library/legacy/reference/rest/v1/albums#Album) } } ``` |\n\n| Fields ||\n|---------|----------------------------------------------------------------------------------------------------------------|\n| `album` | `object (`[Album](/photos/library/legacy/reference/rest/v1/albums#Album)`)` Required. The album to be created. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/photoslibrary`\n- `https://www.googleapis.com/auth/photoslibrary.appendonly`\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
