Method: sharedAlbums.list

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

HTTP-запрос

GET https://photoslibrary.googleapis.com/v1/sharedAlbums

URL-адрес использует синтаксис транскодирования gRPC .

Параметры запроса

Параметры
pageSize

integer

Максимальное количество альбомов, возвращаемых в ответе. Возможно, будет возвращено меньше альбомов, чем указано. pageSize по умолчанию — 20, максимальный — 50.

pageToken

string

Токен продолжения для получения следующей страницы результатов. Добавление этого к запросу возвращает строки после pageToken . pageToken должен быть значением, возвращаемым в параметре nextPageToken в ответе на запрос listSharedAlbums .

excludeNonAppCreatedData

boolean

Если этот параметр установлен, результаты исключают элементы мультимедиа, которые не были созданы этим приложением. По умолчанию — false (возвращаются все альбомы). Это поле игнорируется, если используется область данных photoslibrary.readonly.appcreateddata.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Запрошен список общих альбомов.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "sharedAlbums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Поля
sharedAlbums[]

object ( Album )

Только вывод. Список общих альбомов.

nextPageToken

string

Только вывод. Токен, который можно использовать для получения следующего набора общих альбомов. Заполняется, если по этому запросу можно получить еще несколько общих альбомов.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals