Method: photos.batchGet

Lấy siêu dữ liệu của lô Photo đã chỉ định.

Xin lưu ý rằng nếu photos.batchGet không thành công thì có nghĩa là sẽ thiếu các trường quan trọng hoặc đã xảy ra lỗi xác thực. Ngay cả khi photos.batchGet thành công, các ảnh riêng lẻ trong lô vẫn có thể gặp lỗi. Những lỗi này được chỉ định trong từng PhotoResponse.status trong BatchGetPhotosResponse.results. Hãy xem photo.get để biết các lỗi cụ thể có thể xảy ra với mỗi ảnh.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Tham số
photoIds[]

string

Bắt buộc. Mã của Photos. Đối với các yêu cầu HTTP GET, tham số truy vấn URL phải là photoIds=<id1>&photoIds=<id2>&....
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 ảnh hay không.
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 yêu cầu nhận hàng loạt Photos.

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 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Trường
results[]

object (PhotoResponse)

Danh sách kết quả cho từng Photo được yêu cầu, theo cùng thứ tự như các yêu cầu trong photos.batchGet.

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.