REST Resource: sharedAlbums

Ресурс: Альбом

Представление альбома в Google Photos. Альбомы — это контейнеры для мультимедийных элементов. Если приложение предоставило общий доступ к альбому, он содержит дополнительное свойство shareInfo .

JSON-представление
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Поля
id

string

Идентификатор альбома. Это постоянный идентификатор, который можно использовать между сеансами для идентификации этого альбома.

title

string

Название альбома, отображаемое пользователю в его аккаунте Google Фото. Эта строка не должна содержать более 500 символов.

productUrl

string

[Только вывод] URL-адрес альбома в Google Фото. Чтобы получить доступ к этой ссылке, пользователю необходимо войти в свою учетную запись Google Photos.

isWriteable

boolean

[Только вывод] True, если вы можете создавать мультимедийные элементы в этом альбоме. Это поле зависит от предоставленных областей и разрешений альбома. Если изменяются области действия или права доступа к альбому, это поле обновляется.

shareInfo

object ( ShareInfo )

[Только вывод] Информация, касающаяся общих альбомов. Это поле заполняется только в том случае, если альбом является общим альбомом, разработчик создал альбом и пользователь предоставил область photoslibrary.sharing .

mediaItemsCount

string ( int64 format)

[Только вывод] Количество мультимедийных элементов в альбоме.

coverPhotoBaseUrl

string

[Только вывод] URL-адрес байтов обложки. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см. в документации разработчика . Например, '=w2048-h1024' устанавливает размеры фотографии обложки: ширина 2048 пикселей и высота 1024 пикселей.

coverPhotoMediaItemId

string

Идентификатор медиа-элемента, связанного с фотографией обложки.

Методы

get

Возвращает альбом на основе указанного shareToken .

join

Присоединяется к общему альбому от имени пользователя Google Фото.

leave

Выход из общего альбома, к которому ранее присоединился, от имени пользователя Google Фото.

list

Перечисляет все общие альбомы, доступные на вкладке «Общий доступ» в приложении Google Фото пользователя.