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 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eLists all photos belonging to a user, although recently created, unindexed photos may not be included.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by place ID, latitude, and longitude, and lets you specify the view and page size.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a list of photos and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/streetviewpublish\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to retrieve a user's photos using the Street View Publish API. A `GET` request to `https://streetviewpublish.googleapis.com/v1/photos` is used. Key parameters include `view`, `pageSize`, `pageToken`, `filter`, and `languageCode`. The request body is empty. A successful response returns a JSON object containing a list of `photos`, and a `nextPageToken` for pagination. Access requires the `https://www.googleapis.com/auth/streetviewpublish` authorization scope.\n"],null,["# Method: photos.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPhotosResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all the [Photos](/streetview/publish/reference/rest/v1/photo#Photo) that belong to the user.\n\u003e Note: Recently created photos that are still being indexed are not returned in the response.\n\n### HTTP request\n\n`GET https://streetviewpublish.googleapis.com/v1/photos`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `view` | `enum (`[PhotoView](/streetview/publish/reference/rest/v1/PhotoView)`)` Required. Specifies if a download URL for the photos bytes should be returned in the Photos response. |\n| `pageSize` | `integer` Optional. The maximum number of photos to return. `pageSize` must be non-negative. If `pageSize` is zero or is not provided, the default page size of 100 is used. The number of photos returned in the response may be less than `pageSize` if the number of photos that belong to the user is less than `pageSize`. |\n| `pageToken` | `string` Optional. The [nextPageToken](/streetview/publish/reference/rest/v1/photos/list#body.ListPhotosResponse.FIELDS.next_page_token) value returned from a previous [photos.list](/streetview/publish/reference/rest/v1/photos/list#google.streetview.publish.v1.StreetViewPublishService.ListPhotos) request, if any. |\n| `filter` | `string` Optional. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`. See \u003chttps://google.aip.dev/160\u003e for more information. |\n| `languageCode` | `string` Optional. The BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see \u003chttp://www.unicode.org/reports/tr35/#Unicode_locale_identifier\u003e. If languageCode is unspecified, the user's language preference for Google services is used. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to list all photos that belong to a user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------|\n| ``` { \"photos\": [ { object (/streetview/publish/reference/rest/v1/photo#Photo) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `photos[]` | `object (`[Photo](/streetview/publish/reference/rest/v1/photo#Photo)`)` List of photos. The [pageSize](/streetview/publish/reference/rest/v1/photos/list#body.QUERY_PARAMETERS.page_size) field in the request determines the number of items returned. |\n| `nextPageToken` | `string` Token to retrieve the next page of results, or empty if there are no more results in the list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/streetviewpublish`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
