تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
أفضل الممارسات بشأن الخصوصية والأمان
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في ما يلي بعض إرشادات الأمان والخصوصية للمطوّرين الذين يستخدمون Google Assistant API في مشاريعهم.
واجهة برمجة التطبيقات وتفويض التطبيق
يجب أن يحصل أي تطبيق يستخدم Google Assistant API على بيانات اعتماد
تفويض تحدّد التطبيق لخادم مصادقة Google.
ويتم عادةً تخزين بيانات الاعتماد هذه في ملف client_secret_<client-id>.json تم تنزيله. احرص على تخزين هذا الملف في مكان لا يمكن
لتطبيق سوى الوصول إليه.
قد يطلب تطبيقك من المستخدم منحه إذن الوصول إلى حسابه على Google.
في حال منحه الإذن، يمكن أن يطلب تطبيقك رمز الدخول المميّز لهذا المستخدم. تنتهي صلاحية هذه الرموز المميّزة، ولكن يمكن تحديثها.
تشكّل الرموز المميّزة لإعادة التحميل غير المحمية على الجهاز خطرًا أمنيًا كبيرًا. تأكَّد من أنّ التطبيق:
- تخزين الرموز المميّزة لإعادة التحميل في مكان آمن
- توفِّر طريقة سهلة لمحو الرموز المميّزة من الجهاز. على سبيل المثال، قدِّم زر "تسجيل الخروج" الذي يمحو الرمز المميّز (إذا كان التطبيق يحتوي على واجهة مستخدم) أو نص برمجي لسطر أوامر يمكن للمستخدم تنفيذه.
- يتم إبلاغ المستخدمين بأنّه يمكنهم إلغاء تفويض الوصول إلى حساباتهم على Google. يؤدي هذا إلى إبطال الرمز المميز للتحديث، ولاستخدام التطبيق مرة أخرى، سيحتاج المستخدم إلى إعادة تفويض الوصول.
وعند الانتهاء من استخدام الجهاز بشكل نهائي، يجب محو
جميع الرموز المميّزة منه.
لمزيد من المعلومات، يُرجى الاطّلاع على استخدام OAuth 2.0 للوصول إلى Google APIs.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eApplications using the Google Assistant API require authorization credentials, typically stored in a \u003ccode\u003eclient_secret_<client-id>.json\u003c/code\u003e file, which should be kept secure.\u003c/p\u003e\n"],["\u003cp\u003eUser granted access allows applications to request access tokens that expire but can be refreshed; however, unprotected refresh tokens pose a security risk and should be stored securely with options for users to clear them.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should inform users about the ability to deauthorize access to their Google account through Google's permissions page, which revokes the refresh token and requires re-authorization for further application use.\u003c/p\u003e\n"]]],["Applications using the Google Assistant API require authorization credentials, typically stored in a `client_secret` file, which should be securely stored. Applications may obtain user-specific access tokens, which can be refreshed. Refresh tokens must be securely stored, and applications should allow users to clear them, such as through a \"Sign out\" feature or a command line. Users should be informed that they can deauthorize application access, and all tokens should be cleared when a device is no longer used.\n"],null,["# Best Practices for Privacy and Security\n\nHere are some security and privacy guidelines for developers using the Google\nAssistant API in their projects.\n\nAPI and application authorization\n---------------------------------\n\nAny application that uses the Google Assistant API must have authorization\ncredentials that identify the application to Google's authentication server.\nTypically, these credentials are stored in a downloaded `client_secret_\u003cclient-id\u003e.json`\nfile. Make sure to store this file in a location that only your application\ncan access.\n\nYour application may prompt the user to grant it access to their Google account.\nIf granted, your application can request an access token for that user. These\ntokens expire, but can be refreshed.\n\nUnprotected refresh tokens on a device pose a significant security risk. Make\nsure your application:\n\n- Stores the refresh tokens in a secure place.\n- Provides an easy way to clear tokens from the device. For example, provide a \"Sign out\" button that clears a token (if the application has a UI) or a command line script that the user can execute.\n- Informs users that they can [deauthorize access](https://myaccount.google.com/permissions) to their Google account. This revokes the refresh token; to use the application again, the user would need to re-authorize access.\n\nWhen you are done using the device permanently, you should clear all of the\ntokens from it.\n\nFor more information, see [Using OAuth 2.0 to Access Google APIs](https://developers.google.com/identity/protocols/OAuth2)."]]
