Method: photos.list
Liệt kê tất cả Photos
thuộc về người dùng này.
Lưu ý: Hệ thống sẽ không trả về những bức ảnh mới tạo gần đây mà vẫn đang được lập chỉ mục trong câu trả lời.
Yêu cầu HTTP
GET https://streetviewpublish.googleapis.com/v1/photos
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Tham số |
view |
enum (PhotoView )
Bắt buộc. Chỉ định xem có cần trả về URL tải xuống cho các byte ảnh trong phản hồi Photos hay không.
|
pageSize |
integer
Không bắt buộc. Số lượng ảnh tối đa cần trả lại. pageSize không được là số âm. Nếu pageSize bằng 0 hoặc không được cung cấp thì kích thước trang mặc định là 100 sẽ được sử dụng. Số lượng ảnh được trả lại trong phản hồi có thể ít hơn pageSize nếu số lượng ảnh thuộc về người dùng ít hơn pageSize .
|
pageToken |
string
Không bắt buộc. Giá trị nextPageToken được trả về từ yêu cầu photos.list trước đó, nếu có.
|
filter |
string
Không bắt buộc. Biểu thức bộ lọc. Ví dụ: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw . Các bộ lọc được hỗ trợ: placeId , min_latitude , max_latitude , min_longitude , max_longitude . Hãy tham khảo https://google.aip.dev/160 để biết thêm thông tin.
|
languageCode |
string
Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu languageCode không được chỉ định, thì hệ thống sẽ sử dụng lựa chọn ưu tiên về ngôn ngữ của người dùng đối với các dịch vụ của Google.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi để liệt kê tất cả ảnh của một người dùng.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"photos": [
{
object (Photo )
}
],
"nextPageToken": string
} |
Trường |
photos[] |
object (Photo )
Danh sách ảnh. Trường pageSize trong yêu cầu sẽ xác định số lượng mặt hàng được trả về.
|
nextPageToken |
string
Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không còn kết quả nào trong danh sách.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/streetviewpublish
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-09-10 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-09-10 UTC."],[[["Lists all photos belonging to a user, although recently created, unindexed photos may not be included."],["Allows filtering by place ID, latitude, and longitude, and lets you specify the view and page size."],["Responses include a list of photos and a token for retrieving subsequent pages if available."],["Requires authorization with the `https://www.googleapis.com/auth/streetviewpublish` scope."]]],["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"]]