REST Resource: phones.agentMessages

المورد: AgentMessage

رسالة مُرسَلة من الوكيل إلى المستخدم

تمثيل JSON 
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "totalPayloadSizeBytes": string,
  "carrier": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
الحقول
name

string

يتم ضبط هذا الحقل من خلال منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات". لا تُدرِجها عند إنشاء رسالة وكيل. يحلّ الحقل "phones/{E.164}/agentMessages/{messageId}"، حيث {E.164} هو رقم هاتف المستخدم بتنسيق E.164 و{messageId} هو رقم تعريف رسالة الوكيل الذي عيّنه الوكيل.
sendTime

string (Timestamp format)

يتم ضبط هذا الحقل من خلال منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات". لا تُدرِجها عند إنشاء رسالة وكيل. يحلّ الحقل الوقت الذي يتم فيه إرسال الرسالة إلى المستخدم.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
contentMessage

object (AgentContentMessage)

محتوى رسالة موظّف الدعم
messageTrafficType

enum (MessageTrafficType)

نوع زيارات الرسالة.
richMessageClassification

object (RichMessageClassification)

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

string (int64 format)

النتائج فقط. إجمالي حجم حمولة الرسالة بالبايت تحسب الحمولة جميع المرفقات في رسالة "خدمات الاتصالات التفاعلية للمؤسسات"، والتي يمكن أن تكون فيديو أو صورًا أو ملف PDF أو غير ذلك، باستثناء نص الرسالة أو الاقتراحات. في الوقت الحالي، تتم تعبئة هذا الحقل فقط لأرقام الهواتف في الولايات المتحدة.
carrier

string

النتائج فقط. معلومات مشغّل شبكة الجوّال التي ينتمي إليها رقم هاتف المستخدم، وفقًا لأنظمة Google الخلفية لخدمات الاتصالات التفاعلية في الوقت الحالي، تتم تعبئة هذا الحقل فقط لأرقام الهواتف في الولايات المتحدة.

حقل الدمج expiration

يمكن أن تكون expiration إحدى القيم التالية فقط:
expireTime

string (Timestamp format)

اختيارية: طابع زمني بالتوقيت العالمي المتفق عليه يحدّد وقت انتهاء صلاحية هذا المرجع. يتم توفير هذه القيمة في الناتج إذا تم ضبطها أو إذا تم ضبط حقل TTL.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
ttl

string (Duration format)

اختيارية: الإدخال فقط تحدّد هذه السمة المدة التي ستكون فيها الرسالة صالحة قبل إبطالها تلقائيًا.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"

AgentContentMessage

محتوى الرسالة المُرسَلة من الوكيل إلى المستخدم

تمثيل JSON 
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
الحقول
suggestions[]

object (Suggestion)

قائمة بالردود والإجراءات المقترَحة التي تظهر كقائمة من شرائح الاقتراحات بعد رسالة الموظف المرتبط. يمكنك إدخال 11 اقتراحًا كحدّ أقصى.

لا تظهر الشرائح إلا عندما تكون رسالة الوكيل المرتبطة بها هي أحدث رسالة في المحادثة (بما في ذلك رسائل الوكيل والمستخدم). يمكن للمستخدم النقر على ردّ مقترَح لإرسال الردّ النصي إلى الموظف أو النقر على إجراء مقترَح لبدء إجراء أصلي على الجهاز. يمكنك إدخال 11 اقتراحًا كحدّ أقصى.
حقل الدمج content يمكن أن يكون محتوى رسالة العميل الافتراضي content أحد الخيارات التالية فقط:
text

string

نص مرمّز بتنسيق UTF-8 الحد الأقصى 3072 حرفًا.
fileName
(deprecated)

string

الاسم الفريد للملف تعرض منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" اسم ملف عندما يحمّل الوكيل ملفًا. تم إيقافها نهائيًا واستبدالها بالخاصية uploadedRbmFile أدناه.
uploadedRbmFile

object (UploadedRbmFile)

يحتوي على معرّفات لملف وصورة مصغّرة تم تحميلهما وعرضهما من خلال خادم "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية".
richCard

object (RichCard)

بطاقة تفاعلية مستقلة
contentInfo

object (ContentInfo)

معلومات حول ملف، بما في ذلك عنوان URL للملف وعنوان URL للصورة المصغّرة للملف

تعرض منصة "RCS للمؤسسات" المحتوى من ذاكرة تخزين مؤقت، ولكن يمكن للموظف المسؤول أن يفرض على المنصة جلب نسخة جديدة من المحتوى وإعادة تحميل ذاكرة التخزين المؤقت.

UploadedRbmFile

رسالة تحتوي على معلومات الملف والصورة المصغّرة

تمثيل JSON 
{
  "fileName": string,
  "thumbnailName": string
}
الحقول
fileName

string

اسم الملف الذي تعرضه منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" عند تحميل الملف
thumbnailName

string

اسم الصورة المصغّرة الذي تعرضه منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" عند تحميل الصورة المصغّرة

RichCard

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

تمثيل JSON 
{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}
الحقول
حقل الدمج card بطاقة مستقلة أو لوحة عرض دوّارة لبطاقات يمكن أن تكون card إحدى القيم التالية فقط:
carouselCard

object (CarouselCard)

لوحة عرض دوّارة للبطاقات
standaloneCard

object (StandaloneCard)

بطاقة مستقلة

CarouselCard

لوحة عرض دوّارة للبطاقات

تمثيل JSON 
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
الحقول
cardWidth

enum (CarouselCard.CardWidth)

تمثّل هذه السمة عرض البطاقات في لوحة العرض الدوّارة.
cardContents[]

object (CardContent)

قائمة المحتوى لكل بطاقة في لوحة العرض الدوّارة. يمكن أن يحتوي دوّار العرض على بطاقتَين كحدّ أدنى و10 بطاقات كحدّ أقصى.

CarouselCard.CardWidth

تمثّل هذه السمة عرض البطاقات في لوحة العرض الدوّارة.

عمليات التعداد
CARD_WIDTH_UNSPECIFIED لم يتم تحديد أي قيمة.
SMALL ‫120 وحدة بكسل مستقلة الكثافة يُرجى العِلم أنّه لا يمكن استخدام الوسائط الطويلة.
MEDIUM ‫232 وحدة بكسل مستقلة الكثافة

CardContent

محتوى البطاقة

تمثيل JSON 
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
الحقول
title

string

(اختياري) عنوان البطاقة الحد الأقصى 200 حرف
description

string

(اختياري) وصف البطاقة يمكن استخدام 2000 حرف كحدّ أقصى.
media

object (Media)

(اختياري) الوسائط (صورة أو صورة GIF أو فيديو أو ملف PDF) التي سيتم تضمينها في البطاقة
suggestions[]

object (Suggestion)

(اختياري) قائمة بالاقتراحات التي سيتم تضمينها في البطاقة. يمكنك إضافة 4 اقتراحات كحدّ أقصى.

الوسائط

ملف وسائط ضمن بطاقة تفاعلية

تمثيل JSON 
{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
الحقول
height

enum (Media.Height)

تمثّل هذه السمة ارتفاع الوسائط ضمن بطاقة تفاعلية بتنسيق عمودي. بالنسبة إلى البطاقة المستقلة ذات التنسيق الأفقي، لا يمكن تخصيص الارتفاع، وسيتم تجاهل هذا الحقل.
حقل الدمج content يمكن أن يكون محتوى الوسائط content أحد الخيارات التالية فقط:
fileName
(deprecated)

string

الاسم الفريد للملف، والذي تعرضه منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" عند تحميل الملف تم إيقافها نهائيًا واستبدالها بالخاصية uploadedRbmFile أدناه.
uploadedRbmFile

object (UploadedRbmFile)

يحتوي على معرّفات لملف وصورة مصغّرة تم تحميلهما وعرضهما من خلال خادم "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية".
contentInfo

object (ContentInfo)

معلومات عن ملف، بما في ذلك عنوان URL للملف وعنوان URL للصورة المصغّرة للملف

تعرض منصة "RCS للمؤسسات" المحتوى من ذاكرة تخزين مؤقت، ولكن يمكن للموظف المسؤول أن يفرض على المنصة جلب نسخة جديدة من المحتوى وإعادة تحميل ذاكرة التخزين المؤقت.

ContentInfo

رسالة تحتوي على معلومات المحتوى

تمثيل JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
الحقول
fileUrl

string

عنوان URL للملف يمكن الوصول إليه بشكل علني تحدّد منصة "خدمات الاتصالات التفاعلية للأنشطة التجارية" نوع MIME للملف من حقل "نوع المحتوى" في عناوين HTTP عندما تسترد المنصة الملف. يجب أن يكون حقل نوع المحتوى متوفّرًا ودقيقًا في استجابة HTTP من عنوان URL. ننصح بأن يكون الحدّ الأقصى لحجم الملف 100 ميغابايت.

ملاحظة: لا تتوفّر عمليات إعادة التوجيه في عناوين URL للملفات. يُرجى استخدام CreateFileRequest إذا كانت هناك حاجة إلى إعادة التوجيه.
thumbnailUrl

string

(اختيارية، لملفات الصور والصوت والفيديو فقط) عنوان URL للصورة المصغّرة يمكن الوصول إليه بشكل علني. الحدّ الأقصى للحجم هو 100 كيلوبايت.

في حال عدم تقديم عنوان URL للصورة المصغّرة، تعرض منصة "خدمات RCS للأنشطة التجارية" صورة مصغّرة فارغة إلى أن ينزّل جهاز المستخدم الملف. استنادًا إلى إعدادات المستخدم، قد لا يتم تنزيل الملف تلقائيًا وقد يتطلّب ذلك من المستخدم النقر على زر التنزيل.

ملاحظة: لا تتوفّر عمليات إعادة التوجيه في عناوين URL للملفات. يُرجى استخدام CreateFileRequest إذا كانت هناك حاجة إلى إعادة التوجيه.
forceRefresh

boolean

في حال ضبط هذه السمة، تسترد منصة "RCS للأعمال" الملف والصورة المصغّرة من عناوين URL المحدّدة، حتى إذا كانت المنصة تحتفظ بنسخ مخزّنة مؤقتًا من الملف (أو الصورة المصغّرة).

Media.Height

ارتفاع الوسائط

عمليات التعداد
HEIGHT_UNSPECIFIED لم يتم تحديد أي قيمة.
SHORT ‫112 وحدة بكسل مستقلة الكثافة
MEDIUM ‫168 وحدة بكسل مستقلة الكثافة
TALL ‫264 وحدة بكسل مستقلة الكثافة لا تتوفّر هذه الميزة في لوحات عرض دوّارة للبطاقات التفاعلية عندما يتم ضبط عرض البطاقة على "صغير".

اقتراح

ردّ مقترَح أو إجراء مقترَح مضمّن في بطاقة تفاعلية أو في قائمة شرائح اقتراحات

تمثيل JSON 
{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}
الحقول
حقل الدمج option ردّ مقترَح أو إجراء مقترَح يمكن أن تكون option إحدى القيم التالية فقط:
reply

object (SuggestedReply)

يمكن للمستخدمين النقر على ردّ مقترَح لإرسال الردّ النصي إلى الموظف.
action

object (SuggestedAction)

يمكن للمستخدمين النقر على إجراء مقترَح لبدء الإجراء الأصلي المقابل على الجهاز.

SuggestedReply

عند النقر عليه، يتم إرسال الرد النصي إلى الوكيل.

تمثيل JSON 
{
  "text": string,
  "postbackData": string
}
الحقول
text

string

النص الذي يظهر في الردّ المقترَح ويتم إرساله إلى الموظف عند نقر المستخدم عليه. يمكن استخدام 25 حرفًا كحدّ أقصى.
postbackData

string

الحمولة بترميز base64 التي يتلقّاها الوكيل في حدث مستخدم عندما ينقر المستخدم على الردّ المقترَح.

SuggestedAction

عند النقر عليه، يتم بدء الإجراء الأصلي المقابل على الجهاز.

تمثيل JSON 
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}
الحقول
text

string

النص الذي يظهر في الإجراء المقترَح يمكن استخدام 25 حرفًا كحدّ أقصى.
postbackData

string

الحمولة (ترميز base64) التي سيتم إرسالها إلى الوكيل في حدث المستخدم الذي ينتج عندما ينقر المستخدم على الإجراء المقترَح. الحد الأقصى لعدد الأحرف هو 2048 حرفًا.
fallbackUrl

string

(اختياري) عنوان URL احتياطي لاستخدامه إذا كان أحد العملاء لا يتيح إجراءً مقترَحًا. تُفتح عناوين URL الاحتياطية في نوافذ متصفّح جديدة. يجب أن يكون معرّف موارد منتظمًا صالحًا وفقًا للمعيار RFC 3986. الحد الأقصى لعدد الأحرف هو 2048 حرفًا.
حقل الدمج action الإجراء الأصلي الذي تم تنفيذه على الجهاز عندما ينقر المستخدم على الإجراء المقترَح يمكن أن تكون action إحدى القيم التالية فقط:
dialAction

object (DialAction)

يفتح تطبيق الاتصال التلقائي للمستخدم مع ملء رقم الهاتف الذي حدّده الموظف.
viewLocationAction

object (ViewLocationAction)

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

object (CreateCalendarEventAction)

يفتح تطبيق التقويم التلقائي للمستخدم ويبدأ مسار حدث التقويم الجديد مع ملء بيانات الحدث المحدّدة من قِبل الوكيل مسبقًا.
openUrlAction

object (OpenUrlAction)

يفتح تطبيق متصفّح الويب التلقائي للمستخدم على عنوان URL المحدّد. إذا كان لدى المستخدم تطبيق مثبَّت تم تسجيله كمعالج تلقائي لعنوان URL، سيتم فتح هذا التطبيق بدلاً من ذلك، وسيتم استخدام رمزه في واجهة المستخدم للإجراء المقترَح.
shareLocationAction

object (ShareLocationAction)

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

DialAction

يفتح تطبيق الاتصال التلقائي للمستخدم مع ملء رقم الهاتف الذي حدّده الموظف.

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

string

رقم الهاتف بتنسيق E.164، على سبيل المثال ‎+12223334444

ViewLocationAction

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

تمثيل JSON 
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
الحقول
latLong

object (LatLng)

(اختياري) تمثّل هذه السمة خط العرض وخط الطول للموقع الجغرافي المحدّد.
label

string

(اختياري) تصنيف الدبوس الذي تم وضعه في latLong
query

string

(اختياري، متاح فقط على عملاء "رسائل Google") بدلاً من تحديد latLong (ويمكنك اختياريًا تحديد تصنيف)، يمكن للوكيل تحديد سلسلة طلب بحث. بالنسبة إلى تطبيقات الخرائط التلقائية التي تتيح وظيفة البحث (بما في ذلك "خرائط Google")، يؤدي النقر على هذا الإجراء المقترَح إلى إجراء بحث عن موقع جغرافي يركّز على الموقع الجغرافي الحالي للمستخدم. إذا كان طلب البحث محدّدًا بشكل كافٍ، يمكن للوكلاء استخدامه لاختيار أي موقع جغرافي في العالم.

على سبيل المثال، سيؤدي ضبط سلسلة طلب البحث على "Growing Tree Bank" إلى عرض جميع مواقع Growing Tree Bank القريبة من المستخدم. سيؤدي ضبط سلسلة طلب البحث على "1600 Amphitheater Parkway, Mountain View, CA 94043" إلى اختيار هذا العنوان المحدّد، بغض النظر عن الموقع الجغرافي للمستخدم.

LatLng

كائن يمثّل زوج خط العرض/خط الطول. يتم التعبير عن ذلك كزوج من الأرقام المضاعفة لتمثيل درجات خط العرض ودرجات خط الطول. ما لم يُذكر خلاف ذلك، يجب أن يتوافق هذا العنصر مع معيار WGS84. يجب أن تكون القيم ضمن النطاقات العادية.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

number

تمثّل هذه السمة خط الطول بالدرجات. يجب أن تكون القيمة ضمن النطاق [-180.0, +180.0].

CreateCalendarEventAction

يفتح تطبيق التقويم التلقائي للمستخدم ويبدأ مسار حدث التقويم الجديد مع ملء بيانات الحدث المحدّدة من قِبل الوكيل مسبقًا.

تمثيل JSON 
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
الحقول
startTime

string (Timestamp format)

وقت بدء الحدث

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

تمثّل هذه السمة وقت انتهاء الحدث.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
title

string

تمثّل هذه السمة عنوان الحدث. الحد الأقصى لعدد الأحرف هو 100 حرف.
description

string

وصف الحدث ‫500 حرف كحدّ أقصى

OpenUrlAction

يفتح تطبيق متصفّح الويب التلقائي للمستخدم على عنوان URL المحدّد. إذا كان لدى المستخدم تطبيق مثبَّت تم تسجيله كمعالج تلقائي لعنوان URL، سيتم فتح هذا التطبيق بدلاً من ذلك، وسيتم استخدام رمزه في واجهة المستخدم للإجراء المقترَح.

تمثيل JSON 
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
الحقول
url

string

عنوان URL المطلوب فتحه اعتبارًا من 1 تشرين الثاني (نوفمبر) 2025، يجب أن يكون مخطط عنوان URL هو https:// ‎ أو http://‎. سيتم رفض طلبات واجهة برمجة التطبيقات التي تستخدم أي مخططات أخرى (مثل tel: أو mailto: أو sms:) مع ظهور الخطأ 400 Bad Request بعد هذا التاريخ. يجب أن يكون عنوان URL معرّف موارد منتظم (URI) صالحًا وفقًا للمعيار RFC 3986. الحد الأقصى لعدد الأحرف هو 2048 حرفًا.
application

enum (OpenUrlApplication)

تطبيق أو متصفّح أو WebView لفتح عناوين URL للتحقّق ممّا إذا كان جهاز المستخدم يتيح وضع العرض على الويب، عليك إجراء فحص للتأكّد من توفّر الإمكانية أولاً. يمكنك الاطّلاع على المستندات للحصول على التفاصيل: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities.
webviewViewMode

enum (WebviewViewMode)

وضع العرض الخاص بـ WebView
description

string

وصف تسهيل الاستخدام الخاص بعرض الويب

OpenUrlApplication

نوع التطبيق الذي يفتح عنوان URL

عمليات التعداد
OPEN_URL_APPLICATION_UNSPECIFIED لم يتم تحديد أي خيار، وسيتم استخدام المتصفّح لفتح الملف.
BROWSER استخدِم المتصفّح لفتح عنوان URL.
WEBVIEW فتح عنوان URL في نافذة عرض ويب مدمجة

WebviewViewMode

نوع وضع عرض WebView.

عمليات التعداد
WEBVIEW_VIEW_MODE_UNSPECIFIED لم يتم تحديد أي قيمة. لاستخدام webview، يجب تحديد وضع العرض.
FULL يجب أن يتطلّب ذلك عرض محادثة روبوت الدردشة بملء الشاشة مع وضع تصنيف لها في شريط الحالة.
HALF يتطلّب ذلك استخدام تراكب على نصف الشاشة.
TALL يتطلّب ذلك تراكبًا على ثلاثة أرباع الشاشة.

ShareLocationAction

لا يتضمّن هذا النوع أي حقول.

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

StandaloneCard

بطاقة مستقلة

تمثيل JSON 
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
الحقول
cardOrientation

enum (StandaloneCard.CardOrientation)

اتجاه البطاقة
thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

محاذاة معاينة الصور للبطاقات المستقلة ذات التصميم الأفقي
cardContent

object (CardContent)

محتوى البطاقة

StandaloneCard.CardOrientation

اتجاه البطاقة

عمليات التعداد
CARD_ORIENTATION_UNSPECIFIED لم يتم تحديد أي قيمة.
HORIZONTAL

تنسيق أفقي

إذا كان object(CardContent) في بطاقة تفاعلية أفقية يحتوي على الحقل media، يجب أن يتضمّن أيضًا الحقل title أو description أو suggestions[] على الأقل.
VERTICAL تخطيط عمودي

StandaloneCard.ThumbnailImageAlignment

محاذاة معاينة الصور للبطاقات المستقلة ذات التصميم الأفقي

عمليات التعداد
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED لم يتم تحديد أي قيمة.
LEFT تتم محاذاة معاينة الملف إلى اليمين.
RIGHT تتم محاذاة معاينة الملف إلى اليسار.

MessageTrafficType

أنواع زيارات الرسائل المتوافقة سيتم توسيع التعداد لدعم أنواع زيارات إضافية.

عمليات التعداد
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED السلوك التلقائي: يتم تحديد نوع عدد زيارات الرسائل حسب حالة استخدام الوكيل. عدِّل نوع الزيارات حسب الحاجة استنادًا إلى محتوى الرسالة. بالنسبة إلى الوكلاء متعدّدي الاستخدام، لا يتم توفير أي إعداد تلقائي. يجب ضبط نوع الزيارات يدويًا (مثلاً، المعاملات والعروض الترويجية).
AUTHENTICATION لرسائل المصادقة في حالة استخدام وكيل كلمة المرور لمرة واحدة.
TRANSACTION بالنسبة إلى رسائل المعاملات في حالات استخدام "الوكيل" للمعاملات أو الاستخدام المتعدّد
PROMOTION لرسائل العروض الترويجية في حالات استخدام "الوكيل الترويجي" أو "الوكيل المتعدّد الاستخدامات"
SERVICEREQUEST بالنسبة إلى الرسائل المتعلقة بالخدمات التي وافق المستخدم على تلقّيها تُستخدم في حالات استخدام الوكيل لرموز المرور لمرة واحدة أو المعاملات أو العروض الترويجية أو الاستخدامات المتعددة.
ACKNOWLEDGEMENT بالنسبة إلى الرسائل التي تقرّ باستلام طلب إلغاء الاشتراك من المستخدم تُستخدم في حالات استخدام الوكيل لرموز المرور لمرة واحدة أو المعاملات أو العروض الترويجية أو الاستخدامات المتعددة.

RichMessageClassification

للفوترة في الولايات المتحدة فقط: تفاصيل حول تصنيفات الرسائل المستخدَمة في الفوترة

تمثيل JSON 
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
الحقول
classificationType

enum (RichMessageClassificationType)
segmentCount

integer

عدد الأقسام التي تبلغ سعتها 160 بايت لنص الرسالة، ويتم التقريب دائمًا إلى أقرب عدد صحيح.

يتم احتسابها من إجمالي طول بايت UTF-8 لمحتوى النص فقط، ويتم استبعاد البيانات من الردود أو الإجراءات المقترَحة.

على سبيل المثال، تحتوي رسالة نصية يبلغ طولها 300 بايت على segmentCount بقيمة 2.

تتم تعبئة هذا الحقل لأنواع RICH_MESSAGE فقط.

RichMessageClassificationType

للفوترة في الولايات المتحدة فقط: تحدّد هذه السمة تصنيف الرسالة لأغراض الفوترة.

ملاحظة مُهمّة: يحدّد مشغّلو شبكة الجوّال في الولايات المتحدة سعر أنواع الرسائل القابلة للفوترة الموضّحة في هذه الصفحة. يحدّد مشغّلو شبكات الجوّال في الولايات المتحدة أيضًا الرسوم النهائية التي يدفعها المطوّر مقابل إرسال رسائل "خدمات الاتصالات التفاعلية (RCS) للمؤسسات". للحصول على معلومات إضافية حول الأسعار أو الفوترة، يُرجى التواصل مع ممثلي مشغّل شبكة الجوّال المعنيين.

عمليات التعداد
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED غير محددة
RICH_MESSAGE يتم تصنيف الرسالة على أنّها RICH في الحالات التالية: 1. لا يحتوي على بطاقات تفاعلية. 2. لا يحتوي على مرفقات ملفات. 3- يجب أن تكون أي إجراءات مقترَحة يتضمّنها إما إجراء "الاتصال" أو إجراء "فتح عنوان URL" لا يستخدم WebView.
RICH_MEDIA_MESSAGE أي رسالة لا تستوفي معايير RICH_MESSAGE. ويشمل ذلك الرسائل التي تحتوي على بطاقة تفاعلية أو ملف وسائط أو أي إجراء مقترَح آخر غير "الاتصال" أو "فتح عنوان URL في المتصفّح".
SUGGESTED_ACTION_CLICK تمثّل هذه السمة نقرة المستخدم على إجراء مقترَح (وليس ردًا مقترَحًا). لا ينطبق هذا التصنيف إلا على إجراءات المستخدمين ويظهر حصريًا في حمولة UserMessage الخاصة بخطاف الويب. ولا ينطبق ذلك على الرسائل من التطبيقات إلى الأشخاص.

الطُرق

create

 يرسل رسالة من الوكيل إلى المستخدم.

delete

 تلغي هذه الطريقة رسالة من وكيل تم إرسالها ولكن لم يتم تسليمها بعد.