توضّح أدلة التشغيل السريع كيفية إعداد تطبيق وتشغيله، وهو تطبيق يستدعي إحدى واجهات Google Workspace API. يستخدم دليل البدء السريع هذا أسلوبًا مبسطًا للمصادقة مناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، ننصحك بالتعرّف على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
في "برمجة التطبيقات"، تستخدم أدوات البدء السريع في Google Workspace خدمات Google المتقدّمة لاستدعاء واجهات برمجة التطبيقات في Google Workspace والتعامل مع بعض تفاصيل عملية المصادقة والتفويض.
/** * Prints the title of the sample document: * https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit * @see https://developers.google.com/docs/api/reference/rest/v1/documents/get */functionprintDocTitle(){constdocumentId='195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE';constdoc=Docs.Documents.get(documentId,{'includeTabsContent':true});console.log(`The title of the doc is: ${doc.title}`);}
انقر على "حفظ" .
انقر على مشروع بلا عنوان، ثم اكتب البدء السريع، وانقر على إعادة تسمية.
ضبط النص البرمجي
تفعيل Google Docs API
افتح مشروع Apps Script.
انقر على أداة التعديلcode.
بجانب الخدمات، انقر على "إضافة خدمة" add .
اختَر Google Docs API وانقر على إضافة.
تشغيل العيّنة
في محرِّر Apps Script، انقر على تنفيذ.
في المرة الأولى التي تشغّل فيها العيّنة، سيُطلب منك منح الإذن بالوصول:
تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Create a\n[Google Apps Script](/apps-script/overview)\nthat makes requests to the Google Docs API.\n\nQuickstarts explain how to set up and run an app that calls a\nGoogle Workspace API. This quickstart uses a\nsimplified authentication approach that is appropriate for a testing\nenvironment. For a production environment, we recommend learning about\n[authentication and authorization](/workspace/guides/auth-overview)\nbefore\n[choosing the access credentials](/workspace/guides/create-credentials#choose_the_access_credential_that_is_right_for_you)\nthat are appropriate for your app.\n\nIn Apps Script, Google Workspace\nquickstarts use\n[Advanced Google services](/apps-script/guides/services/advanced) to call\nGoogle Workspace APIs and handle some details of the authentication\nand authorization flow.\n\nObjectives\n\n- Configure the environment.\n- Create and configure the script.\n- Run the script.\n\nPrerequisites\n\n- A Google Account\n\n\u003c!-- --\u003e\n\n- Access to Google Drive\n\nCreate the script\n\n1. Create a new script by going to [script.google.com/create](https://script.google.com/create).\n2. Replace the contents of the script editor with the following code:\n\n\ndocs/quickstart/quickstart.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/docs/quickstart/quickstart.gs) \n\n```javascript\n/**\n * Prints the title of the sample document:\n * https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit\n * @see https://developers.google.com/docs/api/reference/rest/v1/documents/get\n */\nfunction printDocTitle() {\n const documentId = '195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE';\n const doc = Docs.Documents.get(documentId, {'includeTabsContent': true});\n console.log(`The title of the doc is: ${doc.title}`);\n}\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n3. Click Save .\n4. Click **Untitled project** , type **Quickstart** , and click **Rename**.\n\n\u003cbr /\u003e\n\nConfigure the script\n\nEnable the Google Docs API\n\nOpen the Apps Script project.\n\n1. Click **Editor** code.\n2. Next to **Services** , click Add a service add .\n3. Select Google Docs API and click **Add**.\n\nRun the sample\n\nIn the Apps Script editor, click **Run**.\n\nThe first time you run the sample, it prompts you to authorize access:\n\n1. Click **Review permissions**.\n2. Choose an account.\n3. Click **Allow**.\n\nThe script's execution log appears at the bottom of the window. \ndone It worked! **Great!** Check out the further reading section below to learn more.\nwarning There was a problem **Bummer** , [let us know what went wrong](#). Check out our [troubleshooting](#troubleshooting) section below for some common errors and solutions. If you have found a bug in the code, [report the issue on GitHub](https://github.com/googleworkspace/apps-script-samples/issues) or submit a pull request.\n\nNext steps\n\n- [Google Apps Script Advanced Services documentation](/apps-script/guides/services/advanced)\n- [Troubleshoot authentication and authorization issues](/workspace/docs/api/troubleshoot-authentication-authorization)\n- [Docs API reference documentation](/workspace/docs/api/reference/rest)"]]
.