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. مطلوبة.

وضع الأمان

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

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

حالة التحقق

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

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

الطُرق

create

لإنشاء عنوان "من:" مخصّص للإرسال باسم "من".

delete

لحذف الاسم المستعار المحدد للإرسال كـ.

get

لحصول على الاسم المستعار "إرسال كـ".

list

يسرد الأسماء المستعارة للإرسال كـ للحساب المحدد.

patch

يمكنك تصحيح الاسم المستعار المُحدَّد للإرسال باسم.

update

يُحدِّث اسمًا مستعارًا للإرسال باسم.

verify

لإرسال رسالة تحقق إلى عنوان إرسال الاسم المستعار المحدد.