Method: mediaItems.list

지정된 기기의 사용자 구성 미디어 소스에서 화면 보호 모드 미디어 항목 목록을 반환합니다.

기본적으로 listMediaItems는 화면 보호 모드 환경을 제공하여 모든 사용자 구성 소스에서 선별된 미디어 항목 집합을 반환합니다.

원하는 경우 요청에 mediaSourceId를 포함하여 특정 미디어 소스에서 페이지로 나뉜 항목 목록을 검색하여 보다 기존 방식의 필터링을 허용할 수 있습니다.

클라이언트 애플리케이션은 기기당 일일 240회 요청으로 제한됩니다.

사용자가 미디어 소스를 구성하지 않은 경우 FAILED_PRECONDITION 오류가 발생합니다.

HTTP 요청

GET https://photosambient.googleapis.com/v1/mediaItems

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

Parameters
deviceId

string

필수 항목입니다. 이 기기의 고유 식별자입니다.
mediaSourceId

string

선택사항입니다. 화면 보호 모드 환경의 경우 이 필드를 생략합니다. 이렇게 하면 구성된 모든 소스에서 선별된 미디어 항목 세트가 반환됩니다. 반환되는 항목 수는 pageSize 요청을 따르며 최대 100개까지 반환할 수 있습니다. 지정된 경우 지정된 미디어 소스의 항목만 반환됩니다.

id는 사용자가 지정된 기기에 대해 선택한 소스여야 합니다 (즉, AmbientDevice.media_sources.id 중 하나).

highlights는 사용자가 이 기기의 소스로 선택한 경우에도 지원되지 않습니다. 이 필드를 highlights로 설정하면 INVALID_ARGUMENT 오류가 반환됩니다.
pageSize

integer

선택사항입니다. 반환할 최대 미디어 항목 수입니다.

서비스는 pageSize 요청을 따르지만 지정된 것보다 적은 항목을 반환할 수 있습니다 (결과가 0인 경우 포함).

pageSize가 지정되지 않거나 0으로 설정된 경우 최대 50개의 미디어 항목이 반환됩니다. 100을 초과하는 값은 허용되는 최대값인 100으로 강제 변환됩니다. 음수 값을 제공하면 INVALID_ARGUMENT 오류가 발생합니다.
pageToken

string

선택사항입니다. 이전 mediaItems.list 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

mediaItems.list 메서드에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "mediaItems": [
    {
      object (AmbientMediaItem)
    }
  ],
  "nextPageToken": string
}
필드
mediaItems[]

object (AmbientMediaItem)

기기에 표시할 화면 보호 모드 미디어 항목의 페이지입니다.
nextPageToken

string

이 필드를 설정하면 후속 mediaItems.list 호출에서 항목의 다음 페이지를 검색할 때 pageToken로 사용할 수 있습니다.

이 필드가 생략된 것은 가져올 수 있는 콘텐츠가 더 이상 없다는 것을 나타내는 것은 아닙니다. 후속 콘텐츠 페이지에 이전 페이지에서 이미 반환된 미디어 항목이 포함될 수 있다는 의미입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/photosambient.mediaitems