REST Resource: sharedAlbums

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 una sessione e l'altra 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.

Metodi

get

Restituisce l'album in base al shareToken specificato.

join

Partecipa a un album condiviso per conto dell'utente di Google Foto.

leave

Abbandona un album condiviso a cui ha aderito in precedenza per conto dell'utente di Google Foto.

list

Elenca tutti gli album condivisi disponibili nella scheda Condivisione dell'app Google Foto dell'utente.