Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.
Method: albums.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un album dans la bibliothèque Google Photos d'un utilisateur.
Requête HTTP
POST https://photoslibrary.googleapis.com/v1/albums
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"album": {
object (Album)
}
} |
| Champs |
album |
object (Album)
Obligatoire. Album à créer.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Album.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/photoslibraryhttps://www.googleapis.com/auth/photoslibrary.appendonlyhttps://www.googleapis.com/auth/photoslibrary.sharing
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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`"]]
