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 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 è condiviso, se 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 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 in modo che abbiano 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 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 è 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 è 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 si sono uniti 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

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

Aggiorna l'album con il valore id specificato.

share

unshare