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

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