REST Resource: users.settings.sendAs

Tài nguyên: SendAs

Các chế độ cài đặt được liên kết với email đại diện, có thể là địa chỉ đăng nhập chính liên kết với tài khoản hoặc địa chỉ "từ" tuỳ chỉnh. Email đại diện được gửi bằng địa chỉ 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)
}
Các trường
sendAsEmail

string

Địa chỉ email xuất hiện trong tiêu đề "Từ:" đối với thư được gửi bằng bí danh này. Đây là chế độ chỉ có thể đọc cho tất cả các thao tác, ngoại trừ thao tác tạo.
displayName

string

Tên xuất hiện trong tiêu đề "Từ:" cho thư được gửi bằng bí danh này. Đối với địa chỉ "từ" tuỳ chỉnh, khi trường này trống, Gmail sẽ điền tiêu đề "Từ:" bằng 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 khô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 để đăng nhập chính sẽ tự động không thực hiện được.
replyToAddress

string

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

string

Chữ ký HTML không bắt buộc 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

Liệu đị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ó duy nhất một địa chỉ chính và không thể xóa địa chỉ này khỏi bộ sưu tập các bí danh gửi bằng địa chỉ. Trường này chỉ để đọc.
isDefault

boolean

Liệu địa chỉ này có được chọn làm địa chỉ mặc định "Từ:" 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ỉ hay không. Mỗi tài khoản Gmail có duy nhất một địa chỉ gửi mặc định, vì vậy, giá trị pháp lý duy nhất mà khách hàng có thể ghi vào trường này là true. Thay đổi giá trị này từ false thành true cho một địa chỉ sẽ khiến trường này trở thành false cho địa chỉ mặc định khác trước đó.
treatAsAlias

boolean

Liệu Gmail có nên xem địa chỉ này là bí danh cho địa chỉ email chính của người dùng hay không. Chế độ cài đặt này chỉ áp dụng cho các bí danh "từ" tuỳ chỉnh.
smtpMsa

object (SmtpMsa)

Một dịch vụ SMTP tùy chọn sẽ được dùng làm dịch vụ chuyển tiếp đi cho những thư được gửi bằng bí danh này. Nếu trống, thư đi sẽ được gửi trực tiếp từ các máy chủ của Gmail đến dịch vụ SMTP đích. Chế độ cài đặt này chỉ áp dụng cho các bí danh "từ" tuỳ chỉnh.
verificationStatus

enum (VerificationStatus)

Cho biết địa chỉ này đã được xác minh để sử dụng làm bí danh hay chưa. Chỉ đọc. Chế độ cài đặt này chỉ áp dụng cho các bí danh "từ" tuỳ chỉnh.

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)
}
Các trường
host

string

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

integer

Cổng 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; trường này không bao giờ được điền sẵn trong phản hồi.
password

string

Mật khẩu 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; trường này không bao giờ được điền sẵn trong phản hồi.
securityMode

enum (SecurityMode)

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

SecurityMode

Một giao thức có thể được dùng để bảo mật thông tin liên lạc với dịch vụ SMTP.

Enum
securityModeUnspecified Chế độ bảo mật chưa được chỉ định.
none Giao tiếp với dịch vụ SMTP từ xa không an toàn. Cần có cổng 25.
ssl Việc giao tiếp 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 giao thứcSTARTTLS.

VerificationStatus

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

Enum
verificationStatusUnspecified Trạng thái xác minh chưa được chỉ định.
accepted Địa chỉ đã 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 bí danh "từ" tuỳ chỉnh để gửi bằng địa chỉ.

delete

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

get

 Nhận bí danh được chỉ định gửi dưới dạng.

list

 Liệt kê các bí danh gửi bằng địa chỉ cho tài khoản đã chỉ định.

patch

 Dán bí danh gửi dưới dạng đã chỉ định.

update

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

verify

 Gửi email xác minh đến địa chỉ bí danh được chỉ định.