Stai visualizzando la documentazione precedente relativa all'API della libreria di Google Foto.
REST Resource: sharedAlbums
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: Album
Rappresentazione di un album in Google Foto. Gli album sono contenitori per elementi multimediali. Se un album è stato condiviso dall'applicazione, contiene una proprietà shareInfo aggiuntiva.
| Rappresentazione JSON |
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| Campi |
id |
string
Identificatore dell'album. Si tratta di un identificatore permanente che può essere utilizzato tra le sessioni per identificare l'album.
|
title |
string
Nome dell'album mostrato all'utente nel suo account Google Foto. Questa stringa non deve contenere più di 500 caratteri.
|
productUrl |
string
[Solo output] URL di Google Foto per l'album. Per accedere a questo link, l'utente deve aver eseguito l'accesso al proprio account Google Foto.
|
isWriteable |
boolean
[Solo output] True se puoi creare elementi multimediali in questo album. Questo campo si basa sugli ambiti concessi e sulle autorizzazioni dell'album. Se gli ambiti vengono modificati o le autorizzazioni dell'album vengono modificate, questo campo viene aggiornato.
|
shareInfo |
object (ShareInfo)
[Solo output] Informazioni relative agli album condivisi. Questo campo viene compilato solo se l'album è un album condiviso, se è stato creato dallo sviluppatore e se l'utente ha concesso l'ambito photoslibrary.sharing.
|
mediaItemsCount |
string (int64 format)
[Solo output] Il numero di elementi multimediali nell'album.
|
coverPhotoBaseUrl |
string
[Solo output] Un URL che rimanda ai byte della foto di copertina. Questa opzione non deve essere utilizzata così com'è. I parametri devono essere aggiunti a questo URL prima dell'uso. Per un elenco completo dei parametri supportati, consulta la documentazione per gli sviluppatori. Ad esempio, '=w2048-h1024' imposta le dimensioni della foto di copertina su una larghezza di 2048 px e un'altezza di 1024 px.
|
coverPhotoMediaItemId |
string
Identificatore dell'elemento multimediale associato alla foto di copertina.
|
Metodi |
|
|
Restituisce l'album in base al valore shareToken specificato. |
|
|
Partecipa a un album condiviso per conto dell'utente di Google Foto. |
|
|
Abbandona un album condiviso a cui l'utente ha già partecipato in precedenza per conto dell'utente di Google Foto. |
|
|
Elenca tutti gli album condivisi disponibili nella scheda Condivisione dell'app Google Foto dell'utente. |
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\u003eAlbums in Google Photos are containers for media items and can be shared.\u003c/p\u003e\n"],["\u003cp\u003eShared albums have a \u003ccode\u003eshareInfo\u003c/code\u003e property and developers can access them with the \u003ccode\u003ephotoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAlbum\u003c/code\u003e resource provides methods to get, join, leave, and list shared albums.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAlbum\u003c/code\u003e properties provide information such as ID, title, URL, writability status, media count, and cover photo details.\u003c/p\u003e\n"]]],["Albums in Google Photos are containers for media items, identified by a unique `id` and a user-facing `title`. Key details include the album's `productUrl`, whether it's `isWriteable`, `mediaItemsCount`, and cover photo information (`coverPhotoBaseUrl`, `coverPhotoMediaItemId`). Shared albums contain a `shareInfo` property. Actions include: retrieving albums with a `shareToken`, joining, leaving, and listing shared albums via methods such as `get`, `join`, `leave`, and `list`.\n"],null,["# REST Resource: sharedAlbums\n\n- [Resource: Album](#Album)\n - [JSON representation](#Album.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Album\n---------------\n\nRepresentation of an album in Google Photos. Albums are containers for media items. If an album has been shared by the application, it contains an extra `shareInfo` property.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"productUrl\": string, \"isWriteable\": boolean, \"shareInfo\": { object (/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo) }, \"mediaItemsCount\": string, \"coverPhotoBaseUrl\": string, \"coverPhotoMediaItemId\": string } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album. |\n| `title` | `string` Name of the album displayed to the user in their Google Photos account. This string shouldn't be more than 500 characters. |\n| `productUrl` | `string` \\[Output only\\] Google Photos URL for the album. The user needs to be signed in to their Google Photos account to access this link. |\n| `isWriteable` | `boolean` \\[Output only\\] True if you can create media items in this album. This field is based on the scopes granted and permissions of the album. If the scopes are changed or permissions of the album are changed, this field is updated. |\n| `shareInfo` | `object (`[ShareInfo](/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo)`)` \\[Output only\\] Information related to shared albums. This field is only populated if the album is a shared album, the developer created the album and the user has granted the `photoslibrary.sharing` scope. |\n| `mediaItemsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` \\[Output only\\] The number of media items in the album. |\n| `coverPhotoBaseUrl` | `string` \\[Output only\\] A URL to the cover photo's bytes. This shouldn't be used as is. Parameters should be appended to this URL before use. See the [developer documentation](https://developers.google.com/photos/library/guides/access-media-items#base-urls) for a complete list of supported parameters. For example, `'=w2048-h1024'` sets the dimensions of the cover photo to have a width of 2048 px and height of 1024 px. |\n| `coverPhotoMediaItemId` | `string` Identifier for the media item associated with the cover photo. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| ### [get](/photos/library/legacy/reference/rest/v1/sharedAlbums/get) | Returns the album based on the specified `shareToken`. |\n| ### [join](/photos/library/legacy/reference/rest/v1/sharedAlbums/join) | Joins a shared album on behalf of the Google Photos user. |\n| ### [leave](/photos/library/legacy/reference/rest/v1/sharedAlbums/leave) | Leaves a previously-joined shared album on behalf of the Google Photos user. |\n| ### [list](/photos/library/legacy/reference/rest/v1/sharedAlbums/list) | Lists all shared albums available in the Sharing tab of the user's Google Photos app. |"]]
