Method: users.messages.modify

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

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

لمزيد من المعلومات، راجِع دليل التفويض.