Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.
Method: albums.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie l'album en fonction du albumId spécifié. Le champ albumId doit correspondre à l'ID d'un album appartenant à l'utilisateur ou d'un album partagé que l'utilisateur a rejoint.
Requête HTTP
GET https://photoslibrary.googleapis.com/v1/albums/{albumId}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
albumId |
string
Obligatoire. Identifiant de l'album à demander.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Album.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
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\u003eThis endpoint retrieves a specific album using its unique identifier (\u003ccode\u003ealbumId\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request must include the \u003ccode\u003ealbumId\u003c/code\u003e of an album the user owns or has joined as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and a successful response returns the album details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using one of the specified OAuth scopes for Photos Library access.\u003c/p\u003e\n"]]],["This outlines retrieving an album via a `GET` request to `https://photoslibrary.googleapis.com/v1/albums/{albumId}`, where `albumId` is a required path parameter. The request body must be empty. A successful response returns an `Album` instance. Authorization requires one of three specified OAuth scopes. Only the album owner or members of a shared album can use the albumId to retreive the album.\n"],null,["# Method: albums.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the album based on the specified `albumId`. The `albumId` must be the ID of an album owned by the user or a shared album that the user has joined.\n\n### HTTP request\n\n`GET https://photoslibrary.googleapis.com/v1/albums/{albumId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------|\n| `albumId` | `string` Required. Identifier of the album to be requested. |\n\n### Request body\n\nThe request body must be empty.\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 one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/photoslibrary`\n- `\n https://www.googleapis.com/auth/photoslibrary.readonly`\n- `\n https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata`"]]
