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

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 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, 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 hai creato l'album, se è 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 aggiungere commenti.
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 la condivisione tramite link è attivata per l'album. 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 viene condiviso.
shareToken

string

Un token utilizzato per partecipare a un album condiviso, uscirne o recuperarne i dettagli 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 hanno aggiunto foto all'album) di aggiungere commenti. Il valore predefinito è false.

Metodi

addEnrichment

 Aggiunge un arricchimento in una posizione specifica in un album creato con un'app.

batchAddMediaItems

 Aggiunge uno o più elementi multimediali creati dall'app nella raccolta di Google Foto di un utente a un album creato dall'app.

batchRemoveMediaItems

 Rimuove uno o più elementi multimediali creati dall'app da un album creato dall'app specificato.

create

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

get

 Restituisce l'album creato dall'app in base al albumId specificato.

list

 Elenca tutti gli album creati dalla tua app.

patch

 Aggiorna l'album creato dall'app con il id specificato.