お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
Method: projects.image.import
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
project |
string
このリクエストのサービス ユーザーとして扱う必要がある Google Cloud Platform プロジェクトのプロジェクト ID またはプロジェクト番号。形式は projects/{project-id} です。
認可には、指定されたリソース project に対する次の IAM の権限が必要です。
earthengine.imports.create
|
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 |
{
"imageManifest": {
object (ImageManifest)
},
"description": string,
"overwrite": boolean,
"requestId": string
} |
| フィールド |
imageManifest |
object (ImageManifest)
イメージ マニフェスト。
|
description |
string
タスクのわかりやすい名前。
|
overwrite |
boolean
既存のアセットを上書きするかどうか。
|
requestId |
string
重複したリクエストを検出するために使用される一意の文字列。同じユーザーが同じ空でない requestId を使用して複数のリクエストを送信した場合、長時間実行オペレーションが正常に開始されるのは、そのうちの 1 つのみです。requestId には、a ～ z、A ～ Z、0 ～ 9、- の文字を使用できます。requestId の最大長は 60 文字です。
|
レスポンスの本文
成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]
