REST Resource: albums

Risorsa: album

Rappresentazione di un album in Google Foto. Gli album sono contenitori per elementi multimediali. Se un album è stato condiviso dall'applicazione, contiene un'ulteriore proprietà shareInfo.

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

Il nome dell'album visualizzato dall'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. L'utente deve aver eseguito l'accesso al proprio account Google Foto per accedere a questo link.
isWriteable

boolean

[Solo output] Vero se puoi creare elementi multimediali nell'album. Questo campo si basa sugli ambiti concessi e sulle autorizzazioni dell'album. Se gli ambiti o le autorizzazioni dell'album vengono modificati, 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, lo sviluppatore lo ha creato e 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 ai byte della foto di copertina. 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 2048 px di larghezza e 1024 px di altezza.
coverPhotoMediaItemId

string

Identificatore dell'elemento multimediale associato alla foto di copertina.

ShareInfo

Informazioni sugli album condivisi. Queste informazioni vengono incluse solo se hai creato l'album, è condiviso e hai l'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 stabilire se una persona può aggiungere elementi multimediali o commentare un album condiviso.
shareableUrl

string

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

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

Un shareableUrl viene invalidato se il proprietario disattiva la condivisione tramite link nell'app Google Foto o se la condivisione dell'album viene annullata.
shareToken

string

Token utilizzato per partecipare, uscire 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 la condivisione dell'album viene annullata.
isJoined

boolean

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

boolean

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

boolean

True se l'album può essere unito dagli utenti.

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 si sono uniti all'album) di aggiungere elementi multimediali all'album. 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 della raccolta Google Foto di un utente.

batchRemoveMediaItems

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

create

 Crea un album nella raccolta 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 valore id specificato.

share

 Contrassegna un album come condiviso e accessibile ad altri utenti.

unshare

 Contrassegna come privato un album precedentemente condiviso.