Event

حدث تفاعل مع تطبيق Google Chat يمثّل بيانات عن تفاعل المستخدم مع تطبيق Chat ويتضمّن بيانات حول ذلك لضبط تطبيقك في Chat لتلقّي أحداث التفاعل، يُرجى الاطّلاع على مقالة تلقّي تفاعلات المستخدمين والردّ عليها.

بالإضافة إلى تلقّي أحداث ناتجة من تفاعلات المستخدمين، يمكن لتطبيقات Chat تلقّي أحداث حول التغييرات في المساحات، مثل إضافة عضو جديد إلى مساحة. للتعرّف على أحداث المساحة، يُرجى الاطّلاع على مقالة التعامل مع الأحداث من Google Chat.

تمثيل JSON
{
  "type": enum (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  }
}
الحقول
type

enum (EventType)

نوع تفاعل المستخدم مع تطبيق Chat، مثلاً MESSAGE أو ADDED_TO_SPACE.

eventTime

string (Timestamp format)

الطابع الزمني الذي يشير إلى وقت وقوع الحدث التفاعلي.

token

string

قيمة سرية يمكن لتطبيقات Chat القديمة استخدامها للتحقّق مما إذا كان الطلب من Google. تنشئ Google الرمز المميز بشكل عشوائي، وتظل قيمته ثابتة. يمكنك الحصول على الرمز المميّز أو إبطاله أو إعادة إنشائه من صفحة ضبط واجهة Chat API في Google Cloud Console.

لا تستخدِم تطبيقات Chat الحديثة هذا الحقل. ولا تتوفّر هذه الميزة في الردود من واجهة برمجة التطبيقات وصفحة ضبط واجهة Chat API.

threadKey

string

المفتاح المحدّد من خلال تطبيق في Chat لسلسلة المحادثات المرتبطة بحدث التفاعل يمكنك الانتقال إلى spaces.messages.thread.threadKey للاطّلاع على مزيد من المعلومات.

message

object (Message)

بالنسبة إلى أحداث التفاعل ADDED_TO_SPACE وCARD_CLICKED وMESSAGE، الرسالة التي أدّت إلى حدث التفاعل، إذا كان ذلك منطبقًا.

user

object (User)

المستخدِم الذي تفاعل مع تطبيق Chat.

space

object (Space)

المساحة التي تفاعل فيها المستخدم مع تطبيق Chat.

action

object (FormAction)

بالنسبة إلى أحداث تفاعل CARD_CLICKED، بيانات إجراءات النموذج المرتبطة عندما ينقر المستخدم على بطاقة أو مربّع حوار. لمزيد من المعلومات، اطّلِع على قراءة إدخالات بيانات النموذج التي أجراها المستخدمون على البطاقات.

configCompleteRedirectUrl

string

بالنسبة إلى أحداث تفاعل "MESSAGE"، يجب إعادة توجيه المستخدمين إلى عنوان URL بعد إكمال عملية التفويض أو الضبط خارج Google Chat. لمزيد من المعلومات، يُرجى الاطّلاع على ربط تطبيق Chat بخدمات وأدوات أخرى.

isDialogEvent

boolean

بالنسبة إلى أحداث التفاعل بين CARD_CLICKED وMESSAGE، سواء كان المستخدم يتفاعل مع مربع حوار أو على وشك التفاعل معه.

dialogEventType

enum (DialogEventType)

نوع حدث التفاعل المربّع الذي تم تلقّيه.

common

object (CommonEventObject)

يمثل ذلك معلومات عن عميل المستخدم، مثل اللغة والتطبيق المضيف والنظام الأساسي. بالنسبة إلى تطبيقات Chat، يتضمن CommonEventObject المعلومات التي يرسلها المستخدمون يتفاعلون مع مربعات الحوار، مثل البيانات التي يتم إدخالها في البطاقة.

CommonEventObject

يمثل ذلك معلومات عن عميل المستخدم، مثل اللغة والتطبيق المضيف والنظام الأساسي. بالنسبة إلى تطبيقات Chat، يتضمن CommonEventObject البيانات التي يرسلها المستخدمون الذين يتفاعلون مع البطاقات، مثل البيانات التي يتم إدخالها في مربعات الحوار.

تمثيل JSON
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
الحقول
userLocale

string

تمثّل هذه السمة locale.displayName الكاملة بتنسيق [رمز اللغة ISO 639]-[رمز البلد/المنطقة ISO 3166]، مثل en-US.

hostApp

enum (HostApp)

تعداد HostApp الذي يشير إلى التطبيق الذي تم استدعاء الإضافة منه CHAT دائمًا لتطبيقات Chat.

platform

enum (Platform)

تعداد المنصة الذي يشير إلى المنصّة التي نشأ منها الحدث (WEB أو IOS أو ANDROID) لا يتيح هذا الإعداد تطبيقات Chat.

timeZone

object (TimeZone)

رقم تعريف المنطقة الزمنية والمعادلة من التوقيت العالمي المنسَّق (UTC). لا تتوفّر هذه السمة إلا لنوعَي الحدث CARD_CLICKED وSUBMIT_DIALOG.

formInputs

map (key: string, value: object (Inputs))

خريطة تحتوي على القيم التي يُدخلها المستخدم في أداة من بطاقة أو مربّع حوار مفاتيح الخريطة هي أرقام تعريف السلاسل المخصصة لكل تطبيق مصغّر، وتمثل القيم مدخلات إلى التطبيق المصغّر.

لمعرفة التفاصيل، يمكنك الاطّلاع على معلومات العملية التي أدخلها المستخدمون.

parameters

map (key: string, value: string)

تم تمرير المَعلمات المخصَّصة إلى الدالة التي تم استدعاؤها. يجب أن تكون كل من المفاتيح والقيم سلاسل.

invokedFunction

string

اسم الدالة التي تم استدعاؤها والمرتبطة بالأداة. يتم ضبط هذا الإعداد لتطبيقات Chat فقط.

TimeZone

رقم تعريف المنطقة الزمنية والمعادلة من التوقيت العالمي المنسَّق (UTC). لا تتوفّر هذه السمة إلا لنوعَي الحدث CARD_CLICKED وSUBMIT_DIALOG.

تمثيل JSON
{
  "id": string,
  "offset": integer
}
الحقول
id

string

رمز قاعدة بيانات المنطقة الزمنية IANA TZ، مثل "America/Toronto"

offset

integer

معادلة المنطقة الزمنية للمستخدم بالمللي ثانية من التوقيت العالمي المنسَّق (UTC)

مدخلات

أنواع البيانات التي يمكن للمستخدمين إدخالها في البطاقات أو مربّعات الحوار يعتمد نوع الإدخال على نوع القيم التي تقبلها الأداة.

تمثيل JSON
{

  // Union field inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
الحقول

حقل الاتحاد inputs.

يمكن أن يكون inputs واحدًا فقط مما يلي:

stringInputs

object (StringInputs)

قائمة بالسلاسل التي تمثّل القيم التي يُدخلها المستخدم في الأداة.

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

dateTimeInput

object (DateTimeInput)

قيم إدخال التاريخ والوقت من تطبيق DateTimePicker المصغّر الذي يقبل التاريخ والوقت

dateInput

object (DateInput)

قيم التاريخ الذي يتم إدخاله من تطبيق DateTimePicker المصغّر الذي لا يقبل سوى قيم التاريخ

timeInput

object (TimeInput)

قيم إدخال الوقت من تطبيق DateTimePicker المصغّر الذي لا يقبل سوى قيم الوقت

StringInputs

معلمة الإدخال للتطبيقات المصغّرة العادية. أما بالنسبة إلى التطبيقات المصغّرة ذات القيمة الواحدة، فهي عبارة عن قائمة قيمة واحدة. بالنسبة إلى التطبيقات المصغّرة متعددة القيم، مثل مربّع الاختيار، يتم عرض جميع القيم.

تمثيل JSON
{
  "value": [
    string
  ]
}
الحقول
value[]

string

قائمة بالسلاسل التي أدخلها المستخدم.

DateTimeInput

قيم إدخال التاريخ والوقت

تمثيل JSON
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
الحقول
msSinceEpoch

string (int64 format)

الوقت منذ وقت الحقبة بالمللي ثانية

hasDate

boolean

ما إذا كان الإدخال datetime يتضمّن تاريخًا في التقويم.

hasTime

boolean

ما إذا كان الإدخال datetime يتضمّن طابعًا زمنيًا.

DateInput

قيم إدخال التاريخ

تمثيل JSON
{
  "msSinceEpoch": string
}
الحقول
msSinceEpoch

string (int64 format)

الوقت منذ وقت الحقبة بالمللي ثانية

TimeInput

قيم إدخال الوقت

تمثيل JSON
{
  "hours": integer,
  "minutes": integer
}
الحقول
hours

integer

الساعة بنظام 24 ساعة.

minutes

integer

عدد الدقائق بعد الساعة. القيم الصالحة هي من 0 إلى 59.