REST Resource: spaces.messages

المرجع: رسالة

رسالة في مساحة Google Chat

تمثيل JSON
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
الحقول
name

string

اسم مورد الرسالة

تنسيق الملف: spaces/{space}/messages/{message}

حيث يكون {space} هو رقم تعريف المساحة التي تم نشر الرسالة فيها و{message} هو رقم تعريف يحدّده النظام للرسالة. مثلاً: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

في حال ضبط معرّف مخصّص عند إنشاء رسالة، يمكنك استخدامه لتحديد الرسالة في الطلب من خلال استبدال {message} بالقيمة من الحقل clientAssignedMessageId. مثلاً: spaces/AAAAAAAAAAA/messages/client-custom-name لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة.

sender

object (User)

النتائج فقط. المستخدم الذي أنشأ الرسالة في حال المصادقة كمستخدِم من خلال تطبيق Chat، تتم تعبئة نتيجة المستخدم name وtype.

createTime

string (Timestamp format)

اختياريّ. غير قابل للتغيير. وقت إنشاء الرسالة في المساحات التي تم إنشاؤها في Chat هذا الحقل مخصّص للمخرجات فقط، إلا عند استخدامه في مساحات وضع الاستيراد.

بالنسبة إلى مساحات وضع الاستيراد، يجب ضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء الرسالة فيه في المصدر من أجل الحفاظ على وقت الإنشاء الأصلي.

lastUpdateTime

string (Timestamp format)

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

deleteTime

string (Timestamp format)

النتائج فقط. وقت حذف الرسالة في Google Chat إذا لم يتم حذف الرسالة مطلقًا، سيكون هذا الحقل فارغًا.

text

string

نص الرسالة العادي يؤدي الرابط الأول لصورة أو فيديو أو صفحة ويب إلى إنشاء شريحة معاينة. يمكنك أيضًا الإشارة إلى مستخدم Google Chat باستخدام@ أو جميع المستخدمين في المساحة.

لمعرفة المزيد من المعلومات عن إنشاء الرسائل النصية، يُرجى الاطّلاع على إرسال رسالة نصية.

formattedText

string

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

  • بنية ترميز للإطارات الغامقة والمائلة والمشطوبة والأحادية والمسافة المقطوعة والقائمة النقطية.

  • إشارات المستخدمين باستخدام التنسيق <users/{user}>

  • روابط تشعّبية مخصّصة باستخدام التنسيق <{url}|{rendered_text}> حيث تكون السلسلة الأولى هي عنوان URL والثانية هي النص المعروض، مثل <http://example.com|custom text>.

  • الرموز التعبيرية المخصّصة التي تستخدم التنسيق :{emoji_name}:، على سبيل المثال :smile: لا ينطبق ذلك على رموز يونيكود التعبيرية، مثل U+1F600 للرمز التعبيري للوجه المبتسم.

لمزيد من المعلومات، يُرجى الاطّلاع على عرض تنسيق النص الذي تم إرساله في رسالة.

cards[]
(deprecated)

object (Card)

مهملة: يمكنك استخدام cardsV2 بدلاً منها.

بطاقات منسَّقة ومنسّقة وتفاعلية يمكنك استخدامها لعرض عناصر واجهة المستخدم مثل النصوص المنسّقة والأزرار والصور القابلة للنقر يتم عرض البطاقات عادةً أسفل نص النص العادي للرسالة. يمكن أن يبلغ حجم كل من cards وcardsV2 32 كيلوبايت كحد أقصى.

cardsV2[]

object (CardWithId)

مصفوفة من البطاقات.

يمكن لتطبيقات Chat فقط إنشاء البطاقات. في حال إجراء تطبيق Chat المصادقة كمستخدم، لا يمكن أن تحتوي الرسائل على بطاقات.

للتعرّف على البطاقات وكيفية إنشائها، يُرجى مراجعة إرسال رسائل البطاقات.

يمكنك تصميم البطاقات ومعاينتها باستخدام أداة إنشاء البطاقات.

فتح "أداة إنشاء البطاقات"

annotations[]

object (Annotation)

النتائج فقط. تعليقات توضيحية مرتبطة بـ text في هذه الرسالة

thread

object (Thread)

سلسلة المحادثات التي تنتمي إليها الرسالة مثلاً، يمكنك الاطّلاع على بدء سلسلة محادثات أو الرد عليها.

space

object (Space)

في حال المصادقة كمستخدم في تطبيق Chat، تتم تعبئة المساحة name عند نتيجة التطبيق.

fallbackText

string

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

actionResponse

object (ActionResponse)

الإدخال فقط. المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط طريقة نشر الاستجابة

argumentText

string

النتائج فقط. نص الرسالة ذو النص العادي مع إزالة جميع الإشارات في تطبيق Chat

slashCommand

object (SlashCommand)

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

attachment[]

object (Attachment)

المرفق الذي حمّله المستخدم

matchedUrl

object (MatchedUrl)

النتائج فقط. عنوان URL في spaces.messages.text يتطابق مع نمط معاينة الرابط. لمزيد من المعلومات، يُرجى الاطّلاع على روابط المعاينة.

threadReply

boolean

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

إذا كانت المساحة لا تتيح الرد في سلاسل المحادثات، يكون هذا الحقل دائمًا false.

clientAssignedMessageId

string

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

emojiReactionSummaries[]

object (EmojiReactionSummary)

النتائج فقط. قائمة ملخّصات التفاعلات باستخدام الرموز التعبيرية في الرسالة

privateMessageViewer

object (User)

غير قابل للتغيير. حقل لإنشاء رسالة، وإلا سيتم إخراج البيانات فقط. المستخدِم الذي يمكنه الاطّلاع على الرسالة عند ضبط هذه السياسة، تكون الرسالة خاصة ولا تظهر إلا للمستخدم المحدّد والتطبيق على Chat. لا يمكن استخدام معاينات الروابط والمرفقات للرسائل الخاصة.

يمكن لتطبيقات Chat فقط إرسال رسائل خاصة. في حال إجراء تطبيق Chat المصادقة كمستخدم لإرسال رسالة، لا يمكن أن تكون الرسالة خاصة ويجب أن تحذف هذا الحقل.

لمعرفة التفاصيل، يُرجى الاطّلاع على المقالة إرسال رسائل خاصة إلى مستخدمي Google Chat.

deletionMetadata

object (DeletionMetadata)

النتائج فقط. معلومات حول رسالة محذوفة. يتم حذف الرسالة عند ضبط deleteTime.

quotedMessageMetadata

object (QuotedMessageMetadata)

النتائج فقط. معلومات حول رسالة مقتبَسة من مستخدم Google Chat في مساحة يمكن لمستخدمي Google Chat اقتباس رسالة للرد عليها.

attachedGifs[]

object (AttachedGif)

النتائج فقط. صور GIF المرفقة بالرسالة

accessoryWidgets[]

object (AccessoryWidget)

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

يتطلب إنشاء رسالة باستخدام التطبيقات المصغّرة للملحقات مصادقة التطبيق.

CardWithId

بطاقة في رسالة Google Chat

يمكن لتطبيقات Chat فقط إنشاء البطاقات. في حال إجراء تطبيق Chat المصادقة كمستخدم، لا يمكن أن تحتوي الرسالة على بطاقات.

يمكنك تصميم البطاقات ومعاينتها باستخدام أداة إنشاء البطاقات.

فتح "أداة إنشاء البطاقات"

تمثيل JSON
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
الحقول
cardId

string

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

card

object (Card)

بطاقة. الحد الأقصى للحجم هو 32 كيلوبايت.

التعليق التوضيحي

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

مثال على نص رسالة بالنص العادي:

Hello @FooBot how are you!"

البيانات الوصفية للتعليقات التوضيحية المقابلة:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
تمثيل JSON
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  }
  // End of list of possible types for union field metadata.
}
الحقول
type

enum (AnnotationType)

تمثّل هذه السمة نوع هذا التعليق التوضيحي.

length

integer

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

startIndex

integer

فهرس البداية (المستند إلى 0، شامل) في نص الرسالة ذات النص العادي الذي يتجاوب معه هذا التعليق التوضيحي.

حقل الاتحاد metadata بيانات وصفية إضافية حول التعليق التوضيحي. يمكن أن يكون الحقل "metadata" واحدًا فقط مما يلي:
userMention

object (UserMentionMetadata)

البيانات الوصفية لإشارة المستخدم.

slashCommand

object (SlashCommandMetadata)

بيانات التعريف لأمر شرطة مائلة.

AnnotationType

نوع التعليق التوضيحي.

عمليات التعداد
ANNOTATION_TYPE_UNSPECIFIED القيمة التلقائية للتعداد. يُرجى عدم استخدامها.
USER_MENTION تمت الإشارة إلى مستخدم.
SLASH_COMMAND تم استدعاء أمر شرطة مائلة.

UserMentionMetadata

البيانات الوصفية للتعليقات التوضيحية لإشارات المستخدمين (@)

تمثيل JSON
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
الحقول
user

object (User)

أشار المستخدِم إلى أنّه

type

enum (Type)

تمثّل هذه السمة نوع إشارة المستخدم.

النوع

عمليات التعداد
TYPE_UNSPECIFIED القيمة التلقائية للتعداد. يُرجى عدم استخدامها.
ADD إضافة مستخدم إلى المساحة
MENTION الإشارة إلى مستخدم في المساحة

SlashCommandMetadata

البيانات الوصفية للتعليقات التوضيحية للأوامر التي تبدأ بشرطة مائلة (/).

تمثيل JSON
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
الحقول
bot

object (User)

تطبيق Chat الذي تم استدعاء أمره

type

enum (Type)

تمثّل هذه السمة نوع الأمر الشرطة المائلة.

commandName

string

اسم الأمر الشرطة المائلة الذي تم استدعاءه.

commandId

string (int64 format)

معرِّف الأمر للأمر الشرطة المائلة الذي تم استدعاءه.

triggersDialog

boolean

يشير إلى ما إذا كان الأمر الشرطة المائلة لمربّع حوار.

النوع

عمليات التعداد
TYPE_UNSPECIFIED القيمة التلقائية للتعداد. يُرجى عدم استخدامها.
ADD إضافة تطبيق Chat إلى المساحة
INVOKE استدعِ الأمر الشرطة المائلة في الفضاء.

RichLinkMetadata

رابط منسق إلى مورد.

تمثيل JSON
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  }
  // End of list of possible types for union field data.
}
الحقول
uri

string

معرّف الموارد المنتظم (URI) لهذا الرابط.

حقل الاتحاد data بيانات المورد المرتبط يمكن أن يكون الحقل "data" واحدًا فقط مما يلي:

RichLinkType

نوع الرابط المنسَّق: وقد تتم إضافة المزيد من الأنواع في المستقبل.

عمليات التعداد
DRIVE_FILE نوع رابط منسق في Google Drive.

DriveLinkData

بيانات روابط Google Drive

تمثيل JSON
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
الحقول
driveDataRef

object (DriveDataRef)

DriveDataRef الذي يشير إلى ملف Google Drive.

mimeType

string

نوع MIME لمورد Google Drive المرتبط.

Thread

سلسلة محادثات في مساحة Google Chat مثلاً، يمكنك الاطّلاع على بدء سلسلة محادثات أو الرد عليها.

إذا حددت سلسلة محادثات عند إنشاء رسالة، يمكنك ضبط الحقل messageReplyOption لتحديد ما يحدث في حال عدم العثور على سلسلة محادثات مطابقة.

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

string

النتائج فقط. اسم مورد سلسلة المحادثات

مثلاً: spaces/{space}/threads/{thread}

threadKey

string

اختياريّ. حقل لإنشاء سلسلة محادثات أو تعديلها وبخلاف ذلك، يتم الناتج فقط. رقم تعريف سلسلة المحادثات. إمكانية استخدام ما يصل إلى 4,000 حرف

ويكون هذا المعرّف فريدًا لتطبيق Chat الذي يضبطه. على سبيل المثال، إذا أنشأت عدة تطبيقات في Chat رسالة باستخدام مفتاح سلسلة المحادثات نفسه، يتم نشر الرسائل في سلاسل محادثات مختلفة. للرد في سلسلة محادثات أنشأها مستخدم أو تطبيق آخر في Chat، حدِّد حقل سلسلة المحادثات name بدلاً من ذلك.

ActionResponse

المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط طريقة نشر الاستجابة

تمثيل JSON
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
الحقول
type

enum (ResponseType)

الإدخال فقط. نوع استجابة تطبيق Chat.

url

string

الإدخال فقط. عنوان URL للمستخدمين للمصادقة أو الضبط. (لنوعَي استجابة (REQUEST_CONFIG) فقط).

dialogAction

object (DialogAction)

الإدخال فقط. ردّ على حدث تفاعل مرتبط بمربّع حوار. يجب أن تكون مصحوبة بـ ResponseType.Dialog.

updatedWidget

object (UpdatedWidget)

الإدخال فقط. استجابة التطبيق المصغّر بعد تعديله

ResponseType

نوع استجابة تطبيق Chat.

عمليات التعداد
TYPE_UNSPECIFIED النوع التلقائي الذي يتم التعامل معه على أنّه NEW_MESSAGE.
NEW_MESSAGE النشر كرسالة جديدة في الموضوع
UPDATE_MESSAGE عدِّل رسالة تطبيق Chat. ولا يُسمح بذلك إلا في حدث "CARD_CLICKED" حيث يكون نوع مُرسِل الرسالة هو BOT.
UPDATE_USER_MESSAGE_CARDS تعديل البطاقات في رسالة المستخدم غير مسموح بهذا الإجراء إلا كرد على حدث "MESSAGE" بعنوان URL مطابق، أو كحدث CARD_CLICKED يكون فيه نوع مُرسِل الرسالة هو HUMAN. ويتم تجاهل النص.
REQUEST_CONFIG اطلب من المستخدم بشكل خاص المصادقة أو الضبط الإضافيين.
DIALOG تعرض مربع حوار.
UPDATE_WIDGET طلب البحث عن خيارات الإكمال التلقائي لنص الأداة

DialogAction

يحتوي على مربع حوار ورمز حالة الطلب.

تمثيل JSON
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
الحقول
actionStatus

object (ActionStatus)

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

حقل الاتحاد action

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

dialog

object (Dialog)

الإدخال فقط. مربّع حوار للطلب.

Dialog

التفاف حول نص البطاقة في مربّع الحوار.

تمثيل JSON
{
  "body": {
    object (Card)
  }
}
الحقول
body

object (Card)

الإدخال فقط. نص مربّع الحوار، يظهر في شكل مشروط. لا تتيح تطبيقات Google Chat استخدام كيانَي البطاقات التاليَين: DateTimePicker وOnChangeAction.

ActionStatus

تمثل حالة طلب استدعاء مربع حوار أو إرساله.

تمثيل JSON
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
الحقول
statusCode

enum (Code)

رمز الحالة.

userFacingMessage

string

الرسالة المرسَلة إلى المستخدمين بشأن حالة طلبهم. وفي حال ترك هذه السياسة بدون ضبط، يتم إرسال رسالة عامة تستند إلى statusCode.

الرمز

رموز الخطأ الأساسية لواجهات برمجة تطبيقات gRPC

قد تنطبق أحيانًا عدة رموز خطأ. يجب أن تعرض الخدمات رمز الخطأ الأكثر تحديدًا الساري. على سبيل المثال، يمكنك استخدام OUT_OF_RANGE بدلاً من FAILED_PRECONDITION في حال تطبيق كلا الرمزين. بالمثل، تفضّل NOT_FOUND أو ALREADY_EXISTS على FAILED_PRECONDITION.

عمليات التعداد
OK

ليس خطأ؛ تم إرجاعها بنجاح.

تعيين HTTP: 200 OK

CANCELLED

تم إلغاء العملية، عادةً ما يكون المتصل

تعيين HTTP: طلب مغلق من عميل 499

UNKNOWN

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

تعيين HTTP: خطأ في الخادم الداخلي 500

INVALID_ARGUMENT

حدَّد العميل وسيطة غير صالحة. يُرجى العِلم أنّ هذا يختلف عن FAILED_PRECONDITION. تشير القيمة INVALID_ARGUMENT إلى الوسيطات المسببة للمشاكل بغض النظر عن حالة النظام (على سبيل المثال، اسم ملف مكتوب بشكلٍ غير صحيح).

تعيين HTTP: 400 طلب غير صالح

DEADLINE_EXCEEDED

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

تعيين HTTP: انتهت مهلة بوابة 504

NOT_FOUND

لم يتم العثور على بعض الكيانات المطلوبة (مثل ملف أو دليل).

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

تعيين HTTP: 404 لم يتم العثور على الصفحة

ALREADY_EXISTS

الكيان الذي حاول العميل إنشاءه (مثل ملف أو دليل) موجود من قبل.

تعيين HTTP: تعارض 409

PERMISSION_DENIED

لا يملك المتصل إذنًا لتنفيذ العملية المحددة. يجب عدم استخدام PERMISSION_DENIED لعمليات الرفض الناتجة عن استنفاد بعض الموارد (استخدِم RESOURCE_EXHAUSTED بدلاً من ذلك لمعالجة هذه الأخطاء). يجب عدم استخدام PERMISSION_DENIED إذا تعذّر تحديد هوية المتصل (استخدِم UNAUTHENTICATED بدلاً من ذلك مع هذه الأخطاء). لا يشير رمز الخطأ هذا إلى أنّ الطلب صالح أو أنّ العنصر المطلوب متوفّر أو يستوفي شروطًا مسبقة أخرى.

تعيين HTTP: 403 محظور

UNAUTHENTICATED

لا يحتوي الطلب على بيانات اعتماد مصادقة صالحة للعملية.

تعيين HTTP: 401 غير مصرح به

RESOURCE_EXHAUSTED

تم استنفاد بعض الموارد، ربما الحصة لكل مستخدم، أو ربما نفدت مساحة نظام الملفات بالكامل.

تعيين HTTP: 429 طلبات كثيرة جدًا

FAILED_PRECONDITION

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

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

تعيين HTTP: 400 طلب غير صالح

ABORTED

تم إلغاء العملية، وعادةً ما ترجع هذه المشكلة إلى مشكلة في التزامن، مثل تعذّر التحقّق من جهاز التسلسل أو إلغاء المعاملة.

يمكنك الاطّلاع على الإرشادات أعلاه للاختيار بين FAILED_PRECONDITION وABORTED وUNAVAILABLE.

تعيين HTTP: تعارض 409

OUT_OF_RANGE

تمت محاولة العملية خارج النطاق الصالح. على سبيل المثال، التقديم/الترجيع أو القراءة في نهاية الملف

على عكس INVALID_ARGUMENT، يشير هذا الخطأ إلى مشكلة يمكن حلّها في حال تغيّرت حالة النظام. على سبيل المثال، سينشئ نظام ملفات 32 بت INVALID_ARGUMENT إذا طُلب منك قراءته بإزاحة ليست في النطاق [0,2^32-1]، ولكنه سينشئ OUT_OF_RANGE إذا طُلب منك قراءته من إزاحة تتجاوز حجم الملف الحالي.

هناك بعض التداخل بين FAILED_PRECONDITION وOUT_OF_RANGE. نقترح استخدام OUT_OF_RANGE (الخطأ الأكثر تحديدًا) عند تطبيقه، بحيث يمكن للمتصلين الذين يكررون التكرار خلال مساحة البحث بسهولة عن الخطأ OUT_OF_RANGE لاكتشاف الخطأ عند الانتهاء.

تعيين HTTP: 400 طلب غير صالح

UNIMPLEMENTED

لم يتم تنفيذ العملية أو أنها غير متاحة/مفعّلة في هذه الخدمة.

تعيين HTTP: لم يتم تنفيذ 501

INTERNAL

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

تعيين HTTP: خطأ في الخادم الداخلي 500

UNAVAILABLE

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

يمكنك الاطّلاع على الإرشادات أعلاه للاختيار بين FAILED_PRECONDITION وABORTED وUNAVAILABLE.

تعيين HTTP: خدمة 503 غير متوفرة

DATA_LOSS

تلف أو فقدان بيانات يتعذّر استردادها.

تعيين HTTP: خطأ في الخادم الداخلي 500

UpdatedWidget

استجابة التطبيق المصغّر بعد تعديله يتم استخدامه لتوفير خيارات الإكمال التلقائي لتطبيق مصغّر.

تمثيل JSON
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
الحقول
widget

string

رقم تعريف التطبيق المصغّر الذي تم تحديثه. يجب أن يتطابق رقم التعريف مع رقم تعريف التطبيق المصغّر الذي أدّى إلى طلب التعديل.

حقل الاتحاد updated_widget

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

suggestions

object (SelectionItems)

قائمة بنتائج الإكمال التلقائي للتطبيق المصغّر

SelectionItems

قائمة بنتائج الإكمال التلقائي للتطبيقات المصغّرة

تمثيل JSON
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
الحقول
items[]

object (SelectionItem)

مصفوفة من عناصر SelectionItem

SlashCommand

أمر شرطة مائلة في Google Chat.

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

string (int64 format)

رقم تعريف الأمر الشرطة المائلة الذي تم استدعاءه.

MatchedUrl

عنوان URL مطابق في رسالة Chat يمكن لتطبيقات Chat معاينة عناوين URL المطابقة. لمزيد من المعلومات، يُرجى الاطّلاع على معاينة الروابط.

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

string

النتائج فقط. عنوان URL الذي تمّت مطابقته

EmojiReactionSummary

عدد المستخدمين الذين تفاعلوا مع رسالة باستخدام رمز تعبيري محدَّد

تمثيل JSON
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
الحقول
emoji

object (Emoji)

الرموز التعبيرية المرتبطة بالتفاعلات

reactionCount

integer

إجمالي عدد التفاعلات باستخدام الرمز التعبيري المرتبط.

DeletionMetadata

معلومات حول رسالة محذوفة. يتم حذف الرسالة عند ضبط deleteTime.

تمثيل JSON
{
  "deletionType": enum (DeletionType)
}
الحقول
deletionType

enum (DeletionType)

يشير إلى من حذف الرسالة.

DeletionType

الشخص الذي حذف الرسالة وكيف تم حذفها.

عمليات التعداد
DELETION_TYPE_UNSPECIFIED هذه القيمة غير مستخدمة.
CREATOR حذف المستخدم رسالته.
SPACE_OWNER حذف مالك المساحة الرسالة.
ADMIN حذَف أحد مشرفي Google Workspace الرسالة.
APP_MESSAGE_EXPIRY حذف تطبيق في Chat رسالته الخاصة عند انتهاء صلاحيتها.
CREATOR_VIA_APP حذَف أحد تطبيقات Chat الرسالة نيابةً عن المستخدم.
SPACE_OWNER_VIA_APP حذَف أحد تطبيقات Chat الرسالة نيابةً عن مالك المساحة.

QuotedMessageMetadata

معلومات حول رسالة مُقتبَسة

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

string

النتائج فقط. اسم مورد الرسالة المقتبَسة

تنسيق الملف: spaces/{space}/messages/{message}

lastUpdateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت إنشاء الرسالة المقتبَسة أو لتاريخ آخر تعديل للرسالة المُقتبَسة

AttachedGif

صورة GIF يتم تحديدها بواسطة عنوان URL.

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

string

النتائج فقط. عنوان URL الذي يستضيف صورة GIF.

AccessoryWidget

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

تمثيل JSON
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
الحقول

حقل الاتحاد action

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

buttonList

object (ButtonList)

قائمة بالأزرار.

الطُرق

create

ينشئ رسالة في مساحة Google Chat.

delete

لحذف الرسالة

get

لعرض تفاصيل حول رسالة.

list

يسرد الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل من الأعضاء المحظورين والمساحات.

patch

لتعديل رسالة

update

لتعديل رسالة