Method: users.messages.modify

لتعديل التصنيفات في الرسالة المحدّدة.

طلب HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت المصادقة عليه.
id

string

رقم تعريف الرسالة المطلوب تعديلها

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
الحقول
addLabelIds[]

string

قائمة بأرقام التعريف الخاصة بالتصنيفات لإضافتها إلى هذه الرسالة. ويمكنك إضافة ما يصل إلى 100 تصنيف مع كل تعديل.
removeLabelIds[]

string

معرّف قائمة التصنيفات التي يجب إزالتها من هذه الرسالة. يمكنك إزالة ما يصل إلى 100 تصنيف مع كل تحديث.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Message.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

لمزيد من المعلومات، اطّلِع على دليل التفويض.