Method: projects.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينشئ مشروعًا نصيًا جديدًا وفارغًا بدون ملفات نصوص برمجية وملف بيان أساسي.
طلب HTTP
POST https://script.googleapis.com/v1/projects
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"title": string,
"parentId": string
} |
| الحقول |
title |
string
عنوان المشروع.
|
parentId |
string
رقم تعريف Drive لملف رئيسي يرتبط به مشروع النص البرمجي الذي تم إنشاؤه. ويكون عادةً معرّف "مستند Google" أو "جدول بيانات Google" أو "نموذج Google" أو "العروض التقديمية من Google". وفي حال ترك هذه السياسة بدون ضبط، سيتم إنشاء مشروع نص برمجي مستقل.
|
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Project تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/script.projects
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCreates a new, empty script project with no script files and a base manifest file.\u003c/p\u003e\n"],["\u003cp\u003eThe request body can include a title for the project and the Drive ID of a parent file to bind the project to.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a Project object representing the newly created script project.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/script.projects\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\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\nCreates a new, empty script project with no script files and a base manifest file.\n\n### HTTP request\n\n`POST https://script.googleapis.com/v1/projects`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------|\n| ``` { \"title\": string, \"parentId\": string } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `title` | `string` The title for the project. |\n| `parentId` | `string` The Drive ID of a parent file that the created script project is bound to. This is usually the ID of a Google Doc, Google Sheet, Google Form, or Google Slides file. If not set, a standalone script project is created. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Project](/apps-script/api/reference/rest/v1/projects#Project).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/script.projects`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
