Method: users.labels.list

يتم عرض كل التصنيفات في صندوق البريد الإلكتروني للمستخدم.

طلب HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/labels

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
userId

string

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

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "labels": [
    {
      object (Label)
    }
  ]
}
الحقول
labels[]

object (Label)

قائمة التصنيفات يُرجى ملاحظة أن كل مورد تصنيف يحتوي على id وname وmessageListVisibility وlabelListVisibility وtype فقط. يمكن أن تجلب طريقة labels.get تفاصيل تصنيف إضافية.

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

يتطلب ذلك أحد نطاقات OAuth التالية:

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

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