Event

رویداد تعامل برنامه چت Google.

برای اطلاع از رویدادهای تعامل، به دریافت و پاسخ به تعاملات با برنامه گپ Google خود مراجعه کنید. برای آشنایی با انواع رویدادها و به عنوان مثال بارهای رویداد، به انواع رویدادهای تعامل برنامه گپ Google مراجعه کنید.

علاوه بر دریافت رویدادها از تعاملات کاربر، برنامه‌های چت می‌توانند رویدادهایی را درباره تغییرات فضاها دریافت کنند، مانند زمانی که یک عضو جدید به یک فضا اضافه می‌شود. برای آشنایی با رویدادهای فضایی، به کار با رویدادها از 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 )

نوع رویداد تعامل. برای جزئیات، به انواع رویدادهای تعامل برنامه گپ Google مراجعه کنید.

eventTime

string ( Timestamp format)

مهر زمانی که نشان دهنده زمان وقوع رویداد تعامل است.

token

string

یک مقدار مخفی که برنامه‌های چت قدیمی می‌توانند از آن برای تأیید اینکه آیا درخواستی از طرف Google است استفاده کنند. گوگل به صورت تصادفی توکن را تولید می کند و ارزش آن ثابت می ماند. می‌توانید توکن را از صفحه پیکربندی Chat API در Google Cloud Console دریافت، لغو یا بازسازی کنید.

برنامه‌های چت مدرن از این فیلد استفاده نمی‌کنند. در پاسخ‌های API و صفحه پیکربندی Chat API وجود ندارد.

threadKey

string

کلید تعریف شده توسط برنامه چت برای رشته مرتبط با رویداد تعامل. برای اطلاعات بیشتر به spaces.messages.thread.threadKey مراجعه کنید.

message

object ( Message )

پیامی که در صورت وجود، رویداد تعامل را آغاز کرد.

user

object ( User )

کاربری که رویداد تعامل را راه اندازی کرد.

space

object ( Space )

فضایی که رویداد تعامل در آن رخ داده است.

action

object ( FormAction )

برای رویدادهای تعامل CARD_CLICKED ، داده‌های عملکرد فرم مربوط به زمانی که کاربر روی کارت یا گفتگو کلیک می‌کند. برای کسب اطلاعات بیشتر، به خواندن ورودی داده‌های فرم توسط کاربران روی کارت‌ها مراجعه کنید.

configCompleteRedirectUrl

string

نشانی وب برنامه Chat باید کاربر را پس از تکمیل مجوز یا جریان پیکربندی خارج از Google Chat به آن هدایت کند. برای اطلاعات بیشتر، به اتصال یک برنامه گپ با سایر خدمات و ابزارها مراجعه کنید.

isDialogEvent

boolean

برای رویدادهای تعامل CARD_CLICKED ، اینکه آیا کاربر با یک گفتگو تعامل داشته است.

dialogEventType

enum ( DialogEventType )

نوع رویداد تعامل گفتگوی دریافت شده.

common

object ( CommonEventObject )

نشان دهنده اطلاعاتی در مورد مشتری کاربر، مانند زبان محلی، برنامه میزبان و پلت فرم است. برای برنامه‌های گپ، CommonEventObject شامل اطلاعاتی است که توسط کاربرانی که با دیالوگ‌ها تعامل دارند، ارسال می‌شود، مانند داده‌های وارد شده در کارت.

CommonEvent Object

نشان دهنده اطلاعاتی در مورد مشتری کاربر، مانند زبان محلی، برنامه میزبان و پلت فرم است. برای برنامه‌های گپ، 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 .

platform

enum ( Platform )

فهرست پلتفرم که نشان‌دهنده پلتفرمی است که رویداد از آنجا شروع می‌شود ( WEB ، IOS ، یا ANDROID ). توسط برنامه های چت پشتیبانی نمی شود.

timeZone

object ( TimeZone )

شناسه منطقه زمانی و افست از زمان هماهنگ جهانی (UTC). فقط برای انواع رویداد CARD_CLICKED و SUBMIT_DIALOG پشتیبانی می شود.

formInputs

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

نقشه ای که حاوی مقادیری است که کاربر در یک ویجت از کارت یا محاوره وارد می کند. کلیدهای نقشه شناسه‌های رشته‌ای هستند که به هر ویجت اختصاص داده می‌شوند و مقادیر ورودی‌های ویجت را نشان می‌دهند.

برای جزئیات، به اطلاعات فرآیند وارد شده توسط کاربران مراجعه کنید.

parameters

map (key: string, value: string)

پارامترهای سفارشی به تابع فراخوانی شده ارسال می شود. هم کلیدها و هم مقادیر باید رشته ای باشند.

invokedFunction

string

نام تابع فراخوانی مرتبط با ویجت. فقط برای برنامه‌های گپ تنظیم شده است.

منطقه زمانی

شناسه منطقه زمانی و افست از زمان هماهنگ جهانی (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 که فقط مقادیر زمان را می پذیرد.

ورودی های رشته ای

پارامتر ورودی برای ویجت های معمولی برای ویجت‌های تک‌مقدار، یک فهرست تک ارزشی است. برای ویجت های چند ارزشی، مانند چک باکس، همه مقادیر ارائه می شوند.

نمایندگی 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 هستند.