Method: photos.batchGet
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Solicitação HTTP
GET https://streetviewpublish.googleapis.com/v1/photos:batchGet
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros |
photoIds[] |
string
Obrigatório. IDs do Photos. Para solicitações HTTP GET, o parâmetro de consulta do URL precisa ser photoIds=<id1>&photoIds=<id2>&....
|
view |
enum (PhotoView)
Obrigatório. Especifica se um URL de download para os bytes de foto deve ser retornado na resposta de Photo.
|
languageCode |
string
Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se languageCode não for especificado, será usada a preferência de idioma do usuário para os Serviços do Google.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta ao recebimento em lote de Photos.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Campos |
results[] |
object (PhotoResponse)
Lista de resultados para cada solicitação de Photo individual, na mesma ordem das solicitações em photos.batchGet.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/streetviewpublish
Para mais informações, consulte a Visão geral do OAuth 2.0.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
