REST Resource: albums

Zasób: album

Ilustracja przedstawiająca 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órego można używać między sesjami, aby zidentyfikować ten album.
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 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] Prawda, jeśli w tym albumie można tworzyć elementy multimedialne. To pole zależy od przyznanych zakresów i uprawnień albumu. W przypadku zmiany zakresów lub uprawnień albumu to pole jest aktualizowane.
shareInfo

object (ShareInfo)

[Tylko dane wyjściowe] Informacje dotyczące albumów udostępnionych. To pole jest wypełniane tylko wtedy, gdy album jest albumem udostępnionym, deweloper utworzył go, 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ć tych parametrów w niezmienionej postaci. Parametry należy dołączyć do tego adresu URL przed użyciem. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład '=w2048-h1024' ustawia wymiary zdjęcia na okładkę na szerokość 2048 pikseli i wysokość 1024 pikseli.
coverPhotoMediaItemId

string

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

ShareInfo

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

string

Link do udostępnionego albumu ze Zdjęć Google. Każda osoba mająca link może wyświetlać zawartość albumu, dlatego należy zachować ostrożność.

Parametr shareableUrl jest zwracany tylko wtedy, gdy album ma włączone udostępnianie linków. Jeśli użytkownik dołączył już do albumu, który nie jest udostępniany przez link, może użyć productUrl tego albumu, aby uzyskać do niego dostęp.

Unieważnienie albumu shareableUrl zostanie unieważnione, jeśli właściciel wyłączy udostępnianie linków w aplikacji Zdjęcia Google lub album zostanie cofnięty.
shareToken

string

Token, który pozwala dołączyć do albumu udostępnionego, opuścić go lub pobrać szczegóły albumu udostępnionego w imieniu użytkownika, który nie jest właścicielem.

Unieważnienie albumu shareToken zostanie unieważnione, jeśli właściciel wyłączy udostępnianie linków w aplikacji Zdjęcia Google lub album zostanie cofnięty.
isJoined

boolean

Prawda, jeśli użytkownik został dołączony 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 użytkownicy mogą dołączać do albumu.

SharedAlbumOptions

Opcje umożliwiające kontrolowanie udostępniania albumu.

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

boolean

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

boolean

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

Metody

addEnrichment

 Dodaje wzbogacenie w określonym miejscu w zdefiniowanym albumie.

batchAddMediaItems

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

batchRemoveMediaItems

 Usuwa co najmniej jeden element multimedialny z określonego albumu.

create

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

get

 Zwraca album na podstawie określonej wartości albumId.

list

 Zawiera listę wszystkich albumów wyświetlanych użytkownikowi na karcie Albumy aplikacji Zdjęcia Google.

patch

 Zaktualizuj album, podając id.

share

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

unshare

 Oznacza wcześniej udostępniony album jako prywatny.