Esta é a documentação legada da API Google Photos Library.
Method: albums.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Retorna o álbum com base no albumId especificado. O albumId precisa ser o ID de um álbum de propriedade do usuário ou de um álbum compartilhado do qual ele participa.
Solicitação HTTP
GET https://photoslibrary.googleapis.com/v1/albums/{albumId}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
albumId |
string
Obrigatório. Identificador do álbum a ser solicitado.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Album.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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`"]]
