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 for Business، والتي يمكن أن تكون فيديو أو صورًا أو ملف PDF أو غير ذلك، باستثناء نص الرسالة أو الاقتراحات. في الوقت الحالي، لا تتم تعبئة هذا الحقل إلا لأرقام الهواتف في الولايات المتحدة.
carrier

string

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

حقل الربط 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 المحتوى من ذاكرة تخزين مؤقت، ولكن يمكن للوكيل إجبار المنصة على جلب نسخة جديدة من المحتوى وإعادة تحميل ذاكرة التخزين المؤقت.

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

(اختياري) وصف البطاقة يجب ألا يتجاوز عدد الأحرف 2,000 حرف.
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 المحتوى من ذاكرة تخزين مؤقت، ولكن يمكن للوكيل إجبار المنصة على جلب نسخة جديدة من المحتوى وإعادة تحميل ذاكرة التخزين المؤقت.

ContentInfo

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

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

string

عنوان URL للملف يمكن الوصول إليه من الجميع تحدّد منصة RCS for Business نوع MIME للملف من حقل "نوع المحتوى" في عناوين 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

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

على سبيل المثال، سيؤدي ضبط سلسلة طلب البحث على "بنك Growing Tree" إلى عرض جميع مواقع بنك Growing Tree القريبة من المستخدم. سيؤدي ضبط سلسلة طلب البحث على "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)

تطبيق أو متصفّح أو عرض ويب مفتوح من خلال عنوان URL للتحقّق مما إذا كان جهاز المستخدم يتيح وضع WebView، عليك إجراء عملية تحقّق من الإمكانات أولاً. يمكنك الاطّلاع على المستندات للحصول على التفاصيل: 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_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 الخاصة بخطاف الويب. ولا ينطبق ذلك على رسائل A2P.

الطُرق

create

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

delete

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