REST Resource: domains

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

معلومات حول نطاق سجّله المستخدم

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

string

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

permission

enum (Permission)

النتائج فقط. إذن المستخدم في هذا النطاق

verificationState

enum (VerificationState)

النتائج فقط. معلومات حول سجلّ إثبات ملكية المستخدم وخصائص النطاق

createTime

string (Timestamp format)

النتائج فقط. غير قابل للتغيير الطابع الزمني الذي تمت فيه إضافة النطاق إلى حساب المستخدم.

lastVerifyTime

string (Timestamp format)

الطابع الزمني الذي تم فيه إثبات ملكية النطاق آخر مرة من قِبل المستخدم.

VerificationState

حالة إثبات ملكية المستخدم لنطاق

عمليات التعداد
VERIFICATION_STATE_UNSPECIFIED غير محدد
UNVERIFIED لم يتم إثبات ملكية النطاق.
VERIFIED تم تأكيد النطاق.

الطُرق

create

تضيف هذه الطريقة نطاقًا إلى حساب المستخدم.

delete

يحذف هذا الإجراء نطاقًا من حساب المستخدم.

get

تستردّ هذه الطريقة معلومات تفصيلية حول نطاق سجّلته.

getComplianceStatus

تعرض هذه الطريقة حالة التوافق لنطاق معيّن.

getVerificationToken

تعرض هذه الطريقة رمزًا مميزًا لإثبات ملكية المستخدم لنطاق معيّن.

list

يستردّ هذا الإجراء قائمة بجميع النطاقات التي سجّلتها، بالإضافة إلى البيانات الوصفية المقابلة لها.

verify

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