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świetlanego 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 albumu w Zdjęciach Google. 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] 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 funkcja '=w2048-h1024' ustawia wymiary zdjęcia na okładkę na 2048 pikseli i wysokość 1024 piksele.
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żdy, kto ma link, może wyświetlić zawartość albumu, dlatego należy zachować ostrożność.

Parametr shareableUrl jest zwracany tylko wtedy, gdy udostępnianie linków jest włączone. 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 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 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 współpracownikom (użytkownicy, którzy dołączyli do albumu) mogą dodawać do niego komentarze. Wartość domyślna to fałsz.

Metody

addEnrichment

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

 Zaktualizuj album, dodając określony id.

share

unshare