REST Resource: users.settings.sendAs

المورد: SendAs

الإعدادات المرتبطة بعنوان بريد إلكتروني بديل للإرسال، والذي يمكن أن يكون عنوان تسجيل الدخول الرئيسي المرتبط بالحساب أو عنوان "من" مخصّص. تتطابق الأسماء المستعارة "إرسال كـ" مع ميزة "إرسال البريد باسم" في واجهة الويب. يجب أن يكون الاسم المستعار "إرسال باسم" عنوان بريد إلكتروني صالحًا.

تمثيل JSON 
{
  "sendAsEmail": string,
  "displayName": string,
  "replyToAddress": string,
  "signature": string,
  "isPrimary": boolean,
  "isDefault": boolean,
  "treatAsAlias": boolean,
  "smtpMsa": {
    object (SmtpMsa)
  },
  "verificationStatus": enum (VerificationStatus)
}
الحقول
sendAsEmail

string

عنوان البريد الإلكتروني الذي يظهر في العنوان "من:" للرسائل المُرسَلة باستخدام هذا الاسم المستعار هذه السمة للقراءة فقط في جميع العمليات باستثناء عملية الإنشاء.
displayName

string

اسم يظهر في العنوان "من:" للرسائل الإلكترونية المُرسَلة باستخدام هذا الاسم المستعار بالنسبة إلى عناوين "من" المخصّصة، عندما يكون هذا الحقل فارغًا، ستملأ خدمة Gmail عنوان "من:" بالاسم المستخدَم للعنوان الأساسي المرتبط بالحساب. إذا أوقف المشرف إمكانية تعديل المستخدمين لتنسيق أسمائهم، ستتعذّر طلبات تعديل هذا الحقل لتسجيل الدخول الأساسي بدون إشعار.
replyToAddress

string

عنوان بريد إلكتروني اختياري يتم تضمينه في العنوان "الردّ على:" للرسائل المرسَلة باستخدام هذا الاسم المستعار. إذا كان هذا الحقل فارغًا، لن ينشئ Gmail عنوانًا في الحقل "الردّ على:".
signature

string

توقيع HTML اختياري يتم تضمينه في الرسائل التي يتم إنشاؤها باستخدام هذا العنوان البديل للبريد الإلكتروني في واجهة مستخدم الويب في Gmail تتم إضافة هذه التوقيع إلى الرسائل الإلكترونية الجديدة فقط.
isPrimary

boolean

ما إذا كان هذا العنوان هو العنوان الأساسي المُستخدَم لتسجيل الدخول إلى الحساب. يتضمّن كل حساب Gmail عنوانًا رئيسيًا واحدًا فقط، ولا يمكن حذفه من مجموعة العناوين البديلة "إرسال باسم". هذا الحقل مخصّص للقراءة فقط.
isDefault

boolean

ما إذا كان هذا العنوان محدّدًا كعنوان "من:" تلقائي في حالات مثل إنشاء رسالة جديدة أو إرسال رد تلقائي أثناء الإجازة يتضمّن كل حساب Gmail عنوانًا تلقائيًا واحدًا فقط للإرسال باسم، لذا فإنّ القيمة الصالحة الوحيدة التي يمكن للعملاء كتابتها في هذا الحقل هي true. سيؤدي تغيير هذا الحقل من false إلى true لأحد العناوين إلى تحويل هذا الحقل إلى false لعنوان آخر كان تلقائيًا في السابق.
treatAsAlias

boolean

تحديد ما إذا كان على Gmail التعامل مع هذا العنوان كعنوان بديل لعنوان البريد الإلكتروني الرئيسي للمستخدم لا ينطبق هذا الإعداد إلا على الأسماء المستعارة المخصّصة في حقل "من".
smtpMsa

object (SmtpMsa)

خدمة SMTP اختيارية سيتم استخدامها كخدمة إرسال للبريد الصادر الذي يتم إرساله باستخدام هذا الاسم المستعار. إذا كان هذا الحقل فارغًا، سيتم إرسال البريد الصادر مباشرةً من خوادم Gmail إلى خدمة SMTP الوجهة. لا ينطبق هذا الإعداد إلا على الأسماء المستعارة المخصّصة في حقل "من".
verificationStatus

enum (VerificationStatus)

تشير إلى ما إذا تم تأكيد عنوان البريد الإلكتروني هذا لاستخدامه كاسم مستعار لإرسال الرسائل. للقراءة فقط. لا ينطبق هذا الإعداد إلا على الأسماء المستعارة المخصّصة في حقل "من".

SmtpMsa

إعدادات التواصل مع خدمة SMTP

تمثيل JSON 
{
  "host": string,
  "port": integer,
  "username": string,
  "password": string,
  "securityMode": enum (SecurityMode)
}
الحقول
host

string

اسم مضيف خدمة SMTP. الحقل مطلوب.
port

integer

منفذ خدمة SMTP الحقل مطلوب.
username

string

اسم المستخدم الذي سيتم استخدامه للمصادقة مع خدمة SMTP. هذا حقل مخصّص للكتابة فقط ويمكن تحديده في الطلبات لإنشاء إعدادات SendAs أو تعديلها، ولا تتم تعبئته أبدًا في الردود.
password

string

كلمة المرور التي سيتم استخدامها للمصادقة مع خدمة SMTP هذا حقل مخصّص للكتابة فقط ويمكن تحديده في الطلبات لإنشاء إعدادات SendAs أو تعديلها، ولا تتم تعبئته أبدًا في الردود.
securityMode

enum (SecurityMode)

البروتوكول الذي سيتم استخدامه لتأمين الاتصال بخدمة SMTP. الحقل مطلوب.

SecurityMode

بروتوكول يمكن استخدامه لتأمين الاتصال بخدمة SMTP

عمليات التعداد
securityModeUnspecified وضع أمان غير محدَّد
none الاتصال بخدمة SMTP البعيدة غير آمن. يتطلّب المنفذ 25.
ssl يتم تأمين الاتصال بخدمة SMTP البعيدة باستخدام طبقة المقابس الآمنة (SSL).
starttls يتم تأمين الاتصال بخدمة SMTP البعيدة باستخدام STARTTLS.

VerificationStatus

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

عمليات التعداد
verificationStatusUnspecified حالة التحقّق غير محدَّدة.
accepted العنوان جاهز للاستخدام كاسم مستعار للإرسال.
pending العنوان في انتظار تأكيد المالك.

الطُرق

create

 تُنشئ هذه الطريقة اسمًا مستعارًا مخصّصًا "من:" للإرسال.

delete

 يحذف هذا الإجراء الاسم المستعار المحدد "إرسال باسم".

get

 تعرض هذه الطريقة الاسم المستعار المحدّد "إرسال باسم".

list

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

patch

 تصحيح الاسم المستعار المحدد "إرسال باسم".

update

 تعديل اسم مستعار "إرسال باسم"

verify

 يرسِل رسالة تأكيد إلى عنوان البريد الإلكتروني البديل المحدّد.