REST Resource: albums

Zasób: Album

Przykładowy album w Zdjęciach Google Albumy to kontenery na elementy multimedialne. Jeśli album został udostępniony przez aplikację, zawiera on dodatkową właściwość shareInfo.

Zapis JSON 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Pola
id

string

Identyfikator albumu. Jest to trwały identyfikator, który może być używany w różnych sesjach do identyfikacji tego albumu.
title

string

Nazwa albumu wyświetlana użytkownikowi na jego koncie Zdjęć Google. Ten ciąg nie może mieć więcej niż 500 znaków.
productUrl

string

[Tylko dane wyjściowe] Adres URL Zdjęć Google dla albumu. Aby uzyskać dostęp do tego linku, użytkownik musi być zalogowany na swoje konto Zdjęć Google.
isWriteable

boolean

[Tylko dane wyjściowe] Prawda, jeśli można tworzyć elementy multimedialne w tym albumie. To pole zależy od przyznanych zakresów i uprawnień do albumu. Jeśli zmienisz zakresy lub uprawnienia albumu, to pole zostanie zaktualizowane.
shareInfo

object (ShareInfo)

[Tylko dane wyjściowe] Informacje związane z albumami udostępnionymi. To pole jest wypełniane tylko wtedy, gdy album jest albumem udostępnionym, utworzył go deweloper, a użytkownik przyznał zakres photoslibrary.sharing.
mediaItemsCount

string (int64 format)

[Tylko dane wyjściowe] Liczba elementów multimedialnych w albumie.
coverPhotoBaseUrl

string

[Tylko dane wyjściowe] URL do bajtów zdjęcia na okładkę. Nie należy używać tej właściwości w niezmienionej formie. Przed użyciem parametrów musisz je dołączyć do tego adresu URL. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład '=w2048-h1024' ustawia wymiary zdjęcia na okładce na 2048 pikseli szerokości i 1024 piksele wysokości.
coverPhotoMediaItemId

string

Identyfikator elementu multimedialnego powiązanego ze zdjęciem na okładkę.

ShareInfo

informacje o udostępnionych albumach; Te informacje są dostępne tylko wtedy, gdy album został utworzony przez Ciebie, jest udostępniany i masz zakres udostępniania.

Zapis JSON 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Pola
sharedAlbumOptions

object (SharedAlbumOptions)

Opcje określające, czy ktoś może dodawać elementy multimedialne i komentować album udostępniony.
shareableUrl

string

link do udostępnionego albumu w Zdjęciach Google. Każda osoba mająca link może wyświetlić zawartość albumu, dlatego należy ją traktować z rozwagą.

Parametr shareableUrl jest zwracany tylko wtedy, gdy album ma włączone udostępnianie linków. Jeśli użytkownik jest już dołączony do albumu, który nie jest udostępniany za pomocą linku, może zamiast tego użyć productUrl.

Element shareableUrl zostanie unieważniony, jeśli właściciel wyłączył udostępnianie linków w aplikacji Zdjęcia Google lub jeśli cofnięto udostępnianie albumu.
shareToken

string

Token używany do dołączania do albumu udostępnionego, opuszczania go lub pobierania jego szczegółów w imieniu użytkownika, który nie jest właścicielem.

Element shareToken zostanie unieważniony, jeśli właściciel wyłączył udostępnianie linków w aplikacji Zdjęcia Google lub jeśli cofnięto udostępnianie albumu.
isJoined

boolean

Prawda, jeśli użytkownik dołączył do albumu. Dotyczy to zawsze właściciela albumu.
isOwned

boolean

Prawda, jeśli album należy do użytkownika.
isJoinable

boolean

Prawda, jeśli do albumu mogą dołączyć użytkownicy.

SharedAlbumOptions

Opcje sterujące udostępnianiem albumu.

Zapis JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Pola
isCollaborative

boolean

Prawda, jeśli udostępniony album zezwala współpracownikom (użytkownikom, którzy dołączyli do albumu) na dodawanie do niego multimediów. Wartość domyślna to fałsz.
isCommentable

boolean

Prawda, jeśli udostępniony album zezwala współpracownikom (użytkownikom, którzy dołączyli do albumu) na dodawanie komentarzy. Wartość domyślna to fałsz.

Metody

addEnrichment

 Dodaje wzbogacenie w określonym miejscu w zdefiniowanym albumie.

batchAddMediaItems

 Dodaje co najmniej 1 element multimedialny z biblioteki Zdjęć Google użytkownika do albumu.

batchRemoveMediaItems

 Usuwa co najmniej 1 element multimedialny z wybranego albumu.

create

 Tworzy album w bibliotece Zdjęć Google użytkownika.

get

 Zwraca album na podstawie określonego albumId.

list

 Wyświetla listę wszystkich albumów widocznych użytkownikowi na karcie Albumy w aplikacji Zdjęcia Google.

patch

 Zaktualizuj album za pomocą określonego atrybutu id.

share

 Oznacza album jako udostępniony i dostępny dla innych użytkowników.

unshare

 oznacza wcześniej udostępniony album jako prywatny.