إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
Method: projects.assets.copy
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
POST https://earthengine.googleapis.com/v1beta/{sourceName=projects/*/assets/**}:copy
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
sourceName |
string
اسم مادة العرض المطلوب نسخها. يكون name بالتنسيق "projects/*/assets/**" (على سبيل المثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). تندرج جميع مواد العرض التي يملكها المستخدمون ضمن المشروع "earthengine-legacy" (على سبيل المثال، "projects/earthengine-legacy/assets/users/foo/bar"). جميع مواد العرض الأخرى تخضع للمشروع "earthengine-public" (مثل "projects/earthengine-public/assets/LANDSAT"). (مثال: "assets/users/[USER]/[ASSET]").
يتطلب التفويض إذن IAM التالي على المورد المحدّد sourceName :
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
{
"destinationName": string,
"overwrite": boolean
} |
الحقول |
destinationName |
string
اسم الوجهة التي سيتم نسخ مادة العرض إليها. يكون name بالتنسيق "projects/*/assets/**" (على سبيل المثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). تندرج جميع مواد العرض التي يملكها المستخدمون ضمن المشروع "earthengine-legacy" (على سبيل المثال، "projects/earthengine-legacy/assets/users/foo/bar"). جميع مواد العرض الأخرى تخضع للمشروع "earthengine-public" (مثل "projects/earthengine-public/assets/LANDSAT").
يتطلب التفويض إذن IAM التالي على المورد المحدّد destinationName :
earthengine.assets.create
|
overwrite |
boolean
ما إذا كان سيتم السماح باستبدال مادة عرض حالية.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال EarthEngineAsset
.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCopies an Earth Engine asset from a source to a destination location.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the source and destination asset names in the request.\u003c/p\u003e\n"],["\u003cp\u003eAllows overwriting an existing asset at the destination with the \u003ccode\u003eoverwrite\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eNeeds appropriate IAM permissions for both source (get) and destination (create) assets.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication can be achieved using Earth Engine or Cloud Platform OAuth scopes.\u003c/p\u003e\n"]]],["To copy an asset, send a POST request to `https://earthengine.googleapis.com/v1beta/{sourceName=projects/*/assets/**}:copy`. Specify the `sourceName` path parameter to indicate the asset to copy and include a request body with the `destinationName` string and an `overwrite` boolean, which indicates if an existing asset can be overwritten. User-owned assets are under `earthengine-legacy`, and all other assets are under `earthengine-public`. The response will contain the copied asset information. Authorization is required.\n"],null,["# Method: projects.assets.copy\n\nCopies an asset.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{sourceName=projects/*/assets/**}:copy`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sourceName` | `string` The name of the asset to copy. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). (e.g., \"assets/users/\\[USER\\]/\\[ASSET\\]\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `sourceName`: - `earthengine.assets.get` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------|\n| ``` { \"destinationName\": string, \"overwrite\": boolean } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `destinationName` | `string` The destination name to which to copy the asset. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `destinationName`: - `earthengine.assets.create` |\n| `overwrite` | `boolean` Whether to allow overwriting an existing asset. |\n\n### Response body\n\nIf successful, the response body contains an instance of [EarthEngineAsset](/earth-engine/reference/rest/v1beta/projects.assets#EarthEngineAsset).\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)."]]