تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تساعدك أداة واجهة سطر الأوامر (CLI) في إنشاء واجهة المستخدم
بنية المشروع وملفاته ونشرها كمشروع إجراءات في قسم
وحدة التحكم. للحصول على معلومات حول استخدام أداة سطر الأوامر في السيناريوهات الشائعة
بعد تثبيته وإعداده، راجِع دليل المستخدم.
بدلاً من ذلك.
بعد تثبيت هذه الأداة، يمكنك الحصول على ملخص عن وظائفها في
محطة طرفية:
gactions --help
يظهر الناتج التالي:
Command Line Interface for Google Actions SDK
Usage:
gactions [command]
Available Commands:
decrypt Decrypt client secret.
deploy Deploy an Action to the specified channel.
encrypt Encrypt client secret.
help Help about any command
init Initialize a directory for a new project.
login Authenticate gactions CLI to your Google account via web browser.
logout Log gactions CLI out of your Google Account.
pull This command pulls files from Actions Console into the local file system.
push This command pushes changes in the local files to Actions Console.
third-party-notices Prints license files of third-party software used.
version Prints current version of the CLI.
Flags:
-h, --help help for gactions
-v, --verbose Display additional error information
Use "gactions [command] --help" for more information about a command.
تثبيت أداة سطر أوامر Gactions
تثبيت أداة واجهة سطر الأوامر (CLI) gactions من خلال تنزيل
التثبيت، وفكّ الحزمة، وإعداد مسار التنفيذ.
لتثبيت التفاعلات وإعدادها، اتبع الخطوات التالية:
قم بتنزيل الحزمة المناسبة لنظام التشغيل الذي تستخدمه:
استخرِج الحزمة في موقع جغرافي من اختيارك وأضِف البرنامج الثنائي إلى
متغير PATH للبيئة. بدلاً من ذلك، يمكنك استخراج الحزمة إلى
موقع موجود بالفعل في متغير PATH (على سبيل المثال، /usr/local/bin).
على نظامَي التشغيل Linux وMac، فعِّل أذونات التنفيذ إذا لزم الأمر:
chmod +x PATH_TO/gactions
شغِّل الأمر التالي لمصادقة واجهة سطر الأوامر. هذا الأمر
عملية مصادقة وتتطلب متصفح ويب:
gactions login
وعند اكتمال التدفق، تتم مصادقة واجهة سطر الأوامر تلقائيًا.
إنشاء مشروع وإعداده
قبل أن تتمكن من استخدام أداة سطر الأوامر Gactions، يجب عليك إنشاء مشروع في
وحدة تحكم الإجراءات ومنح الأنشطة إمكانية الوصول إلى المشروع. لإنشاء وضبط
قم بما يلي:
انقر على مشروع جديد، وأدخِل اسم المشروع، ثم انقر على إنشاء مشروع.
اختيار فئة والنقر على التالي
اختَر مشروع فارغ وانقر على بدء البناء.
يمكنك تفعيل Actions API في وحدة تحكُّم Google Cloud من خلال اتّباع الخطوات التالية:
الإرشادات الواردة في تمكين وتعطيل
API.
يسمح هذا للتفاعلات بالتفاعل مع مشروعك.
إعداد عيّنة
أنشئ دليلاً فارغًا، ثم شغِّل gactions init SAMPLE_NAME
من هذا الدليل لاستيراد نموذج لمشروع الإجراءات. يمكنك استخدام العيّنة
كنموذج لإنشاء مشروعك الخاص وفهم الإجراءات
لهيكل المشروع.
على سبيل المثال، ينتج عن الأمر التالي محتوى hello-world.
النموذج الذي تتم إضافته إلى الدليل:
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003egactions\u003c/code\u003e command-line interface (CLI) helps you create, manage, and deploy Google Actions projects.\u003c/p\u003e\n"],["\u003cp\u003eYou can download and install \u003ccode\u003egactions\u003c/code\u003e for Windows, Linux, or Mac OS, then authenticate it with your Google account.\u003c/p\u003e\n"],["\u003cp\u003eBefore using \u003ccode\u003egactions\u003c/code\u003e, create a project in the Actions console and enable the Actions API.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egactions init\u003c/code\u003e to initialize a new project based on a sample, providing a starting point for your development.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the user guide for detailed instructions and common usage scenarios after setting up the tool.\u003c/p\u003e\n"]]],[],null,["# gactions overview\n\nThe gactions command line interface (CLI) tool helps you create the required\nproject structure and files and deploy them as an Actions project in the Actions\nconsole. For information on using the command-line tool in common scenarios\nafter it's installed and set up, see the [user guide](/assistant/actionssdk/gactions/guide)\ninstead.\n\nOnce installed, you can get a summary of the tool's functionality in your\nterminal: \n\n```text\ngactions --help\n```\n\nThe following output appears: \n\n```\nCommand Line Interface for Google Actions SDK\n\nUsage:\n gactions [command]\n\nAvailable Commands:\n decrypt Decrypt client secret.\n deploy Deploy an Action to the specified channel.\n encrypt Encrypt client secret.\n help Help about any command\n init Initialize a directory for a new project.\n login Authenticate gactions CLI to your Google account via web browser.\n logout Log gactions CLI out of your Google Account.\n pull This command pulls files from Actions Console into the local file system.\n push This command pushes changes in the local files to Actions Console.\n third-party-notices Prints license files of third-party software used.\n version Prints current version of the CLI.\n\nFlags:\n -h, --help help for gactions\n -v, --verbose Display additional error information\n\nUse \"gactions [command] --help\" for more information about a command.\n```\n\nInstall the gactions command-line tool\n--------------------------------------\n\nInstall the gactions command line interface (CLI) tool by downloading an\ninstallation package, unpacking it, and configuring your execution path.\n\nTo install and configure gactions, follow these steps:\n\n1. Download the appropriate package for your operating system:\n\n | Platform | Package | Checksum |\n |----------|----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n | Windows | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip.sha256) |\n | Linux | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz.sha256) |\n | Mac OS | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz.sha256) |\n\n2. Extract the package to a location of your choice and add the binary to your\n environment's `PATH` variable. Alternatively, extract the package to a\n location that's already in your `PATH` variable (for example, `/usr/local/bin`).\n\n3. On Linux and Mac, enable execute permissions if necessary:\n\n ```scdoc\n chmod +x PATH_TO/gactions\n ```\n4. Run the following command to authenticate the CLI. This command\n starts an authentication flow and requires a web browser:\n\n ```text\n gactions login\n ```\n\n When the flow is complete, the CLI automatically authenticates.\n\nCreate and set up a project\n---------------------------\n\n| **Note:** Actions project creation is not supported in the gactions CLI.\n\nBefore you can use the gactions command-line tool, you must create a project in\nthe Actions console and give gactions access to the project. To create and set\nup a project, do the following:\n\n1. Go to the [Actions console](https://console.actions.google.com).\n2. Click **New project** , enter a project name, and click **Create project**.\n3. Select a category and click **Next**.\n4. Select **Blank project** and click **Start building**.\n5. Enable the **Actions API** in the Google Cloud console by following the instructions in [Enable and disable\n APIs](https://support.google.com/googleapi/answer/6158841). This allows gactions to interact with your project.\n\nInitialize a sample\n-------------------\n\nCreate an empty directory, then run `gactions init `\u003cvar translate=\"no\"\u003eSAMPLE_NAME\u003c/var\u003e\nfrom that directory to import a sample Actions project. You can use the sample\nproject as a model to create your own project and to understand an Actions\nproject's structure.\n\nFor instance, the following command results in the contents of the `hello-world`\nsample being added to your directory: \n\n```text\ngactions init hello-world\n```"]]
