Method: photos.list

사용자에게 속한 모든 Photos를 나열합니다.

참고: 최근에 생성되었으며 아직 색인이 생성된 사진은 응답에 반환되지 않습니다.

HTTP 요청

GET https://streetviewpublish.googleapis.com/v1/photos

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

쿼리 매개변수

매개변수
view

enum (PhotoView)

필수 항목입니다. 사진 바이트의 다운로드 URL을 포토 응답에서 반환해야 하는지 여부를 지정합니다.

pageSize

integer

선택사항입니다. 반환할 최대 사진 수입니다. pageSize 값은 음수가 아니어야 합니다. pageSize가 0이거나 제공되지 않은 경우 기본 페이지 크기인 100이 사용됩니다. 사용자에게 속한 사진 수가 pageSize개 미만이면 응답에서 반환되는 사진 수가 pageSize보다 적을 수 있습니다.

pageToken

string

선택사항입니다. 이전 photos.list 요청에서 반환된 nextPageToken 값입니다(있는 경우).

filter

string

선택사항입니다. 필터 표현식입니다. 예: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

지원되는 필터는 placeId, min_latitude, max_latitude, min_longitude, max_longitude입니다. 자세한 내용은 https://google.aip.dev/160을 참고하세요.

languageCode

string

선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. languageCode를 지정하지 않으면 Google 서비스에서 사용자의 언어 환경설정이 사용됩니다.

요청 본문

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

응답 본문

사용자에게 속한 모든 사진을 나열하는 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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

object (Photo)

사진 목록입니다. 요청의 pageSize 필드는 반환되는 항목의 수를 결정합니다.

nextPageToken

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

승인 범위

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

  • https://www.googleapis.com/auth/streetviewpublish

자세한 내용은 OAuth 2.0 개요를 참고하세요.