سيتم إيقاف "إجراءات المحادثة" في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على إنهاء إجراءات المحادثة.

نظرة عامة على gactions

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تساعدك أداة واجهة سطر الأوامر في gactions (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

يمكنك تثبيت أداة واجهة سطر الأوامر في gactions (CLI) من خلال تنزيل حزمة التثبيت وفكها وتهيئة مسار التنفيذ.

لتثبيت gactions وإعدادها، اتبع الخطوات التالية:

  1. تنزيل الحزمة المناسبة لنظام التشغيل:

    النظام الأساسي طرد المجموع الاختباري
    Windows تنزيل SHA256
    Linux تنزيل SHA256
    نظام تشغيل Mac تنزيل SHA256

  2. استخرج الحزمة في موقع من اختيارك وأضف البرنامج الثنائي إلى متغير PATH للبيئة المحيطة. ويمكنك بدلاً من ذلك استخراج الحزمة إلى موقع جغرافي سبق أن تمّت إضافته إلى متغيّر PATH (مثل /usr/local/bin).

  3. على نظامي التشغيل Linux وMac، فعِّل أذونات التنفيذ إذا لزم الأمر:

    chmod +x PATH_TO/gactions

  4. شغّل الأمر التالي لمصادقة سطر الأوامر (CLI). يؤدي هذا الأمر إلى بدء تدفق مصادقة ويتطلب متصفح ويب:

    gactions login

    عند اكتمال العملية، تتم مصادقة واجهة سطر الأوامر (CLI) تلقائيًا.

إنشاء مشروع وإعداده

قبل أن تتمكّن من استخدام أداة سطر أوامر gactions، عليك إنشاء مشروع في "وحدة تحكّم المهام" ومنح gactions إذن الوصول إلى المشروع. لإنشاء مشروع وإعداده، يمكنك إجراء ما يلي:

  1. انتقل إلى وحدة تحكم الإجراءات.
  2. انقر على مشروع جديد، وأدخِل اسم مشروع، ثم انقر على إنشاء مشروع.
  3. حدد فئة وانقر على التالي.
  4. اختَر مشروعًا فارغًا وانقر على بدء البناء.
  5. فعِّل Actions API في Google Cloud Console باتّباع التعليمات الواردة في تفعيل وإيقاف واجهات برمجة التطبيقات. يسمح ذلك بالتفاعلات مع مشروعك.

إعداد نموذج

أنشئ دليلاً فارغًا، ثم شغِّل gactions init SAMPLE_NAME من هذا الدليل لاستيراد نموذج مشروع الإجراءات. يمكنك استخدام نموذج المشروع كنموذج لإنشاء مشروعك وفهم بنية مشروع الإجراءات.

على سبيل المثال، يؤدي الأمر التالي إلى إضافة محتوى نموذج hello-world إلى الدليل:

gactions init hello-world