اسناد را ایجاد و مدیریت کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه Google Docs API نحوه انجام برخی از وظایف سطح بالا مربوط به اسناد Google Docs را شرح میدهد، مانند:
- یک سند ایجاد کنید
- یک سند موجود را کپی کنید
پاراگراف های زیر این وظایف را به تفصیل شرح می دهند.
یک سند خالی ایجاد کنید
برای ایجاد سند، از روش documents.create
در مجموعه documents
استفاده کنید.
نمونه کد زیر نحوه ایجاد یک سند خالی با عنوان مشخص را نشان می دهد:
جاوا
private static void createDoc(Docs service) throws IOException {
Document doc = new Document()
.setTitle("My Document");
doc = service.documents().create(doc)
.execute();
System.out.println("Created document with title: " + doc.getTitle());
}
PHP
$title = 'My Document';
$document = new Google_Service_Docs_Document(array(
'title' => $title
));
$document = $service->documents->create($document);
printf("Created document with title: %s\n", $document->title);
پایتون
title = 'My Document'
body = {
'title': title
}
doc = service.documents() \
.create(body=body).execute()
print('Created document with title: {0}'.format(
doc.get('title')))
با پوشه های Google Drive کار کنید
هیچ گزینه ای برای ایجاد یک سند مستقیماً در یک پوشه Drive مشخص با استفاده از Docs API وجود ندارد. به طور پیش فرض، سند ایجاد شده در پوشه اصلی کاربر در Drive ذخیره می شود.
با این حال، دو گزینه برای ذخیره یک فایل در پوشه Drive وجود دارد:
پس از ایجاد سند، آن را با استفاده از روش files.update
در Drive API به یک پوشه خاص منتقل کنید. برای اطلاعات بیشتر در مورد انتقال فایلها، به انتقال فایلها بین پوشهها مراجعه کنید.
با استفاده از روش files.create
در Drive API، یک سند خالی به پوشه اضافه کنید و application/vnd.google-apps.document
به عنوان mimeType
مشخص کنید. برای اطلاعات بیشتر در مورد ایجاد فایل، به ایجاد فایل در یک پوشه خاص مراجعه کنید.
برای هر یک از گزینههای دیگر، باید محدودههای Drive API مناسب را برای تأیید تماس اضافه کنید. برای اطلاعات بیشتر درباره حوزههای Drive، به انتخاب حوزههای API Google Drive مراجعه کنید.
برای انتقال یا ایجاد فایل در پوشه درایو مشترک، به اجرای پشتیبانی از درایو مشترک مراجعه کنید.
یک سند موجود را کپی کنید
برای کپی کردن یک سند، از روش files.copy
Drive API استفاده کنید.
نمونه کد زیر نحوه کپی کردن یک سند موجود را نشان می دهد. میتوانید شناسه مورد استفاده برای تماس API Drive را در URL سند پیدا کنید. برای اطلاعات بیشتر، به شناسه سند مراجعه کنید.
https://docs.google.com/document/d/DOCUMENT_ID/edit
جاوا
String copyTitle = "Copy Title";
File copyMetadata = new File().setName(copyTitle);
File documentCopyFile =
driveService.files().copy(documentId, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();
Node.js
var copyTitle = "Copy Title";
let request = {
name: copyTitle,
};
this.driveService.files.copy({
fileId: documentId,
resource: request,
}, (err, driveResponse) => {
let documentCopyId = driveResponse.id;
});
PHP
<?php
$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
'name' => $copyTitle
));
$driveResponse = $driveService->files->copy($documentId, $copy);
$documentCopyId = $driveResponse->id;
پایتون
copy_title = 'Copy Title'
body = {
'name': copy_title
}
drive_response = drive_service.files().copy(
fileId=document_id, body=body).execute()
document_copy_id = drive_response.get('id')
توجه داشته باشید که برای تأیید تماس باید از یک محدوده Drive API مناسب استفاده کنید. برای اطلاعات بیشتر درباره حوزههای Drive، به انتخاب حوزههای API Google Drive مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Create and manage documents\n\nThis Google Docs API page describes how to perform certain high-level tasks\ninvolving Google Docs documents, such as:\n\n- Create a document\n- Copy an existing document\n\nThe following paragraphs describe these tasks in detail.\n\nCreate a blank document\n-----------------------\n\nTo create a document, use the\n[`documents.create`](/workspace/docs/api/reference/rest/v1/documents/create) method on the\n[`documents`](/workspace/docs/api/reference/rest/v1/documents) collection.\n\nThe following code sample shows how to create a blank document with a specified\ntitle: \n\n### Java\n\n\n```java\nprivate static void createDoc(Docs service) throws IOException {\n Document doc = new Document()\n .setTitle(\"My Document\");\n doc = service.documents().create(doc)\n .execute();\n System.out.println(\"Created document with title: \" + doc.getTitle());\n}\n```\n\n\u003cbr /\u003e\n\n### PHP\n\n\n```php\n$title = 'My Document';\n$document = new Google_Service_Docs_Document(array(\n 'title' =\u003e $title\n));\n\n$document = $service-\u003edocuments-\u003ecreate($document);\nprintf(\"Created document with title: %s\\n\", $document-\u003etitle);\n```\n\n\u003cbr /\u003e\n\n### Python\n\n\n```python\ntitle = 'My Document'\nbody = {\n 'title': title\n}\ndoc = service.documents() \\\n .create(body=body).execute()\nprint('Created document with title: {0}'.format(\n doc.get('title')))\n```\n\n\u003cbr /\u003e\n\n### Work with Google Drive folders\n\nThere's no option to create a document directly within a specified\nDrive folder using the Docs API. By default, the\ncreated document is saved to the user's root folder on Drive.\n\nHowever, there are two alternatives to saving a file to a Drive\nfolder:\n\n- After the document is created, move it to a specific folder using\n Drive API's\n [`files.update`](/workspace/drive/api/v3/reference/files/update) method. For\n more information on moving files, see [Move files between\n folders](/workspace/drive/api/guides/folder#move-files).\n\n- Add a blank document to a folder using the Drive API's\n [`files.create`](/workspace/drive/api/v3/reference/files/create) method,\n specifying `application/vnd.google-apps.document` as the `mimeType`. For\n more information on creating files, see [Create a file in a specific\n folder](/workspace/drive/api/guides/folder#create-file).\n\nFor either alternative, you'll need to add the appropriate [Drive API\nscopes](/workspace/drive/api/v3/reference/files/create#authorization-scopes) to\nauthorize the call. For more information on Drive scopes, see\n[Choose Google Drive API scopes](/workspace/drive/api/guides/api-specific-auth).\n\nTo move or create a file within a shared drive folder, see [Implement shared\ndrive support](/workspace/drive/api/guides/enable-shareddrives).\n\nCopy an existing document\n-------------------------\n\nTo copy a document, use Drive API's\n[`files.copy`](/workspace/drive/v3/reference/files/copy) method.\n\nThe following code sample shows how to copy an existing document. You can find\nthe ID to use for the Drive API call in the document URL. For more\ninformation, see\n[Document ID](/workspace/docs/api/concepts/document#document-id). \n\n https://docs.google.com/document/d/\u003cvar translate=\"no\"\u003eDOCUMENT_ID\u003c/var\u003e/edit\n\n### Java\n\n\n```java\nString copyTitle = \"Copy Title\";\nFile copyMetadata = new File().setName(copyTitle);\nFile documentCopyFile =\n driveService.files().copy(documentId, copyMetadata).execute();\nString documentCopyId = documentCopyFile.getId();\n```\n\n\u003cbr /\u003e\n\n### Node.js\n\n\n```javascript\nvar copyTitle = \"Copy Title\";\nlet request = {\n name: copyTitle,\n};\nthis.driveService.files.copy({\n fileId: documentId,\n resource: request,\n}, (err, driveResponse) =\u003e {\n let documentCopyId = driveResponse.id;\n});\n```\n\n\u003cbr /\u003e\n\n### PHP\n\n\n```php\n\u003c?php\n$copyTitle = 'Copy Title';\n$copy = new Google_Service_Drive_DriveFile(array(\n 'name' =\u003e $copyTitle\n));\n$driveResponse = $driveService-\u003efiles-\u003ecopy($documentId, $copy);\n$documentCopyId = $driveResponse-\u003eid;\n```\n\n\u003cbr /\u003e\n\n### Python\n\n\n```python\ncopy_title = 'Copy Title'\nbody = {\n 'name': copy_title\n}\ndrive_response = drive_service.files().copy(\n fileId=document_id, body=body).execute()\ndocument_copy_id = drive_response.get('id')\n```\n\n\u003cbr /\u003e\n\nNote that you need to use an appropriate [Drive API\nscope](/workspace/drive/v3/reference/files/copy#authorization-scopes)\nto authorize the call. For more information on Drive scopes, see\n[Choose Google Drive API scopes](/workspace/drive/api/guides/api-specific-auth).\n\nRelated topics\n--------------\n\n- [Insert, delete, and move text](/workspace/docs/api/how-tos/move-text)\n- [Merge text into a document](/workspace/docs/api/how-tos/merge)\n- [Document concepts](/workspace/docs/api/concepts/document)"]]