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="مثال على عبارة.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 (حسب التوقيت العالمي المتفَّق عليه)
[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)."]]
