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 le sessioni per identificare l'album.
title

string

Il 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. Questa opzione non deve essere utilizzata 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 consentono di specificare se un utente può aggiungere elementi multimediali o commentare un album condiviso.
shareableUrl

string

Un link all'album di Google Foto condiviso. Chiunque abbia il link può visualizzare i contenuti dell'album, pertanto è necessario prestare attenzione.

Il parametro shareableUrl viene restituito solo se per l'album è attivata la condivisione tramite link. Se un utente fa già parte di un album non condiviso tramite link, può utilizzare la 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 viene 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 è condiviso.
isJoined

boolean

True se l'utente fa parte dell'album. Questo vale sempre per il proprietario dell'album.
isOwned

boolean

True se l'album è di proprietà dell'utente.
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 uno o più elementi multimediali nella raccolta di Google Foto di un utente a un album.

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 valore 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.