تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة .
تثبيت حزمة تطوير البرامج (SDK) والرمز النموذجي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اتبع هذه التعليمات لتثبيت حزمة SDK ونموذج التعليمات البرمجية في مشروعك.
عليك تشغيل كل الأوامر في هذه الصفحة عبر نافذة طرفية في الجهاز (إما
مباشرةً أو عبر اتصال بروتوكول النقل الآمن).
ملاحظة: تفترض هذه التعليمات أن هناك بيئة Python تعمل على نظام Linux
بدون خادم. تتوفر حزمة SDK ونموذج التعليمات البرمجية في الوقت الحالي في Python فقط، ولكن
تتوفر واجهة برمجة تطبيقات خدمة Google في
بلغات ومنصات أخرى .
استخدام بيئة افتراضية في Python
لعزل حزمة SDK وتبعياتها من حزم Python للنظام.
ملاحظة: بالنسبة إلى جهاز Raspberry Pi، افتح
بعد تنفيذ الأوامر من دليل /home/pi
.
(موصى به) للغة Python 3:
sudo apt-get update
sudo apt-get install python3-dev python3-venv # Use python3.4-venv if the package cannot be found.
python3 -m venv env
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate
بالنسبة إلى Python 2.7:
sudo apt-get update
sudo apt-get install python-dev python-virtualenv
virtualenv env --no-site-packages
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate
الحصول على الحزمة
تحتوي حزمة SDK لمساعد Google على كل التعليمات البرمجية المطلوبة للحصول على
يعمل "مساعد Google" على الجهاز، بما في ذلك رمز النموذج.
تثبيت تبعيات نظام الحزمة:
sudo apt-get install portaudio19-dev libffi-dev libssl-dev
استخدام pip
لتثبيت أحدث إصدار من حزمة Python
في البيئة الافتراضية:
python -m pip install --upgrade google-assistant-sdk[samples]
إنشاء بيانات الاعتماد
ثبِّت أداة التفويض أو حدِّثها:
python -m pip install --upgrade google-auth-oauthlib[tool]
يمكنك إنشاء بيانات الاعتماد لتتمكّن من تشغيل نموذج الرمز البرمجي والأدوات. المراجِع
ملف JSON الذي تم تنزيله في
الخطوة ؛
قد تحتاج إلى نسخه على الجهاز يُرجى عدم إعادة تسمية هذا الملف.
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
--save --headless --client-secrets /path/to/ client_secret_client-id .json
من المفترض أن يظهر لك عنوان URL في الوحدة الطرفية:
Please visit this URL to authorize this application: https://...
انسخ عنوان URL والصقه في متصفح (يمكن إجراء ذلك على أي نظام).
ستطلب منك الصفحة تسجيل الدخول إلى حسابك في Google. سجِّل الدخول إلى
حساب Google الذي أنشأ مشروع المطوّر في الفترة السابقة
الخطوة .
ملاحظة: لاستخدام حسابات أخرى، عليك أولاً
إضافة هذه الحسابات
إلى مشروعك على "وحدة تحكُّم المهام" بصفتك مالكًا
بعد الموافقة على طلب الإذن من واجهة برمجة التطبيقات، سيظهر رمز
في المتصفح، مثل " 4/XXXX". انسخ هذا الرمز والصقه في
محطة طرفية:
Enter the authorization code:
إذا تمت عملية التفويض بنجاح، سيظهر لك ردّ مشابه
ما يلي:
credentials saved: /path/to/.config/google-oauthlib-tool/credentials.json
إذا رأيت بدلاً من ذلك الرمز InvalidGrantError
، هذا يعني أنّه تم إدخال رمز غير صالح.
يُرجى إعادة المحاولة مع الحرص على نسخ الرمز بأكمله ولصقه.
ملاحظة: تنشئ أداة التفويض ملف credentials.json
جديدًا في
دليل .config
مخفي على الجهاز. يحتوي هذا الملف على رمز دخول
التي تُستخدَم لطلب واجهة برمجة تطبيقات "مساعد Google"
الخطوة التالية
تشغيل نموذج الرمز
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-07 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-07 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-09-07 (حسب التوقيت العالمي المتفَّق عليه)"]]