REST Resource: users.settings.sendAs

Tài nguyên: SendAs

Các chế độ cài đặt liên kết với email đại diện của tính năng gửi bằng địa chỉ, có thể là địa chỉ đăng nhập chính được liên kết với tài khoản hoặc địa chỉ "từ" tuỳ chỉnh của bạn. Bí danh Gửi dưới dạng tương ứng với tính năng "Gửi thư bằng địa chỉ" trong giao diện web.

Biểu diễn dưới dạng JSON
{
  "sendAsEmail": string,
  "displayName": string,
  "replyToAddress": string,
  "signature": string,
  "isPrimary": boolean,
  "isDefault": boolean,
  "treatAsAlias": boolean,
  "smtpMsa": {
    object (SmtpMsa)
  },
  "verificationStatus": enum (VerificationStatus)
}
Trường
sendAsEmail

string

Địa chỉ email xuất hiện trong phần "Người gửi:" tiêu đề của thư được gửi bằng bí danh này. Chế độ này ở chế độ chỉ đọc đối với mọi thao tác, ngoại trừ thao tác tạo.

displayName

string

Tên xuất hiện trong phần "Từ:" tiêu đề của thư được gửi bằng bí danh này. Đối với "từ" tuỳ chỉnh địa chỉ, khi trường này trống, Gmail sẽ điền giá trị "Từ:" với tên được sử dụng cho địa chỉ chính được liên kết với tài khoản. Nếu quản trị viên tắt tính năng cho phép người dùng cập nhật định dạng tên của họ, thì các yêu cầu cập nhật trường này cho thông tin đăng nhập chính sẽ tự động không thực hiện được.

replyToAddress

string

Địa chỉ email tùy chọn được đưa vào trong mục "Trả lời:" tiêu đề của thư được gửi bằng bí danh này. Nếu trường này trống, Gmail sẽ không tạo thư "Trả lời:" .

signature

string

Một chữ ký HTML tùy chọn có trong thư được soạn bằng bí danh này trong giao diện người dùng web của Gmail. Chữ ký này chỉ được thêm vào email mới.

isPrimary

boolean

Địa chỉ này có phải là địa chỉ chính được dùng để đăng nhập vào tài khoản hay không. Mỗi tài khoản Gmail có đúng một địa chỉ chính và bạn không thể xoá địa chỉ đó khỏi tập hợp email đại diện gửi bằng địa chỉ. Trường này ở chế độ chỉ đọc.

isDefault

boolean

Liệu địa chỉ này có được chọn làm địa chỉ mặc định "Từ:" hay không trong các trường hợp như soạn thư mới hoặc gửi thư trả lời tự động khi đi nghỉ. Mỗi tài khoản Gmail đều có đúng một địa chỉ gửi dưới dạng mặc định, do đó, giá trị pháp lý duy nhất mà khách hàng có thể ghi vào trường này là true. Việc thay đổi thuộc tính này từ false thành true cho một địa chỉ sẽ dẫn đến việc trường này trở thành false cho địa chỉ mặc định trước đó.

treatAsAlias

boolean

Liệu Gmail có nên coi địa chỉ này là email đại diện cho địa chỉ email chính của người dùng hay không. Cài đặt này chỉ áp dụng cho tùy chỉnh "từ" bí danh.

smtpMsa

object (SmtpMsa)

Dịch vụ SMTP không bắt buộc sẽ được dùng làm dịch vụ chuyển tiếp thư đi cho thư được gửi bằng bí danh này. Nếu giá trị này trống, thư đi sẽ được gửi trực tiếp từ máy chủ của Gmail tới dịch vụ SMTP đích. Cài đặt này chỉ áp dụng cho tùy chỉnh "từ" bí danh.

verificationStatus

enum (VerificationStatus)

Cho biết liệu địa chỉ này đã được xác minh để sử dụng làm bí danh gửi bằng địa chỉ hay chưa. Chỉ có thể đọc. Cài đặt này chỉ áp dụng cho tùy chỉnh "từ" bí danh.

SmtpMsa

Cấu hình để giao tiếp với dịch vụ SMTP.

Biểu diễn dưới dạng JSON
{
  "host": string,
  "port": integer,
  "username": string,
  "password": string,
  "securityMode": enum (SecurityMode)
}
Trường
host

string

Tên máy chủ của dịch vụ SMTP. Bắt buộc.

port

integer

Cổng của dịch vụ SMTP. Bắt buộc.

username

string

Tên người dùng sẽ được sử dụng để xác thực với dịch vụ SMTP. Đây là trường chỉ ghi có thể được chỉ định trong các yêu cầu tạo hoặc cập nhật chế độ cài đặt SendAs; nó sẽ không bao giờ được điền sẵn trong các câu trả lời.

password

string

Mật khẩu sẽ được dùng để xác thực với dịch vụ SMTP. Đây là trường chỉ ghi có thể được chỉ định trong các yêu cầu tạo hoặc cập nhật chế độ cài đặt SendAs; nó sẽ không bao giờ được điền sẵn trong các câu trả lời.

securityMode

enum (SecurityMode)

Giao thức sẽ dùng để bảo mật liên lạc với dịch vụ SMTP. Bắt buộc.

SecurityMode

Một giao thức có thể dùng để bảo mật giao tiếp với dịch vụ SMTP.

Enum
securityModeUnspecified Chế độ bảo mật chưa được chỉ định.
none Hoạt động giao tiếp với dịch vụ SMTP từ xa là không an toàn. Yêu cầu cổng 25.
ssl Kết nối với dịch vụ SMTP từ xa được bảo mật bằng SSL.
starttls Hoạt động giao tiếp với dịch vụ SMTP từ xa được bảo mật bằng STARTTLS.

VerificationStatus

Cho biết liệu quyền sở hữu một địa chỉ đã được xác minh để dùng làm bí danh gửi bằng địa chỉ hay chưa.

Enum
verificationStatusUnspecified Trạng thái xác minh chưa được chỉ định.
accepted Địa chỉ này đã sẵn sàng để sử dụng làm bí danh gửi bằng địa chỉ.
pending Địa chỉ đang chờ chủ sở hữu xác minh.

Phương thức

create

Tạo một "từ" tuỳ chỉnh gửi bằng email đại diện.

delete

Xoá bí danh gửi bằng địa chỉ đã chỉ định.

get

Lấy bí danh gửi bằng địa chỉ đã chỉ định.

list

Liệt kê các bí danh gửi dưới dạng cho tài khoản được chỉ định.

patch

Vá bí danh gửi bằng địa chỉ đã chỉ định.

update

Cập nhật email đại diện của tính năng gửi bằng địa chỉ.

verify

Gửi email xác minh đến địa chỉ email đại diện đã chỉ định.