REST Resource: albums

Risorsa: Album

Rappresentazione di un album in Google Foto. Gli album sono contenitori di 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 una sessione e l'altra 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. Questo URL non deve essere utilizzato 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.

ShareInfo

Informazioni sugli album condivisi. Queste informazioni vengono incluse solo se l'album è stato creato da te, se quest'ultimo è stato condiviso e se disponi dell'ambito di condivisione.

Rappresentazione JSON 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Campi
sharedAlbumOptions

object (SharedAlbumOptions)

Opzioni che controllano se una persona può aggiungere elementi multimediali a un album condiviso o commentarlo.
shareableUrl

string

Un link all'album di Google Foto condiviso. Chiunque abbia il link può visualizzare i contenuti dell'album, quindi deve essere trattato con attenzione.

Il parametro shareableUrl viene restituito solo se per l'album è attivata la condivisione tramite link. Se un utente è già membro di un album che non è condiviso tramite link, può utilizzare il productUrl dell'album per accedervi.

Un shareableUrl viene invalidato se il proprietario disattiva la condivisione tramite link nell'app Google Foto o se l'album non è condiviso.
shareToken

string

Token utilizzato per partecipare, abbandonare o recuperare i dettagli di un album condiviso per conto di un utente che non è il proprietario.

Un shareToken viene invalidato se il proprietario disattiva la condivisione tramite link nell'app Google Foto o se l'album non viene condiviso.
isJoined

boolean

True se l'utente è membro dell'album. Questo vale sempre per il proprietario dell'album.
isOwned

boolean

True se l'utente è il proprietario dell'album.
isJoinable

boolean

True se gli utenti possono partecipare all'album.

SharedAlbumOptions

Opzioni che controllano la condivisione di un album.

Rappresentazione JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Campi
isCollaborative

boolean

True se l'album condiviso consente ai collaboratori (utenti che hanno aderito all'album) di aggiungervi elementi multimediali. Il valore predefinito è false.
isCommentable

boolean

True se l'album condiviso consente ai collaboratori (utenti che si sono uniti all'album) di aggiungere commenti all'album. Il valore predefinito è false.

Metodi

addEnrichment

 Aggiunge un arricchimento in una posizione specificata in un album definito.

batchAddMediaItems

 Aggiunge a un album uno o più elementi multimediali presenti nella raccolta di Google Foto di un utente.

batchRemoveMediaItems

 Rimuove uno o più elementi multimediali da un album specificato.

create

 Crea un album nella raccolta di Google Foto di un utente.

get

 Restituisce l'album in base al albumId specificato.

list

 Elenca tutti gli album mostrati a un utente nella scheda Album dell'app Google Foto.

patch

 Aggiorna l'album con il id specificato.

share

 Contrassegna un album come condiviso e accessibile ad altri utenti.

unshare

 Contrassegna come privato un album condiviso in precedenza.