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

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