تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعتمد جميع عمليات الدمج في Google Workspace على Google Cloud لإعداد إذن الوصول إلى واجهة برمجة التطبيقات والتعامل مع المصادقة والتفويض وإدارة التطبيقات. قد تحتاج أيضًا إلى الحصول على إذن بالوصول إلى Google Classroom لاختبار عملية الربط.
يوضّح هذا الدليل كيفية طلب هذه الموارد وإعدادها.
إعداد مشروع على Google Cloud
أكمِل خطوات البدء لمطوّري Google Workspace. هذه الخطوات مطلوبة لجميع عمليات الدمج في Google Workspace.
الحسابات والنطاقات التجريبية
نطاقات العرض التوضيحي هي حسابات اختبار لعمليات دمج Classroom API. يمثّل النطاق التجريبي مؤسسة تعليمية وهمية لديها اشتراك في Google Workspace for Education يمكنك استخدامه لتطوير عمليات الدمج واختبارها بدون التأثير في المستخدمين الفعليين.
يمكنك الحصول على نطاق اختباري لاختبار إمكانات المشرف أو لأغراض التطوير باستخدام Classroom API.
الحصول على نطاق اختبار إداري
يمكنك استخدام بيئة تجريبية مُعدّة مسبقًا إذا كنت بحاجة فقط إلى اختبار أذونات المشرف لواجهة برمجة التطبيقات. ويشمل ذلك، على سبيل المثال، إنشاء دورات تدريبية نيابةً عن المعلّمين.
لاستخدام البيئة المُنشأة مسبقًا، انضم إلى برنامج Partner Advantage من Google Cloud. يمكن للأعضاء الوصول إلى صفحة Google for Education في Partner Advantage. توضّح هذه الصفحة كيفية الوصول إلى بيئة العرض التوضيحي الجاهزة مسبقًا من Google Workspace for Education التي يمكن استخدامها في العروض التوضيحية للعملاء وتحديد المشاكل وحلّها في المنتجات واختبار الميزات وغير ذلك.
الحصول على نطاق تجريبي للمطوّرين
لتقديم طلبات نيابةً عن المعلّمين والطلاب، عليك إنشاء نطاق تجريبي خاص بك على Google Workspace for Education وإدارته. تتضمّن النطاقات التجريبية ترخيصًا مجانيًا ودائمًا لإصدار Google Workspace for Education Fundamentals. يمكن إضافة المزيد من المنتجات إلى النطاق حسب الحاجة.
أكمِل الخطوات التالية للحصول على نطاق تجريبي للمطوّرين.
اشترِ نطاقًا بالتنسيق gedu.demo.YOUR DOMAIN.
على سبيل المثال، يجب أن تنشئ مؤسسة تدير النطاق myedtech.comgedu.demo.myedtech.com. يجب أن تتّبع نطاقات العرض التوضيحي هذا التنسيق.
إذا كنت بصدد تطوير عملية دمج تستخدم ميزات Google Classroom المدفوعة، يمكنك طلب ترقية نطاق تجريبي.
سجِّل الدخول إلى وحدة تحكّم المشرف في Google باستخدام حساب المشرف الذي حدّدته عند الاشتراك في Google Workspace for Education. من هنا، يمكنك إنشاء مستخدمين جدد لنطاق العرض التوضيحي. ننصحك بإنشاء ثلاثة مستخدمين إضافيين على الأقل: مستخدم واحد ليكون معلّمًا ومستخدمَين ليكونوا طلابًا.
طلب ترقية نطاق تجريبي للاستفادة من الميزات المميّزة
يجب أن يكون لدى المستخدمين ترخيص Google Workspace for Education مناسب لاستخدام عمليات الدمج التي تؤثر في ميزات Classroom المدفوعة أو تعتمد عليها. وتشمل هذه الميزات ما يلي:
إذا كان الدمج سيستخدم أيًا من هذه الميزات، أكمِل الخطوات التالية
لطلب ترقية النطاق التجريبي. سيتم منح النطاق الذي تمت ترقيته عشرة تراخيص مجانية من Google Workspace for Education Plus يمكنك تعيينها للمستخدمين التجريبيين.
أكمِل نموذج طلب ترقية النطاق التجريبي وأرسِله. يؤدي إرسال هذا النموذج إلى طلب ترقية نطاقك التجريبي إلى Google Workspace for Education Plus مع توفير عشرة تراخيص.
ستتلقّى رسالة إلكترونية عند اكتمال عملية الترقية.
امنح تراخيص Plus لحسابات المعلّمين التجريبية في وحدة تحكّم المشرف الخاصة بالنطاق التجريبي الذي تمت ترقيته.
ضمن الدليل > المستخدمون، أنشئ حسابات معلّمين تجريبية أو اختَرها.
في قسم التراخيص الخاص بكل معلّم، تأكَّد من تعيين Google Workspace for Education Plus.
تاريخ التعديل الأخير: 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,["# Prerequisites\n\nAll Google Workspace integrations depend on Google Cloud to configure API\naccess, handle authentication and authorization, and manage applications. You\nmight also need to obtain access to Google Classroom to test your integration.\nThis guide describes how to request and configure these resources.\n\nSet up a Google Cloud project\n-----------------------------\n\n| **Key Point:** You must use a Google Cloud project to manage a Google Classroom integration. You don't need to use any paid Google Cloud features to use Classroom API.\n\nComplete the [steps to get started](/workspace/guides/get-started) for Google Workspace\ndevelopers. These steps are **required** for all Google Workspace\nintegrations.\n\nTest accounts and domains\n-------------------------\n\n| **Key Point:** While standard Gmail accounts can access Google Classroom, you will need a demo domain if you are attempting to test behaviors that only apply to Google Workspace for Education users, such as special administrator capabilities.\n\n**Demo domains** are test accounts for Classroom API integrations. A\ndemo domain represents a fictional school with a Google Workspace for Education subscription you can\nuse for developing and testing integrations without affecting live users.\n\nYou can get a test domain to test administrator capabilities or for development\nwith the Classroom API.\n\n### Get an administrative test domain\n\nYou can use a prebuilt demo environment if you only need to test administrator\npermissions of the API. This includes, for example, creating courses on behalf\nof teachers.\n\nTo use the prebuilt environment, join the Google Cloud [Partner Advantage\nProgram](//www.partneradvantage.goog/GCPPRM/s/partnerselfregistration). Members receive access to the [Google for Education page](//www.partneradvantage.goog/GCPPRM/s/productgoogleeducation) of Partner\nAdvantage. This page describes how to access our prebuilt Google Workspace for\nEducation demo environment that can be used for customer demos, product\ntroubleshooting, feature testing, and more.\n\n### Get a developer demo domain\n\nTo make requests on behalf of teacher and student users, you need to create and\nmanage your own Google Workspace for Education demo domain. Demo domains include a free, permanent\nGoogle Workspace for Education Fundamentals [license](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). More products can be added to the domain as\nneeded.\n\nComplete the following steps to get a developer demo domain.\n\n1. Purchase a domain in the format `gedu.demo.`\u003cvar translate=\"no\"\u003eYOUR DOMAIN\u003c/var\u003e. For example, an organization that operates the domain `myedtech.com` should create `gedu.demo.myedtech.com`. Demo domains must follow this format.\n2. [Sign up for Google Workspace for Education](//workspace.google.com/signup/edu/welcome) using the demo domain. This starts a\n two-week trial period.\n\n | **Important:** The new domain must be a **primary** Google Workspace domain. This means that your demo domain cannot be a subdomain of an existing Google Workspace domain, which are referred to as *secondary* domains. Google cannot grant a demo license to a secondary domain. See the [Choose your primary domain](//support.google.com/a/answer/182080) and [Change your primary domain](//support.google.com/a/topic/6302293) Help Center articles for more information about managing domains used for Google Workspace.\n | **Caution:** Don't wait! Complete the following steps *as soon as possible* after starting the two-week trial period. We can only take action on *active\n | Google Workspace for Education subscriptions*.\n3. [Verify](//support.google.com/a/answer/60216) that you own the demo domain.\n\n4. Fill out this [form](//docs.google.com/a/google.com/forms/d/e/1FAIpQLScFnnpQCCbqw-Phwv3ZOkFkSRnH7JhpyBgPl15M_oZBbC3FjA/viewform) to notify Google of your domain registration.\n\n5. If you are developing an integration that uses paid Google Classroom\n features, [request a demo domain upgrade](#request-demo).\n\n6. Sign in to the [Google Admin console](//admin.google.com/) using the\n administrator account you specified when signing up for Google Workspace for Education. From here,\n [create new demo domain users](//knowledge.workspace.google.com/kb/how-to-create-a-new-user-000007668); we recommend creating at least three\n additional users: one to act as teacher and two students.\n\n7. Sign in to [Google Classroom](//classroom.google.com/) using a new teacher account.\n [Create a new class](//support.google.com/edu/classroom/answer/6020273) and [add your new student accounts](//support.google.com/edu/classroom/answer/6020282) to it.\n\n| **Tip:** Create separate Chrome profiles for your demo domain users so that you can quickly switch between them while using your demo domain.\n\n#### Request a demo domain upgrade for premium features\n\n| **Key Point:** Some Google Classroom features require a paid Google Workspace for Education [license](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). Request an upgrade for your demo domain to be able to test an integration that relies on these features.\n\nUsers must have an appropriate Google Workspace for Education license to use integrations that affect\nor depend on premium Classroom features. These features include:\n\n- Classroom add-ons\n- Grading periods\n- Grading scales\n- Grade export\n- Roster sync\n- Rubrics\n\nSee the [Google Workspace for Education licenses](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) page for the full list of features\navailable at each subscription level.\n\nIf your integration will use any of these features, complete the following steps\nto request a demo domain upgrade. An upgraded domain will be granted ten free\nGoogle Workspace for Education Plus licenses to assign to your test users.\n\n1. Complete the steps to [get a developer demo domain](#get-developer) if you haven't already.\n2. Complete and submit the [demo domain upgrade request form](//docs.google.com/forms/d/e/1FAIpQLSeBARH7nviEOyqFp3OWKVR6m4621UW9ELzUFI_XDu5ENqUUGw/viewform?usp=sf_link). Submitting this form requests that Google upgrade your demo domain to Google Workspace for Education Plus with ten licenses.\n3. You will receive an email when the upgrade process is complete.\n4. Assign Plus licenses to your test teacher accounts in the upgraded demo domain [Admin console](//admin.google.com/).\n 1. Under **Directory \\\u003e Users**, create or select your test teacher account(s).\n 2. In each teacher's **Licenses** , confirm that Google Workspace for Education Plus is **Assigned**."]]
