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

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