Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.
Method: sharedAlbums.join
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Rejoint un album partagé au nom de l'utilisateur Google Photos
Requête HTTP
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
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 |
{
"shareToken": string
} |
| Champs |
shareToken |
string
Obligatoire. Jeton permettant de rejoindre l'album partagé au nom de l'utilisateur.
|
Corps de la réponse
Réponse à la demande d'adhésion à l'album partagé de la part de l'utilisateur
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"album": {
object (Album)
}
} |
| Champs |
album |
object (Album)
Album partagé auquel l'utilisateur a accédé.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://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\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`"]]
