Stai visualizzando la documentazione precedente relativa all'API della libreria di Google Foto.
Method: sharedAlbums.join
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Partecipa a un album condiviso per conto dell'utente di Google Foto.
Richiesta HTTP
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"shareToken": string
} |
| Campi |
shareToken |
string
Obbligatorio. Token per partecipare all'album condiviso per conto dell'utente.
|
Corpo della risposta
Risposta in merito all'ingresso nell'album condiviso per conto dell'utente.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"album": {
object (Album)
}
} |
| Campi |
album |
object (Album)
Album condiviso a cui l'utente partecipa.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://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\u003eJoins a shared album on behalf of a Google Photos user using a provided share token.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a shareToken to initiate the joining process.\u003c/p\u003e\n"],["\u003cp\u003eA successful response includes the details of the shared album the user has joined.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["A POST request is made to `https://photoslibrary.googleapis.com/v1/sharedAlbums:join` to join a shared album. The request body, in JSON format, requires a `shareToken` string. The successful response body contains an `album` object, also in JSON format, representing the joined shared album. Authorization for this action requires the `https://www.googleapis.com/auth/photoslibrary.sharing` OAuth scope. This uses gRPC transcoding syntax.\n"],null,["# Method: sharedAlbums.join\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 - [JSON representation](#body.JoinSharedAlbumResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nJoins a shared album on behalf of the Google Photos user.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join`\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| ``` { \"shareToken\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------|\n| `shareToken` | `string` Required. Token to join the shared album on behalf of the user. |\n\n### Response body\n\nResponse to successfully joining the shared album on behalf of the user.\n\nIf successful, the response 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)`)` Shared album that the user has joined. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
