لتعديل التصنيفات على الرسائل المحددة.
طلب HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
userId |
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "ids": [ string ], "addLabelIds": [ string ], "removeLabelIds": [ string ] } |
الحقول | |
---|---|
ids[] |
أرقام تعريف الرسائل المراد تعديلها. هناك حد أقصى يبلغ 1,000 رقم تعريفي لكل طلب. |
addLabelIds[] |
قائمة بأرقام تعريف التصنيفات لإضافتها إلى الرسائل. |
removeLabelIds[] |
قائمة بأرقام تعريف التصنيفات المطلوب إزالتها من الرسائل |
نص الاستجابة
في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
لمزيد من المعلومات، راجِع دليل التفويض.