REST Resource: sharedAlbums

Ressource: Album

Représentation d'un album dans Google Photos. Les albums sont des conteneurs d'é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é entre les sessions pour identifier cet album.

title

string

Nom de l'album affiché dans le compte Google Photos de l'utilisateur. Cette chaîne ne doit pas comporter plus de 500 caractères.

productUrl

string

[Uniquement en sortie] URL Google Photos de l'album. L'utilisateur doit être connecté à son compte Google Photos pour accéder à ce lien.

isWriteable

boolean

[Uniquement en sortie] Vrai si vous pouvez créer des éléments multimédias dans cet album. Ce champ est basé sur les niveaux d'accès accordés 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)

[Uniquement en sortie] Informations relatives aux albums partagés. Ce champ n'est renseigné que s'il s'agit d'un album partagé, si le développeur l'a créé et si l'utilisateur a accordé le champ d'application photoslibrary.sharing.

mediaItemsCount

string (int64 format)

[Uniquement en sortie] Nombre d'éléments multimédias dans l'album.

coverPhotoBaseUrl

string

[Uniquement en sortie] URL des octets de la photo de couverture. Ce champ ne doit pas être utilisé tel quel. Avant de l'utiliser, vous devez ajouter des paramètres à cette URL. Consultez la documentation destinée aux développeurs pour obtenir la liste complète des paramètres acceptés. Par exemple, '=w2048-h1024' définit les dimensions de la photo de couverture sur une largeur de 2 048 pixels et une hauteur de 1 024 pixels.

coverPhotoMediaItemId

string

Identifiant de l'élément multimédia associé à la photo de couverture.

Méthodes

get

Renvoie l'album en fonction de la valeur shareToken spécifiée.

join

Joint un album partagé au nom de l'utilisateur de Google Photos.

leave

Permet de quitter un album partagé précédemment rejoint au nom de l'utilisateur Google Photos.

list

Liste tous les albums partagés disponibles dans l'onglet "Partage" de l'application Google Photos de l'utilisateur.