REST Resource: domains

المورد: النطاق

مورد نطاق مسجَّل في واجهة برمجة تطبيقات Postmaster.

تمثيل JSON 
{
  "name": string,
  "createTime": string,
  "permission": enum (Permission)
}
الحقول
name

string

اسم مورد النطاق. تحتوي أسماء النطاقات على النموذج domains/{domain_name}، حيث يكون domain_name هو اسم النطاق المؤهل بالكامل (مثل mymail.mydomain.com).
createTime

string (Timestamp format)

الطابع الزمني الذي سجَّل فيه المستخدم هذا النطاق تم تعيينها من قِبل الخادم.
permission

enum (Permission)

إذن المستخدم لهذا النطاق. تم تعيينها من قِبل الخادم.

الإذن

الأذونات المحتملة التي يمكن أن يمتلكها المستخدم بالنسبة إلى النطاق.

عمليات التعداد
PERMISSION_UNSPECIFIED القيمة التلقائية ويجب عدم استخدامها بشكل صريح.
OWNER يملك المستخدم إذن الوصول للقراءة إلى النطاق ويمكنه مشاركة الإذن بالوصول مع الآخرين.
READER يتوفّر للمستخدم إذن الوصول للقراءة إلى النطاق.
NONE لا يملك المستخدم إذنًا للوصول إلى معلومات حول النطاق. لم يُثبت المستخدم ملكية النطاق ولم يمنحه مالكو النطاق الآخرون إمكانية الوصول.

الطُرق

get

 الحصول على نطاق معيّن مسجَّل من قِبل العميل

list

 يسرد النطاقات التي سجّلها العميل.