Method: users.messages.batchModify

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

طلب HTTP

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

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

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

المعلمات
userId

string

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

string

أرقام تعريف الرسائل التي سيتم تعديلها. يبلغ الحد الأقصى لعدد المعرّفات في كل طلب 1,000 معرّف.
addLabelIds[]

string

قائمة بمعرّفات التصنيفات المطلوب إضافتها إلى الرسائل.
removeLabelIds[]

string

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة فارغًا.

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

يجب توفير أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.