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 for Business. لا تُدرِجها عند إنشاء رسالة وكيل. يحلّ الحقل "phones/{E.164}/agentMessages/{messageId}"، حيث {E.164} هو رقم هاتف المستخدم بتنسيق E.164 و{messageId} هو رقم تعريف رسالة الوكيل الذي عيّنه الوكيل.
sendTime

string (Timestamp format)

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

يستخدم المعيار 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)

النتائج فقط. الحجم الإجمالي لحمولة الرسالة بالبايت تحسب الحمولة جميع المرفقات في رسالة RCS للأنشطة التجارية، والتي يمكن أن تكون فيديو أو صورًا أو ملف 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 اقتراحًا كحدّ أقصى.

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

هناك نوعان من أنماط الاقتراحات: دائمة ومؤقتة. لمزيد من التفاصيل، يُرجى الاطّلاع على الاقتراحات.
حقل الربط content يمكن أن يكون محتوى رسالة العميل الافتراضي content إحدى القيم التالية فقط:
text

string

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

string

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

object (UploadedRbmFile)

يحتوي على معرّفات لملف وصورة مصغّرة تم تحميلهما إلى خادم RCS for Business وعرضهما من خلاله.
richCard

object (RichCard)

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

object (ContentInfo)

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

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

UploadedRbmFile

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

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

string

اسم الملف الذي تعرضه منصة RCS for Business عند تحميل الملف.
thumbnailName

string

اسم الصورة المصغّرة الذي تعرضه منصة RCS for Business عند تحميل الصورة المصغّرة.

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 for Business عند تحميل الملف تم إيقافها نهائيًا واستبدالها بالسمة uploadedRbmFile أدناه.
uploadedRbmFile

object (UploadedRbmFile)

يحتوي على معرّفات لملف وصورة مصغّرة تم تحميلهما إلى خادم RCS for Business وعرضهما من خلاله.
contentInfo

object (ContentInfo)

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

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

ContentInfo

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

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

string

عنوان URL للملف يمكن الوصول إليه بشكل علني. تحدّد منصة RCS for Business نوع MIME للملف من حقل content-type في عناوين HTTP عندما تسترد المنصة الملف. يجب أن يكون حقل نوع المحتوى متوفّرًا ودقيقًا في استجابة HTTP من عنوان URL. ننصح بأن يكون الحدّ الأقصى لحجم الملف 100 ميغابايت.

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

string

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

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

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

boolean

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

Media.Height

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

عمليات التعداد
HEIGHT_UNSPECIFIED لم يتم تحديد أي قيمة.
SHORT ‫112 وحدة بكسل مستقلة الكثافة
MEDIUM ‫168 وحدة بكسل مستقلة الكثافة
TALL ‫264 وحدة بكسل مستقلة الكثافة

اقتراح

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

تمثيل JSON 
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // 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.
}
الحقول
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

اختياريّ. تتحكّم هذه السمة في سلوك عرض الاقتراح. ينطبق ذلك فقط على الرسائل النصية العادية المُرسَلة إلى عملاء "رسائل Google" (الإصدار 20260225.00 أو الإصدارات الأحدث). يجب ضبط هذا الحقل فقط على الاقتراحات المستقلة المرتبطة بالرسائل النصية العادية. سيرفض الخادم الرسالة إذا تم تطبيق هذا الحقل على اقتراحات في البطاقات التفاعلية أو اقتراحات مستقلة مع عمليات نقل الملفات. يتم تسلسل هذا الإعداد فقط لتطبيق "رسائل Google"، ويتجاهله العملاء الآخرون (مثل iOS أو Samsung).
حقل الربط 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 معرّف موارد منتظمًا صالحًا وفقًا للمعيار RFC 3986. الحد الأقصى لعدد الأحرف هو 2048 حرفًا.
application

enum (OpenUrlApplication)

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

enum (WebviewViewMode)

وضع العرض لعرض الويب
description

string

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

OpenUrlApplication

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

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

WebviewViewMode

نوع وضع عرض مكوِّن عرض محتوى الويب

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

ShareLocationAction

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

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

Suggestion.SuggestionDisplay

سلوك العرض لاقتراحات النصوص المستقلة

عمليات التعداد
SUGGESTION_DISPLAY_UNSPECIFIED

تتّبع البرامج التابعة سلوك العرض التلقائي:

  • تطبيق "رسائل Google" للرسائل النصية العادية المستقلة: تختفي الاقتراحات بعد إرسال رسائل جديدة أو تلقّيها.
  • في نظام التشغيل iOS للرسائل النصية العادية المستقلة: لا تختفي الاقتراحات إلا بعد أن ينقر عليها المستخدم.
  • جميع برامج البطاقات التفاعلية: تظهر الاقتراحات دائمًا، وسيؤدي ضبط suggestionDisplay على البطاقات التفاعلية إلى ظهور الخطأ 400.
PERSISTENT يظل الاقتراح مرئيًا بشكل دائم داخل فقاعة الرسالة، حتى عند إضافة رسائل جديدة إلى المحادثة.

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 السلوك التلقائي: يتم تحديد نوع عدد زيارات الرسائل حسب حالة استخدام الوكيل. عدِّل نوع الزيارات حسب الحاجة استنادًا إلى محتوى الرسالة. بالنسبة إلى الوكلاء المتعدّدي الاستخدام، لا يتم توفير أي إعداد تلقائي. يجب ضبط نوع الزيارات يدويًا (مثل TRANSACTION أو PROMOTION).
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 for Business. للحصول على معلومات إضافية حول الأسعار أو الفوترة، يُرجى التواصل مع ممثلي مشغّل شبكة الجوّال المعنيين.

عمليات التعداد
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

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