Method: photos.batchGet
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ HTTP
GET https://streetviewpublish.googleapis.com/v1/photos:batchGet
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
photoIds[] |
string
ต้องระบุ รหัสของ Photos สำหรับคำขอ HTTP GET พารามิเตอร์การค้นหาของ URL ควรเป็น photoIds=<id1>&photoIds=<id2>&...
|
view |
enum (PhotoView)
ต้องระบุ ระบุว่าควรแสดงผล URL การดาวน์โหลดสำหรับไบต์รูปภาพในการตอบกลับรูปภาพหรือไม่
|
languageCode |
string
ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ได้ระบุ languageCode จะมีการใช้ค่ากำหนดภาษาของผู้ใช้สำหรับบริการของ Google
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบสนองต่อการรับ Photos แบบกลุ่ม
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| ช่อง |
results[] |
object (PhotoResponse)
รายการผลลัพธ์สำหรับ Photo แต่ละรายการที่ขอ ในลำดับเดียวกับคำขอใน photos.batchGet
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/streetviewpublish
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eRetrieves metadata for multiple photos using their IDs via a \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing photo IDs and view preference via query parameters, and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of results, each corresponding to a requested photo, and indicating success or failure.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using the \u003ccode\u003ehttps://www.googleapis.com/auth/streetviewpublish\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eIf the batch request fails, it may be due to missing fields or authentication errors, while individual photos may have separate failures detailed within the response.\u003c/p\u003e\n"]]],["This document details the process for retrieving metadata of multiple Street View photos via the `photos.batchGet` method. A `GET` request to `https://streetviewpublish.googleapis.com/v1/photos:batchGet` is required. The request must include `photoIds` and a `view` parameter in the query, and optionally a `languageCode`. The request body should be empty. The response body returns a list of `PhotoResponse` objects containing the requested photo metadata. The request requires `https://www.googleapis.com/auth/streetviewpublish` OAuth scope.\n"],null,["# Method: photos.batchGet\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.BatchGetPhotosResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets the metadata of the specified [Photo](/streetview/publish/reference/rest/v1/photo#Photo) batch.\n\nNote that if [photos.batchGet](/streetview/publish/reference/rest/v1/photos/batchGet#google.streetview.publish.v1.StreetViewPublishService.BatchGetPhotos) fails, either critical fields are missing or there is an authentication error. Even if [photos.batchGet](/streetview/publish/reference/rest/v1/photos/batchGet#google.streetview.publish.v1.StreetViewPublishService.BatchGetPhotos) succeeds, individual photos in the batch may have failures. These failures are specified in each [PhotoResponse.status](/streetview/publish/reference/rest/v1/PhotoResponse#FIELDS.status) in [BatchGetPhotosResponse.results](/streetview/publish/reference/rest/v1/photos/batchGet#body.BatchGetPhotosResponse.FIELDS.results). See [photo.get](/streetview/publish/reference/rest/v1/photo/get#google.streetview.publish.v1.StreetViewPublishService.GetPhoto) for specific failures that can occur per photo.\n\n### HTTP request\n\n`GET https://streetviewpublish.googleapis.com/v1/photos:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `photoIds[]` | `string` Required. IDs of the [Photos](/streetview/publish/reference/rest/v1/photo#Photo). For HTTP GET requests, the URL query parameter should be `photoIds=\u003cid1\u003e&photoIds=\u003cid2\u003e&...`. |\n| `view` | `enum (`[PhotoView](/streetview/publish/reference/rest/v1/PhotoView)`)` Required. Specifies if a download URL for the photo bytes should be returned in the Photo response. |\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 batch get of [Photos](/streetview/publish/reference/rest/v1/photo#Photo).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------|\n| ``` { \"results\": [ { object (/streetview/publish/reference/rest/v1/PhotoResponse) } ] } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `results[]` | `object (`[PhotoResponse](/streetview/publish/reference/rest/v1/PhotoResponse)`)` List of results for each individual [Photo](/streetview/publish/reference/rest/v1/photo#Photo) requested, in the same order as the requests in [photos.batchGet](/streetview/publish/reference/rest/v1/photos/batchGet#google.streetview.publish.v1.StreetViewPublishService.BatchGetPhotos). |\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)."]]
