Method: projects.video.export
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bắt đầu một quy trình xử lý hàng loạt để tính toán một video và ghi kết quả vào một trong nhiều đích đến.
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/video:export
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
project |
string
Mã dự án hoặc số dự án của dự án Google Cloud Platform sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id} .
Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên project đã chỉ định:
earthengine.exports.create
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"expression": {
object (Expression )
},
"description": string,
"videoOptions": {
object (VideoOptions )
},
"fileExportOptions": {
object (VideoFileExportOptions )
},
"requestId": string,
"workloadTag": string,
"priority": integer
} |
Trường |
expression |
object (Expression )
Một biểu thức đánh giá video để tính toán và xuất, được biểu thị dưới dạng một bộ sưu tập hình ảnh.
|
description |
string
Tên công việc mà con người đọc được.
|
videoOptions |
object (VideoOptions )
Các tuỳ chọn cơ bản mô tả video cần tạo.
|
fileExportOptions |
object (VideoFileExportOptions )
Các lựa chọn về vị trí và định dạng xuất video.
|
requestId |
string
Một chuỗi duy nhất dùng để phát hiện các yêu cầu trùng lặp. Nếu cùng một người dùng thực hiện nhiều yêu cầu với cùng một requestId không trống, thì chỉ một trong các yêu cầu đó mới có thể bắt đầu thành công một thao tác chạy trong thời gian dài. requestId có thể chứa các ký tự a..z, A..Z, 0-9 hoặc "-". requestId có thể dài tối đa 60 ký tự.
|
workloadTag |
string
Nhãn do người dùng cung cấp để theo dõi phép tính này.
|
priority |
integer
Không bắt buộc. Mức độ ưu tiên của tác vụ xuất trong dự án. Các tác vụ có mức độ ưu tiên cao hơn sẽ được lên lịch sớm hơn. Phải là số nguyên từ 0 đến 9999. Mặc định là 100 nếu không được đặt.
|
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/devstorage.full_control
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
VideoFileExportOptions
Các tuỳ chọn để xuất video dưới dạng tệp bên ngoài Earth Engine.
Biểu diễn dưới dạng 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 .
} |
Trường |
fileFormat |
enum (VideoFileFormat )
Định dạng tệp để xuất(các) video. Hiện tại, chúng tôi chỉ hỗ trợ định dạng MP4.
|
Trường hợp hợp nhất destination . Vị trí ghi kết quả. destination chỉ có thể là một trong những giá trị sau: |
driveDestination |
object (DriveDestination )
Định cấu hình tính năng xuất sang Google Drive (nếu được chỉ định).
|
cloudStorageDestination |
object (CloudStorageDestination )
Định cấu hình tính năng xuất sang Google Cloud Storage (nếu được chỉ định).
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]