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

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