المشاركة مع "مساعد Google"

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

يمكن لمستخدمي هواتف Android أن يطلبوا من "مساعد Google" مشاركة محتوى التطبيق مع مستخدم آخر باستخدام طلب صوتي مثل "Ok Google، أريد إرسال هذا إلى سالي" مقرها في خيارات النظام لدى المستخدم الأول، يستطيع "مساعد Google" بعد ذلك دمج نص من الشاشة أو لقطة شاشة للجهاز في المحتوى المشترَك.

غالبًا ما تكون طريقة المشاركة هذه كافية، ولكن قد لا يعيد المستخدمون الذين يتلقّون محتوى مشترَكًا من تطبيقك الدخول إلى التطبيق لعرض المحتوى. يمكنك تقديم "مساعد Google" يتضمّن معلومات منظَّمة عن المحتوى الحالي الذي تعمل في المقدّمة من خلال تنفيذ طريقة onProvideAssistContent().

تساعد هذه العملية في الحفاظ على هيكل البيانات حيث تتم مشاركتها مع المستخدم. ويمكن بعد ذلك للمستخدمين الذين يتلقون محتوى التطبيق المشترك الربط بصفحة معيّنة أو تلقّيها المحتوى مباشرةً، بدلاً من عرضه كنص أو لقطة شاشة.

تنفيذ onProvideAssistContent() لأي عنصر قابل للمشاركة entity في تطبيقك

تقديم المحتوى إلى "مساعد Google"

ما عليك سوى تنفيذ onProvideAssistContent() للنشاط النهائي للتطبيق في تسلسل مهام المستخدم بعد استدعاء "إجراء التطبيق". على سبيل المثال، في مسار GET_ITEM_LIST، نفِّذ الطريقة في الشاشة النهائية التي تعرض قائمة السلع، ولا تحتاج إلى تنفيذها لأي شاشات قيد التقدّم أو شاشات معاينة.

قدِّم المعلومات السياقية كعنصر JSON-LD باستخدام مفردات schema.org في حقل structuredData من AssistContent. يعرض مقتطف الرمز التالي مثال على تسجيل المحتوى السياقي:

override fun onProvideAssistContent(outContent: AssistContent) {
    super.onProvideAssistContent(outContent)

    // JSON-LD object based on Schema.org structured data
    outContent.structuredData = JSONObject()
            .put("@type", "ItemList")
            .put("name", "My Work items")
            .put("url", "https://my-notes-and-lists.com/lists/12345a")
            .toString()
}
      

@Override
public void onProvideAssistContent(AssistContent outContent) {
  super.onProvideAssistContent(outContent);

  // JSON-LD object based on Schema.org structured data
  outContent.structuredData = new JSONObject()
          .put("@type", "ItemList")
          .put("name", "My Work items")
          .put("url", "https://my-notes-and-lists.com/lists/12345a")
          .toString();
}
      

يُرجى تقديم أكبر قدر ممكن من البيانات حول كل entity. يجب ملء الحقول التالية:

• @type
• .name
• .url (مطلوب فقط إذا كان المحتوى قابلاً للوصول إليه من خلال عنوان URL)

لمزيد من المعلومات حول استخدام onProvideAssistContent()، اطّلِع على دليل تحسين المحتوى السياقي لتطبيق "مساعد Google".