REST Resource: albums

Zasób: album

Reprezentacja albumu 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. To jest trwały identyfikator, który może być używany między sesjami do identyfikowania 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. To pole jest aktualizowane w przypadku zmiany zakresów lub uprawnień w albumie.
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] Adres URL 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 albumach, które zostały udostępnione. 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 Zdjęć 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.

shareableUrl traci ważność, jeśli właściciel wyłączy udostępnianie linku w aplikacji Zdjęcia Google lub jeśli album zostanie odebrany.
shareToken

string

Token, który pozwala dołączyć do albumu udostępnionego, opuścić go lub pobrać 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 użytkownik jest właścicielem albumu.
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 współpracownikom (użytkownicy, którzy dołączyli do albumu) mogą dodawać do niego elementy multimedialne. Wartość domyślna to fałsz.
isCommentable

boolean

Prawda, jeśli współpracownikom (użytkownicy, którzy dołączyli do albumu) mogą dodawać do niego komentarze. Wartość domyślna to fałsz.

Metody

addEnrichment

 Dodaje wzbogacanie na określonej pozycji w zdefiniowanym albumie.

batchAddMediaItems

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

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 parametru albumId.

list

 Lista wszystkich albumów wyświetlanych 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.