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

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