REST Resource: albums

Zasób: album

Przykładowy album w Zdjęciach Google Albumy to kontenery na elementy multimedialne. Jeśli aplikacja udostępniła album, 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świetlanego użytkownikowi na jego koncie Zdjęć Google. Ten ciąg nie może zawierać więcej niż 500 znaków.
productUrl

string

[Tylko wyjście] Adres URL albumu w Zdjęciach Google. Aby uzyskać dostęp do tego linku, użytkownik musi zalogować się na swoje konto Zdjęć Google.
isWriteable

boolean

[Tylko dane wyjściowe] Wartość true, jeśli w tym albumie można tworzyć elementy multimedialne. To pole jest określane na podstawie przyznanych uprawnień i uprawnień albumu. Jeśli zmienisz zakresy lub uprawnienia albumu, to pole zostanie zaktualizowane.
shareInfo

object (ShareInfo)

[Tylko dane wyjściowe] Informacje dotyczące albumów udostępnionych. To pole jest wypełnione tylko wtedy, gdy album jest albumem udostępnionym, został utworzony przez dewelopera i użytkownik przyznał mu uprawnienia 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 go używać w postaci, w której został podany. Przed użyciem do tego adresu URL należy dołączyć parametry. 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 okładki.

ShareInfo

informacje o udostępnionych albumach. Te informacje są uwzględniane tylko wtedy, gdy album został utworzony przez Ciebie, jest udostępniony i masz uprawnienia do 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 do udostępnionego albumu lub komentować go.
shareableUrl

string

link do udostępnionego albumu w Zdjęciach 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.

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

string

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

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

boolean

Prawda, jeśli użytkownik jest dołączony 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 album może być dołączany przez użytkowników.

SharedAlbumOptions

Opcje, które kontrolują udostępnianie 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 albumie utworzonym w aplikacji.

batchAddMediaItems

 Dodaje co najmniej 1 element multimedialny utworzony przez aplikację w bibliotece Zdjęć Google użytkownika do albumu utworzonego przez aplikację.

batchRemoveMediaItems

 Usuwa co najmniej 1 element multimedialny utworzony przez aplikację z określonego albumu utworzonego przez aplikację.

create

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

get

 Zwraca album utworzony przez aplikację na podstawie określonego albumId.

list

 Lista wszystkich albumów utworzonych przez Twoją aplikację.

patch

 Zaktualizuj album utworzony przez aplikację, podając określony id.