Method: photoSequences.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בתיבת הדו-שיח הזו מפורטים כל פריטי PhotoSequences ששייכים למשתמש, בסדר יורד של PhotoSequence.create.
בקשת HTTP
GET https://streetviewpublish.googleapis.com/v1/photoSequences
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של שאילתה
| פרמטרים |
pageSize |
integer
זה שינוי אופציונלי. המספר המקסימלי של רצפי תמונות שצריך להחזיר. pageSize חייב להיות לא שלילי. אם הערך של pageSize הוא אפס או לא צוין, המערכת תשתמש בגודל הדף שמוגדר כברירת מחדל (100). אם מספר ההתאמות קטן מ-pageSize, מספר רצפי התמונות שהוחזרו בתשובה עשוי להיות קטן מ-pageSize. האפשרות הזו לא מוטמעת כרגע אבל היא בתהליך.
|
pageToken |
string
זה שינוי אופציונלי. הערך של nextPageToken שהוחזר מבקשת photoSequences.list קודמת, אם הייתה כזו.
|
filter |
string
זה שינוי אופציונלי. ביטוי הסינון. לדוגמה: imageryType=SPHERICAL. המסננים הנתמכים הם: imageryType, processingState, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, 'max_capture_time_seconds'. מידע נוסף זמין בכתובת https://google.aip.dev/160. כדי לתמוך בכמה מילים ותווים מיוחדים באמצעות הוספת מירכאות, יש לשלוח שאילתות של שמות קבצים כביטוי. לדוגמה: filename_query="example of aexpression.mp4"
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה להצגת כל רצפי התמונות ששייכים למשתמש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
{
"photoSequences": [
{
object (Operation)
}
],
"nextPageToken": string
} |
| שדות |
photoSequences[] |
object (Operation)
רשימה של רצפי תמונות דרך הממשק של Operation. המספר המקסימלי של פריטים שהוחזרו מבוסס על השדה pageSize בבקשה. לכל פריט ברשימה יכולים להיות שלושה מצבים אפשריים:
Operation.done = false, אם העיבוד של PhotoSequence עדיין לא הסתיים.- אם הייתה שגיאה בעיבוד, הערך
Operation.done = true ו-Operation.error מאוכלס.
Operation.done = true ו-Operation.response מכיל הודעת PhotoSequence, בכל רצף, רק Id מאוכלס.
|
nextPageToken |
string
אסימון לאחזור דף התוצאות הבא, או ריק אם אין עוד תוצאות ברשימה.
|
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/streetviewpublish
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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)."]]
