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

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