Method: projects.image.import
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.
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import
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.imports.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 |
{
"imageManifest": {
object (ImageManifest)
},
"description": string,
"overwrite": boolean,
"requestId": string
} |
| Trường |
imageManifest |
object (ImageManifest)
Tệp kê khai hình ảnh.
|
description |
string
Tên công việc mà con người đọc được.
|
overwrite |
boolean
Cho phép ghi đè thành phần hiện có hay không.
|
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ự.
|
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
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
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\u003eImports an image into Earth Engine using an HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an image manifest, description, overwrite option, and optional request ID.\u003c/p\u003e\n"],["\u003cp\u003eUsers need \u003ccode\u003eearthengine.imports.create\u003c/code\u003e permission on the specified Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an Operation object to track the import progress.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication requires specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],["This content outlines how to import an image using an HTTP POST request to the Earth Engine API. The request uses the URL `https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import`, requiring `earthengine.imports.create` IAM permission. The request body must include `imageManifest`, `description`, `overwrite` and optionally a `requestId`. A successful request returns an `Operation`. OAuth scopes for authorization include `earthengine` or `cloud-platform`.\n"],null,["# Method: projects.image.import\n\nImports an image.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import`\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.imports.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"imageManifest\": { object (/earth-engine/reference/rest/v1alpha/ImageManifest) }, \"description\": string, \"overwrite\": boolean, \"requestId\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `imageManifest` | `object (`[ImageManifest](/earth-engine/reference/rest/v1alpha/ImageManifest)`)` The image manifest. |\n| `description` | `string` A human-readable name of the task. |\n| `overwrite` | `boolean` Whether to allow overwriting an existing asset. |\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\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\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
