Method: albums.list

Список всех альбомов, отображаемых пользователю на вкладке «Альбомы» приложения Google Фото.

HTTP-запрос

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

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

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

Параметры
pageSize

integer

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

pageToken

string

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

excludeNonAppCreatedData

boolean

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

Тело запроса

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

Тело ответа

Список запрошенных альбомов.

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

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

object ( Album )

Только вывод. Список альбомов отображается на вкладке «Альбомы» в приложении Google Фото пользователя.

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