Method: photoSequences.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تمام PhotoSequences که به کاربر تعلق دارند را به ترتیب نزولی photoSequence.create فهرست می کند.
درخواست HTTP
GET https://streetviewpublish.googleapis.com/v1/photoSequences
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
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="نمونه یک عبارت.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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
