Method: users.settings.delegates.create

تضيف هذه الطريقة مستخدمًا مفوَّضًا مع ضبط حالة إثبات الملكية مباشرةً على accepted، بدون إرسال أي رسالة إلكترونية لإثبات الملكية. يجب أن يكون المستخدم المفوَّض عضوًا في مؤسسة Google Workspace نفسها التي ينتمي إليها المستخدم المفوِّض. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة المفوَّضين.

يفرض Gmail قيودًا على عدد المفوضين والمفوِّضين الذين يمكن أن يحصل عليهم كل مستخدم في مؤسسة Google Workspace. تعتمد هذه الحدود على مؤسستك، ولكن بشكل عام يمكن لكل مستخدم أن يكون لديه ما يصل إلى 25 مفوَّضًا وما يصل إلى 10 مفوِّضين.

يجب الإشارة إلى المستخدم المفوَّض باستخدام عنوان بريده الإلكتروني الأساسي، وليس العنوان البديل للبريد الإلكتروني.

عند إنشاء مفوّض جديد، قد يستغرق الأمر دقيقة واحدة قبل أن يصبح المفوض الجديد متاحًا للاستخدام.

لا تتوفّر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم على مستوى النطاق.

طلب HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates

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

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

المَعلمات
userId

string

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

نص الطلب

يحتوي نص الطلب على مثال Delegate.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا Delegate.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/gmail.settings.sharing

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