Method: spreadsheets.sheets.copyTo
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک صفحه را از یک صفحه گسترده به صفحه گسترده دیگر کپی می کند. ویژگی های برگه جدید ایجاد شده را برمی گرداند.
درخواست HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
spreadsheetId | string شناسه صفحه گسترده حاوی برگه برای کپی کردن. |
sheetId | integer شناسه برگه برای کپی کردن. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"destinationSpreadsheetId": string
} |
فیلدها |
---|
destinationSpreadsheetId | string شناسه صفحه گسترده برای کپی کردن صفحه. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از SheetProperties
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-05-05 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-05-05 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: spreadsheets.sheets.copyTo\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCopies a single sheet from a spreadsheet to another spreadsheet. Returns the properties of the newly created sheet.\n\n### HTTP request\n\n`POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------|\n| `spreadsheetId` | `string` The ID of the spreadsheet containing the sheet to copy. |\n| `sheetId` | `integer` The ID of the sheet to copy. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------|\n| ``` { \"destinationSpreadsheetId\": string } ``` |\n\n| Fields ||\n|----------------------------|----------------------------------------------------------|\n| `destinationSpreadsheetId` | `string` The ID of the spreadsheet to copy the sheet to. |\n\n### Response body\n\nIf successful, the response body contains an instance of [SheetProperties](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#SheetProperties).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/spreadsheets`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]