Method: projects.video.export
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מפעילה תהליך באצווה שמחשב וידאו וכותב את התוצאה לאחד מכמה יעדים.
בקשת HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/video:export
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
project |
string
מזהה הפרויקט או מספר הפרויקט ב-Google Cloud Platform שצריך להתייחס אליו כצרכן השירות של הבקשה הזו. הפורמט הוא projects/{project-id}.
כדי לקבל הרשאה, נדרשת ההרשאה הבאה ב-IAM למשאב שצוין project:
earthengine.exports.create
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"expression": {
object (Expression)
},
"description": string,
"videoOptions": {
object (VideoOptions)
},
"fileExportOptions": {
object (VideoFileExportOptions)
},
"requestId": string,
"workloadTag": string,
"priority": integer
} |
| שדות |
expression |
object (Expression)
ביטוי שמתקבל ממנו הסרטון לחישוב ולייצוא, שמוצג כאוסף תמונות.
|
description |
string
שם המשימה שקריא לבני אדם.
|
videoOptions |
object (VideoOptions)
אפשרויות בסיסיות שמתארות את הסרטון שייווצר.
|
fileExportOptions |
object (VideoFileExportOptions)
אפשרויות לאן לייצא את הסרטון ובאיזה פורמט.
|
requestId |
string
מחרוזת ייחודית המשמשת לזיהוי בקשות כפולות. אם אותו משתמש שולח יותר מבקשה אחת עם אותו requestId לא ריק, רק אחת מהבקשות האלה עשויה להתחיל פעולה ממושכת. השדה requestId יכול להכיל את התווים a..z, A..Z, 0-9 או '-'. האורך המקסימלי של השדה requestId הוא 60 תווים.
|
workloadTag |
string
תווית שהמשתמש סיפק כדי לעקוב אחרי החישוב הזה.
|
priority |
integer
זה שינוי אופציונלי. העדיפות של משימה הייצוא בפרויקט. משימות בעדיפות גבוהה יותר מתוזמנות מוקדם יותר. חייב להיות מספר שלם בין 0 ל-9999. אם לא מגדירים ערך, ערך ברירת המחדל הוא 100.
|
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/devstorage.full_control
מידע נוסף זמין בOAuth 2.0 Overview.
VideoFileExportOptions
אפשרויות לייצוא סרטונים כקבצים מחוץ ל-Earth Engine.
| ייצוג ב-JSON |
{
"fileFormat": enum (VideoFileFormat),
// Union field destination can be only one of the following:
"driveDestination": {
object (DriveDestination)
},
"cloudStorageDestination": {
object (CloudStorageDestination)
}
// End of list of possible types for union field destination.
} |
| שדות |
fileFormat |
enum (VideoFileFormat)
פורמט הקובץ שבו לייצא את הסרטונים. בשלב הזה יש תמיכה רק בפורמט MP4.
|
שדה האיחוד destination. איפה לכתוב את התוצאות. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות: |
driveDestination |
object (DriveDestination)
אם מצוין, מגדיר ייצוא ל-Google Drive.
|
cloudStorageDestination |
object (CloudStorageDestination)
אם מצוין, מגדיר ייצוא ל-Google Cloud Storage.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eInitiates a batch process to compute and export a video from an image collection in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eProvides options to customize video generation, including format, destination (Google Drive or Cloud Storage), and priority.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Earth Engine, Cloud Platform, or full DevStorage control.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003ePOST\u003c/code\u003e request to the Earth Engine API with project ID, video details, and export options in the request body.\u003c/p\u003e\n"],["\u003cp\u003eReturns an Operation object upon successful request initiation, allowing for monitoring of the export process.\u003c/p\u003e\n"]]],[],null,["# Method: projects.video.export\n\nInitiates a batch process that computes a video and writes the result to one of several destinations.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/video:export`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.exports.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1beta/Expression) }, \"description\": string, \"videoOptions\": { object (/earth-engine/reference/rest/v1beta/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions) }, \"fileExportOptions\": { object (/earth-engine/reference/rest/v1beta/projects.video/export#VideoFileExportOptions) }, \"requestId\": string, \"workloadTag\": string, \"priority\": integer } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/Expression)`)` An expression that evaluates to the video to compute and export, represented as an image collection. |\n| `description` | `string` A human-readable name of the task. |\n| `videoOptions` | `object (`[VideoOptions](/earth-engine/reference/rest/v1beta/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions)`)` Basic options describing the video to generate. |\n| `fileExportOptions` | `object (`[VideoFileExportOptions](/earth-engine/reference/rest/v1beta/projects.video/export#VideoFileExportOptions)`)` Options for where and in what form to export the video. |\n| `requestId` | `string` A unique string used to detect duplicated requests. If more than one request is made by the same user with the same non-empty `requestId`, only one of those requests may successfully start a long-running operation. `requestId` may contain the characters a..z, A..Z, 0-9, or '-'. `requestId` may be at most 60 characters long. |\n| `workloadTag` | `string` User supplied label to track this computation. |\n| `priority` | `integer` Optional. The priority of the export task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100 if not set. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/earth-engine/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/devstorage.full_control`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nVideoFileExportOptions\n----------------------\n\nOptions for exporting videos as files outside Earth Engine.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileFormat\": enum (/earth-engine/reference/rest/v1beta/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat), // Union field `destination` can be only one of the following: \"driveDestination\": { object (/earth-engine/reference/rest/v1beta/DriveDestination) }, \"cloudStorageDestination\": { object (/earth-engine/reference/rest/v1beta/CloudStorageDestination) } // End of list of possible types for union field `destination`. } ``` |\n\n| Fields ||\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileFormat` | `enum (`[VideoFileFormat](/earth-engine/reference/rest/v1beta/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat)`)` The file format in which to export the video(s). Currently only MP4 is supported. |\n| Union field `destination`. Where to write the results. `destination` can be only one of the following: ||\n| `driveDestination` | `object (`[DriveDestination](/earth-engine/reference/rest/v1beta/DriveDestination)`)` If specified, configures export to Google Drive. |\n| `cloudStorageDestination` | `object (`[CloudStorageDestination](/earth-engine/reference/rest/v1beta/CloudStorageDestination)`)` If specified, configures export to Google Cloud Storage. |"]]
