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

يؤدي هذا الخيار إلى إرسال رسالة تحقُّق إلى عنوان البريد الإلكتروني البديل المحدَّد للإرسال باسم.