Method: photoSequences.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca tutti i PhotoSequences che appartengono all'utente, in ordine decrescente di photoSequence.create del timestamp.
Richiesta HTTP
GET https://streetviewpublish.googleapis.com/v1/photoSequences
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
pageSize |
integer
(Facoltativo) Il numero massimo di sequenze di foto da restituire. pageSize non deve essere un numero negativo. Se pageSize è zero o non viene fornito, viene utilizzata la dimensione pagina predefinita, pari a 100. Il numero di sequenze di foto restituite nella risposta può essere inferiore a pageSize se il numero di corrispondenze è inferiore a pageSize. Questa funzionalità non è attualmente implementata, ma è in corso.
|
pageToken |
string
(Facoltativo) Il valore nextPageToken restituito da una richiesta photoSequences.list precedente, se presente.
|
filter |
string
(Facoltativo) L'espressione di filtro. Ad esempio: imageryType=SPHERICAL. I filtri supportati sono: imageryType, processingState, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Per ulteriori informazioni, visita la pagina https://google.aip.dev/160. Le query dei nomi file devono essere inviate come frase per supportare più parole e caratteri speciali mediante l'aggiunta di virgolette di escape. Esempio: filename_query="esempio di una frase.mp4"
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta per elencare tutte le sequenze di foto appartenenti a un utente.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"photoSequences": [
{
object (Operation)
}
],
"nextPageToken": string
} |
| Campi |
photoSequences[] |
object (Operation)
Elenco di sequenze foto tramite l'interfaccia Operation. Il numero massimo di articoli restituiti si basa sul campo pageSize della richiesta. Ogni elemento dell'elenco può avere tre stati possibili:
Operation.done = false, se l'elaborazione di PhotoSequence non è ancora terminata.Operation.done = true e il valore Operation.error è compilato, in caso di errore durante l'elaborazione.Operation.done = true e Operation.response contiene un messaggio PhotoSequence. In ogni sequenza viene compilato solo Id.
|
nextPageToken |
string
Token per recuperare la pagina successiva dei risultati o vuoto se non ci sono altri risultati nell'elenco.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/streetviewpublish
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eLists all PhotoSequences belonging to a user, ordered by creation timestamp in descending order.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by various criteria such as imagery type, processing state, location, filename, and capture time.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated and can be retrieved in batches using page tokens.\u003c/p\u003e\n"],["\u003cp\u003eEach PhotoSequence can be in one of three states: processing, processed with error, or processed successfully.\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 describes how to list a user's photo sequences. Use a `GET` request to `https://streetviewpublish.googleapis.com/v1/photoSequences`. Optional query parameters include `pageSize` (default 100), `pageToken` for pagination, and `filter` to refine results. The request body is empty. The response body contains a list of `photoSequences`, each with processing status, and a `nextPageToken` for pagination. The request requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope.\n"],null,["# Method: photoSequences.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.ListPhotoSequencesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all the [PhotoSequences](/streetview/publish/reference/rest/v1/photoSequence/create#PhotoSequence) that belong to the user, in descending photoSequence.create timestamp order.\n\n### HTTP request\n\n`GET https://streetviewpublish.googleapis.com/v1/photoSequences`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of photo sequences 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 photo sequences returned in the response may be less than `pageSize` if the number of matches is less than `pageSize`. This is currently unimplemented but is in process. |\n| `pageToken` | `string` Optional. The [nextPageToken](/streetview/publish/reference/rest/v1/photos/list#body.ListPhotosResponse.FIELDS.next_page_token) value returned from a previous [photoSequences.list](/streetview/publish/reference/rest/v1/photoSequences/list#google.streetview.publish.v1.StreetViewPublishService.ListPhotoSequences) request, if any. |\n| `filter` | `string` Optional. The filter expression. For example: `imageryType=SPHERICAL`. The filters supported are: `imageryType`, `processingState`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, `filename_query`, `min_capture_time_seconds`, \\`max_capture_time_seconds. See \u003chttps://google.aip.dev/160\u003e for more information. Filename queries should sent as a Phrase in order to support multiple words and special characters by adding escaped quotes. Ex: filename_query=\"example of a phrase.mp4\" |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to list all photo sequences that belong to a user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"photoSequences\": [ { object (/streetview/publish/reference/rest/v1/Operation) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `photoSequences[]` | `object (`[Operation](/streetview/publish/reference/rest/v1/Operation)`)` List of photo sequences via [Operation](/streetview/publish/reference/rest/v1/Operation) interface. The maximum number of items returned is based on the [pageSize](/streetview/publish/reference/rest/v1/photoSequences/list#body.QUERY_PARAMETERS.page_size) field in the request. Each item in the list can have three possible states, - `Operation.done` = false, if the processing of [PhotoSequence](/streetview/publish/reference/rest/v1/photoSequence/create#PhotoSequence) is not finished yet. - `Operation.done` = true and `Operation.error` is populated, if there was an error in processing. - `Operation.done` = true and `Operation.response` contains a [PhotoSequence](/streetview/publish/reference/rest/v1/photoSequence/create#PhotoSequence) message, In each sequence, only [Id](/streetview/publish/reference/rest/v1/photoSequence/create#PhotoSequence.FIELDS.id) is populated. |\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)."]]
