REST Resource: domains
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: النطاق
مورد نطاق مسجَّل في Postmaster API
| تمثيل 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 |
لا يملك المستخدم الإذن بالوصول إلى معلومات عن النطاق. لم يُثبت المستخدم ملكية النطاق ولم يمنح مالكو النطاقات الآخرون إذن الوصول إليه. |
الطُرق |
|
|
الحصول على نطاق محدّد سجّله العميل |
|
|
يسرد النطاقات التي سجّلها العميل. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: domains\n\n- [Resource: Domain](#Domain)\n - [JSON representation](#Domain.SCHEMA_REPRESENTATION)\n- [Permission](#Permission)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Domain\n----------------\n\nA registered domain resource in the Postmaster API.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"createTime\": string, \"permission\": enum (/workspace/gmail/postmaster/reference/rest/v1/domains#Permission) } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of the Domain. Domain names have the form `domains/{domain_name}`, where domain_name is the fully qualified domain name (i.e., mymail.mydomain.com). |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Timestamp when the user registered this domain. Assigned by the server. |\n| `permission` | `enum (`[Permission](/workspace/gmail/postmaster/reference/rest/v1/domains#Permission)`)` User's permission for this domain. Assigned by the server. |\n\nPermission\n----------\n\nThe possible permissions a user can have for a domain.\n\n| Enums ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `PERMISSION_UNSPECIFIED` | The default value and should never be used explicitly. |\n| `OWNER` | User has read access to the domain and can share access with others. |\n| `READER` | User has read access to the domain. |\n| `NONE` | User doesn't have permission to access information about the domain. User did not verify ownership of domain nor was access granted by other domain owners. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|------------------------------------------------------------|\n| ### [get](/workspace/gmail/postmaster/reference/rest/v1/domains/get) | Gets a specific domain registered by the client. |\n| ### [list](/workspace/gmail/postmaster/reference/rest/v1/domains/list) | Lists the domains that have been registered by the client. |"]]
