Le 1er avril 2025, certains champs d'application de l'API Library ont été supprimés.
En savoir plus
REST Resource: albums
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: Album
Représentation d'un album dans Google Photos. Les albums sont des conteneurs pour les éléments multimédias. Si un album a été partagé par l'application, il contient une propriété shareInfo
supplémentaire.
Représentation JSON |
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo )
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
Champs |
id |
string
Identifiant de l'album. Il s'agit d'un identifiant persistant qui peut être utilisé d'une session à l'autre pour identifier cet album.
|
title |
string
Nom de l'album présenté à l'utilisateur dans son compte Google Photos. Cette chaîne ne doit pas comporter plus de 500 caractères.
|
productUrl |
string
[Sortie uniquement] URL Google Photos de l'album. L'utilisateur doit être connecté à son compte Google Photos pour accéder à ce lien.
|
isWriteable |
boolean
[Sortie uniquement] "True" si vous pouvez créer des éléments multimédias dans cet album. Ce champ est basé sur les portées accordées et les autorisations de l'album. Si les champs d'application ou les autorisations de l'album sont modifiés, ce champ est mis à jour.
|
shareInfo |
object (ShareInfo )
[Sortie uniquement] Informations sur les albums partagés. Ce champ n'est renseigné que si l'album est partagé, que le développeur l'a créé et que l'utilisateur a accordé la portée photoslibrary.sharing .
|
mediaItemsCount |
string (int64 format)
[Sortie uniquement] Nombre d'éléments multimédias de l'album.
|
coverPhotoBaseUrl |
string
[Sortie uniquement] URL des octets de la photo de couverture. Cette URL ne doit pas être utilisée telle quelle. Des paramètres doivent être ajoutés à cette URL avant de l'utiliser. Pour obtenir la liste complète des paramètres compatibles, consultez la documentation destinée aux développeurs. Par exemple, '=w2048-h1024' définit la largeur de la photo de couverture sur 2 048 px et sa hauteur sur 1 024 px.
|
coverPhotoMediaItemId |
string
Identifiant de l'élément multimédia associé à la photo de couverture.
|
ShareInfo
Informations sur les albums partagés. Ces informations ne sont incluses que si vous avez créé l'album, qu'il est partagé et que vous disposez de l'étendue de partage.
Représentation JSON |
{
"sharedAlbumOptions": {
object (SharedAlbumOptions )
},
"shareableUrl": string,
"shareToken": string,
"isJoined": boolean,
"isOwned": boolean,
"isJoinable": boolean
} |
Champs |
sharedAlbumOptions |
object (SharedAlbumOptions )
Options permettant de contrôler si une personne peut ajouter des éléments multimédias à un album partagé ou y ajouter des commentaires.
|
shareableUrl |
string
Lien vers l'album Google Photos partagé. Toutes les personnes disposant du lien peuvent consulter le contenu de l'album. Il doit donc être utilisé avec précaution. Le paramètre shareableUrl n'est renvoyé que si le partage par lien est activé pour l'album. Si un utilisateur est déjà membre d'un album qui n'est pas partagé par lien, il peut utiliser l'productUrl de l'album pour y accéder à la place. Un shareableUrl est invalidé si le propriétaire désactive le partage par lien dans l'application Google Photos ou si l'album n'est plus partagé.
|
shareToken |
string
Jeton utilisé pour rejoindre, quitter ou récupérer les informations d'un album partagé au nom d'un utilisateur qui n'en est pas le propriétaire. Un shareToken est invalidé si le propriétaire désactive le partage par lien dans l'application Google Photos ou si l'album n'est plus partagé.
|
isJoined |
boolean
"True" si l'utilisateur est associé à l'album. C'est toujours le cas pour le propriétaire de l'album.
|
isOwned |
boolean
"True" si l'utilisateur est le propriétaire de l'album.
|
isJoinable |
boolean
"True" si les utilisateurs peuvent rejoindre l'album.
|
SharedAlbumOptions
Options qui contrôlent le partage d'un album.
Représentation JSON |
{
"isCollaborative": boolean,
"isCommentable": boolean
} |
Champs |
isCollaborative |
boolean
"True" si l'album partagé permet aux collaborateurs (utilisateurs qui ont rejoint l'album) d'y ajouter des éléments multimédias. Valeur par défaut : "false".
|
Méthodes |
|
Ajoute un enrichissement à une position spécifiée dans un album créé par une application. |
|
Ajoute un ou plusieurs éléments multimédias créés par l'application dans la bibliothèque Google Photos d'un utilisateur à un album créé par l'application. |
|
Supprime un ou plusieurs éléments multimédias créés par l'application d'un album créé par l'application spécifié. |
|
Crée un album dans la bibliothèque Google Photos d'un utilisateur. |
|
Renvoie l'album créé par l'application en fonction du albumId spécifié. |
|
Répertorie tous les albums créés par votre application. |
|
Mettez à jour l'album créé par l'application avec le id spécifié. |
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/04/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/04/01 (UTC)."],[[["Google Photos Albums are containers for media items and can be shared with others."],["Shared albums have properties controlling adding media and comments, along with shareable links and tokens."],["Albums include metadata such as title, product URL, cover photo, and media item count."],["Developers can programmatically manage albums using various methods like create, get, list, and update."],["Some album management method scopes are subject to removal or change."]]],["Google Photos albums, serving as media containers, include properties like `id`, `title`, and `productUrl`. Shared albums have `shareInfo`, which contains a `shareableUrl`, `shareToken`, and booleans for user interaction (`isJoined`, `isOwned`, `isJoinable`). Sharing options (`SharedAlbumOptions`) determine collaboration (`isCollaborative`) and commenting (`isCommentable`). Methods for albums include adding/removing media, creating, retrieving, updating (patching), and managing sharing (share/unshare, which will stop working after March 31, 2025).\n"]]