نظرة عامة على واجهة برمجة تطبيقات إعدادات المشرف

تسمح "واجهة برمجة تطبيقات إعدادات المشرف" لمشرفي نطاقات Google Workspace باسترداد إعدادات نطاقاتهم في شكل خلاصات Google Data API وتغييرها.

تتضمن إعدادات النطاق هذه العديد من الميزات المتاحة في وحدة تحكُّم مشرف Google Workspace. تتضمن أمثلة الاستخدامات لواجهة برمجة التطبيقات هذه إنشاء لوحة تحكم مخصصة أو دمج نطاقات Google Workspace في بيئة قديمة حالية.

تعمل واجهة برمجة تطبيقات إعدادات المشرف على تنفيذ بروتوكول واجهة برمجة تطبيقات بيانات Google. تتوافق Google Data API مع نموذج النشر والتعديل لبروتوكول Atom النشر (AtomPub). تستخدم طلبات HTTP لبروتوكول AtomPub منهجية تصميم مجموعة النقل (RESTful) تمثيلية لخدمات الويب. للحصول على المزيد من المعلومات، راجع دليل مطوري بيانات Google.

الجمهور

هذا المستند موجّه لمطوّري البرامج الذين يريدون كتابة تطبيقات عميل يمكنها تعديل المعلومات حول نطاقات Google Workspace واستردادها. ويقدم أمثلة على تفاعلات واجهة برمجة تطبيقات إعدادات المشرف الأساسية باستخدام XML وHTTP الأولي.

يفترض هذا المستند أنك تفهم الأفكار العامة التي تكمن وراء بروتوكول Google Data API وأنك على دراية بوحدة تحكم المشرف في Google Workspace. لمزيد من المعلومات حول وحدة تحكم المشرف، راجع استخدام وحدة تحكم المشرف.

البدء

إنشاء حساب

تم تفعيل واجهة برمجة تطبيقات إعدادات المشرف لحسابات Google Workspace. اشترِك للحصول على حساب Google Workspace لأغراض الاختبار. تستخدم خدمة "إعدادات المشرف" حسابات Google، لذلك إذا كنت تمتلك حسابًا على نطاق Google Workspace من قبل، فأنت جاهز للبدء.

لمحة عن أنواع خلاصات واجهة برمجة تطبيقات إعدادات المشرف

تسمح لك واجهة برمجة تطبيقات إعدادات المشرف بإدارة هذه الفئات من إعدادات النطاق:

إعدادات الدخول الموحّد

يتيح الدخول المُوحَّد (SSO) المستند إلى SAML للمستخدمين استخدام نفس معلومات تسجيل الدخول وكلمة المرور لكلٍ من الخدمات المُستضافة على Google Workspace والخدمات الأخرى التي تستضيفها في مؤسستك. عند استخدام الدخول المُوحَّد (SSO) على وجه التحديد، يعيد تطبيق الويب المستضاف، مثل Google Workspace، توجيه المستخدمين إلى موفِّر الهوية لمؤسستك من أجل مصادقة المستخدمين عند تسجيل الدخول. للحصول على معلومات تفصيلية، يُرجى الاطِّلاع على التعرُّف على الدخول المُوحَّد (SSO) المستنِد إلى SAML في Google Workspace.

تتضمّن عملية ضبط الدخول المُوحَّد (SSO) إدخال المعلومات اللازمة لخدمة Google Workspace للتواصل مع موفِّر الهوية الذي يخزّن معلومات تسجيل الدخول للمستخدمين، بالإضافة إلى إعداد الروابط التي يجب توجيه المستخدمين إليها لتسجيل الدخول والخروج وتغيير كلمات المرور. تسمح لك واجهة برمجة تطبيقات إعدادات المشرف بتحديث هذه الإعدادات واستردادها برمجيًا. تستخدم Google المفتاح العام الذي تم إنشاؤه للتحقُّق من طلب الدخول المُوحَّد (SSO) هذا مع موفِّر الهوية وأنه لم يتم تعديل استجابة SAML للمفتاح الخاص أثناء نقل الشبكة.

للحصول على مُلخَّص محدَّد قصير لواجهة برمجة التطبيقات لاستخدام إعدادات الدخول المُوحَّد (SSO)، احصل على شهادة المفتاح العام من موفِّر الهوية، وسجِّل المفتاح العام مع Google، واضبط إعدادات طلب البحث للدخول المُوحَّد (SSO) المستند إلى SAML. بالنسبة إلى رسائل الخطأ، يُرجى الاطِّلاع على تحديد مشاكل الدخول المُوحَّد (SSO) وحلّها:

  • إنشاء المفاتيح -- باستخدام موفِّر الهوية، يمكنك إنشاء مجموعة من المفاتيح العامة والخاصة باستخدام خوارزميات DSA أو RSA. يكون المفتاح العام في شهادة بتنسيق X.509. لمزيد من المعلومات عن مفاتيح توقيع الدخول الموحَّد المستندة إلى SAML، يُرجى الاطِّلاع على إنشاء المفاتيح والشهادات لخدمة الدخول الموحَّد في Google Workspace.
  • التسجيل من خلال Google -- استخدم إعدادات الدخول الموحد لواجهة برمجة تطبيقات إعدادات المشرف لتسجيل شهادة المفتاح العام في Google.
  • تعيين إعدادات الدخول الموحد -- استخدم إعدادات الدخول الموحد لواجهة برمجة تطبيقات إعدادات المشرف لتهيئة الإعدادات المستخدمة للاتصال بخوادم موفر هوية النطاق.

إعدادات المدخل والتوجيه

تتيح هذه الخلاصة لمشرفي النطاق التحكم في توجيه البريد الإلكتروني لنطاقاتهم.

تتيح عمليات توجيه البريد الإلكتروني للمشرفين تحديد إعدادات توجيه البريد الإلكتروني على مستوى النطاق. ويشبه هذا وظيفة توجيه البريد الإلكتروني لإعدادات Gmail في وحدة تحكم المشرف. لمزيد من المعلومات، راجع توجيه البريد الإلكتروني وتهيئة التسليم الثنائي لميزة توجيه البريد الإلكتروني.

نموذج لطلب ورد في واجهة برمجة التطبيقات لإعدادات المشرف بتنسيق XML

يقدم هذا المستند أمثلة عن الشفرة لطلبات واجهة برمجة تطبيقات إعدادات المشرف الأساسية واستجاباتها باستخدام XML وHTTP الأولي. يوضح مثال اللغة الافتراضية لهذا النطاق بنية XML وHTTP الكاملة لنص إدخال الطلب والاستجابة، وهو أمر شائع لكل عملية:

لتغيير إعداد مدخل البريد الإلكتروني الصادر للنطاق، أرسل HTTP PUT إلى عنوان URL لخلاصة المدخل:

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/email/gateway

إن اللغة الافتراضية للنطاق PUT لطلب AtomPub entry XML هي:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
  xmlns:apps='http://schemas.google.com/apps/2006'>
  <apps:property name='smartHost' value='smtp.out.domain.com' />
  <apps:property name='smtpMode' value='SMTP' />
</atom:entry>

باستثناء الخصائص والقيم الخاصة بالعمليات، تمثّل عناصر atom:property زوجًا واحدًا من المفاتيح والقيمة يحتوي على معلومات حول موقع إلكتروني تريد استرداده أو تعديله. هذه الإعدادات شائعة في جميع نصوص طلبات واجهة برمجة تطبيقات إعدادات المشرف.

يعرض عنصر استجابة اللغة التلقائية في النطاق entry السمتَين smartHost وsmtpMode إلى جانب بنية XML الشائعة في جميع نصوص استجابة واجهة برمجة تطبيقات إعدادات المشرف:

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<id>https://apps-apis.google.com/a/feeds/domain/2.0/domainName/email/gateway</id>
<updated>2008-12-17T23:59:23.887Z</updated>
<link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/domain/
  2.0/domainName/email/gateway'/>
<link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/domain/
  2.0/domainName/email/gateway'/>
<apps:property name='smartHost' value='smtp.out.domain.com' />
<apps:property name='smtpMode' value='SMTP' />
</entry>

إدارة إعدادات الدخول الموحّد

تتيح ميزة الدخول الموحّد (SSO) في Google Workspace للمستخدمين تسجيل الدخول إلى خدمات متعددة مع الحاجة إلى تسجيل الدخول وكلمة المرور مرة واحدة فقط. يتم تخزين كلمة المرور هذه من خلال موفِّر هوية النطاق، وليس من خلال Google Workspace. لمزيد من المعلومات، راجع صفحة الدخول الموحد في مركز المساعدة. توضح الأقسام التالية تنسيق XML المستخدم لإعدادات الدخول الموحّد.

استرداد إعدادات الدخول الموحّد

لاسترداد إعدادات الدخول الموحّد، أرسل HTTP GET إلى عنوان URL للخلاصة العامة للدخول الموحّد (SSO)، وضمّن رأس Authorization كما هو موضح في المصادقة إلى خدمة إعدادات المشرف. وبالنسبة إلى رسائل الخطأ، يُرجى الاطِّلاع على تحديد مشاكل الدخول المُوحَّد (SSO) وحلّها:

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/sso/general

لا تحتوي هذه العملية على معلمات في نص الطلب.

تعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub مع إعدادات الدخول الموحّد للنطاق.

تعرض XML لاستجابة GET السمات samlSignonUri وsamlLogoutUri وchangePasswordUri وenableSSO وssoWhitelist وuseDomainSpecificIssuer:

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<apps:property name='samlSignonUri' value='http://www.example.com/sso/signon'/>
...
<apps:property name='samlLogoutUri' value='http://www.example.com/sso/logout'/>
<apps:property name='changePasswordUri' value='http://www.example.com/sso/changepassword'/>
<apps:property name='enableSSO' value='true'/>
<apps:property name='ssoWhitelist' value='CIDR formatted IP address'/>
<apps:property name='useDomainSpecificIssuer' value='false'/>
</entry>

تشمل الخصائص ما يلي:

samlSignonUri
عنوان URL لموفِّر الهوية حيث ترسل Google Workspace طلب SAML لمصادقة المستخدم.
samlLogoutUri
العنوان الذي سيتم توجيه المستخدمين إليه عند تسجيل الخروج من تطبيق الويب.
تغيير كلمة المرور
العنوان الذي سيتم توجيه المستخدمين إليه عندما يريدون تغيير كلمة مرور الدخول الموحّد (SSO) لتطبيق الويب.
تفعيل الدخول الموحّد
يمكّن الدخول الموحّد (SSO) المستند إلى SAML لهذا النطاق. في حال ضبط إعدادات الدخول المُوحَّد سابقًا، وضبطت enableSSO لاحقًا على enableSSO=false، ستظل الإعدادات التي أدخلتها في السابق محفوظة.
إضافة إلى القائمة البيضاء
الإدراج في القائمة البيضاء هو عنوان IP لقناع الشبكة بتنسيق التوجيه بين النطاقات بدون فئات (CIDR). تحدِّد ssoWhitelist المستخدمين الذين يسجِّلون الدخول باستخدام الدخول المُوحَّد (SSO) والمستخدمين الذين يسجِّلون الدخول باستخدام صفحة مصادقة حساب Google Workspace. في حال عدم تحديد أقنعة، سيسجِّل جميع المستخدمين الدخول باستخدام الدخول المُوحَّد (SSO). لمزيد من المعلومات، راجِع آلية عمل أقنعة الشبكة.
استخدام جهة إصدار خاصة بالنطاق
يمكن استخدام جهة إصدار مُحدَّدة للنطاق في طلب SAML المُقدَّم إلى موفِّر الهوية. على الرغم من أنها ليست ضرورية لمعظم عمليات نشر الدخول المُوحَّد (SSO)، إلا أن هذه الميزة مفيدة في الشركات الكبيرة التي تستخدم موفِّر هوية واحدًا لمصادقة مؤسسة بأكملها ذات نطاقات فرعية متعددة. ويؤدي منح جهة إصدار النطاق المحدّدة إلى تحديد النطاق الفرعي الذي سيتم ربطه بالطلب. لمزيد من المعلومات، راجِع كيف يعمل عنصر جهة الإصدار في طلب SAML؟

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

تحديث إعدادات الدخول الموحّد

لتحديث إعدادات الدخول الموحّد (SSO) للنطاق، يجب أولاً استرداد إعدادات الدخول الموحّد (SSO) باستخدام عملية استرداد إعدادات الدخول الموحّد، ثم تعديلها، ثم إرسال طلب PUT إلى عنوان URL لخلاصة الدخول الموحّد (SSO). تأكد من أن قيمة <id> في الإدخال الذي تم تحديثه تطابق تمامًا <id> مع الإدخال الحالي. ضمِّن رأس Authorization كما هو موضح في المصادقة على خدمة واجهة برمجة تطبيقات إعدادات المشرف. وبالنسبة إلى رسائل الخطأ، يُرجى الاطِّلاع على تحديد مشاكل الدخول المُوحَّد (SSO) وحلّها.

عند تعديل إعدادات الدخول الموحّد، أرسل HTTP PUT إلى عنوان URL للخلاصة العامة للدخول الموحّد (SSO):

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/sso/general

نص XML لطلب PUT هو:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<apps:property name='enableSSO' value='false' />
<apps:property name='samlSignonUri' value='http://www.example.com/sso/signon' />
<apps:property name='samlLogoutUri' value='http://www.example.com/sso/logout' />
<apps:property name='changePasswordUri' value='http://www.example.com/sso/changepassword' />
<apps:property name='ssoWhitelist' value='127.0.0.1/32' />
<apps:property name='useDomainSpecificIssuer' value='false'/>
</atom:entry>

تعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub مع إعدادات الدخول الموحّد.

إنّ رمز XML لاستجابة PUT هو:

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
...
<apps:property name='samlSignonUri' value='http://www.example.com/sso/signon'/>
<apps:property name='samlLogoutUri' value='http://www.example.com/sso/logout'/>
<apps:property name='changePasswordUri' value='http://www.example.com/sso/changepassword'/>
<apps:property name='enableSSO' value='false'/>
<apps:property name='ssoWhitelist' value='127.0.0.1/32'/>
<apps:property name='useDomainSpecificIssuer' value='false'/>
</entry>

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

استرداد مفتاح توقيع الدخول الموحّد

لاسترداد مفتاح توقيع الدخول الموحّد، أرسل HTTP GET إلى عنوان URL لخلاصة مفتاح الدخول الموحّد (SSO)، وضمّن رأس Authorization كما هو موضح في المصادقة إلى خدمة إعدادات المشرف. وبالنسبة إلى رسائل الخطأ، يُرجى الاطِّلاع على تحديد مشاكل الدخول المُوحَّد (SSO) وحلّها:

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/sso/signingkey

لا تحتوي هذه العملية على معلمات في نص الطلب.

تعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub مع مفتاح التوقيع.

تعرض XML لاستجابة GET الخاصية signingKey:

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
...
<apps:property name='signingKey' value='yourBase64EncodedPublicKey'/>
</entry>

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

تحديث مفتاح تسجيل الدخول الموحّد

لتعديل مفتاح توقيع الدخول الموحّد (SSO) لأحد النطاقات، عليك أولاً استرداد مفتاح التوقيع باستخدام عملية استرداد مفتاح توقيع الدخول الموحّد، ثم تعديله، ثم إرسال طلب PUT إلى عنوان URL لخلاصة توقيع الدخول الموحّد (SSO). تأكد من أن قيمة <id> في الإدخال الذي تم تحديثه تطابق تمامًا <id> مع الإدخال الحالي. لمزيد من المعلومات عن مفاتيح توقيع الدخول الموحَّد المستندة إلى SAML، يُرجى الاطِّلاع على إنشاء المفاتيح والشهادات لخدمة الدخول الموحَّد في Google Workspace.

عند تحديث مفتاح توقيع الدخول الموحّد، أرسل HTTP PUT إلى عنوان URL لخلاصة مفتاح الدخول الموحّد (SSO):

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/sso/signingkey

إنّ XML الخاص بطلب PUT هو:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps="http://schemas.google.com/apps/2006">
<apps:property name='signingKey' value='yourBase64EncodedPublicKey'/>
</atom:entry>

إدارة مدخل البريد الإلكتروني وتوجيهه

يوضح قسم مدخل البريد الإلكتروني الصادر كيفية دعم واجهة برمجة تطبيقات إعدادات المشرف لتوجيه البريد الصادر من المستخدمين في نطاقك. يوضح قسم توجيه البريد الإلكتروني كيفية توجيه الرسائل إلى خادم بريد آخر.

استرداد إعدادات مدخل البريد الإلكتروني الصادر

لاسترداد إعدادات مدخل البريد الإلكتروني الصادر، أرسل GET HTTP إلى عنوان URL لخلاصة البوابة، وضمّن رأس Authorization كما هو موضح في المصادقة إلى خدمة إعدادات المشرف:

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/email/gateway

لا تحتوي هذه العملية على معلمات في نص الطلب.

وتعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub مع معلومات حالة مدخل البريد الإلكتروني.

تعرض الاستجابة GET السمتَين smartHost وsmtpMode. لمزيد من المعلومات حول هذه المواقع، راجع تحديث إعدادات مدخل البريد الإلكتروني الصادر.

من أمثلة الردود المحتملة:

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
...
<apps:property name='smartHost' value='smtpout.domain.com'/>
<apps:property name='smtpMode' value='SMTP'/>
</entry>

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

تحديث إعدادات مدخل البريد الإلكتروني الصادر

لتعديل إعداد مدخل البريد الإلكتروني الصادر للنطاق، أرسِل طلب HTTP PUT إلى عنوان URL لخلاصة المدخل:

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/email/gateway

إنّ XML الخاص بطلب PUT هو:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps="http://schemas.google.com/apps/2006">
<apps:property name='smartHost' value='smtp.out.domain.com' />
<apps:property name='smtpMode' value='SMTP' />
</atom:entry>

خصائص الطلب هي:

مُضيف ذكي
إما عنوان IP أو اسم المضيف لخادم SMTP. توجه Google Workspace البريد الصادر إلى هذا الخادم.
وضع smtp
القيمة التلقائية هي SMTP. وتعمل قيمة أخرى، SMTP_TLS، على تأمين اتصال مع طبقة النقل الآمنة عند تسليم الرسالة.

تعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub مع حالة إعدادات مدخل البريد الإلكتروني.

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

إدارة إعدادات توجيه البريد الإلكتروني

أولاً، أنشئ طلب XML:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps="http://schemas.google.com/apps/2006">
<apps:property name='routeDestination' value='route-smtp.domain.com'/>
<apps:property name='routeRewriteTo' value='true'/>
<apps:property name='routeEnabled' value='true'/>
<apps:property name='bounceNotifications' value='true'/>
<apps:property name='accountHandling' value='can be either allAccounts | provisionedAccounts | unknownAccounts'/>
</atom:entry>

خصائص الطلب هي:

مسار الوجهة
هذه الوجهة هي اسم المضيف أو عنوان IP لخادم بريد SMTP-In الذي يتم توجيه البريد الإلكتروني إليه. يجب حل اسم المضيف أو عنوان IP لـ Google. للتعرُّف على مزيد من التفاصيل عن حل أسماء مضيفي البريد، يُرجى الاطِّلاع على تجربة Google Workspace باستخدام توجيه البريد الإلكتروني.
مسار إعادة الكتابة إلى
في حالة التعيين على "true"، يتم تغيير حقل to: لمغلف SMTP إلى اسم المضيف الوجهة (اسم مضيف user@destination)، ويتم تسليم الرسالة إلى عنوان المستخدم هذا على خادم البريد الوجهة. إذا false، فسيتم تسليم البريد الإلكتروني إلى عنوان البريد الإلكتروني to: للرسالة الأصلية (user@original اسم المضيف) على خادم البريد الوجهة. ويشبه هذا إعداد "تغيير مغلف SMTP" لوحدة تحكم المشرف. لمزيد من المعلومات، يُرجى الاطِّلاع على إعدادات النطاق لتوجيه البريد الإلكتروني.
المسار مفعّل
إذا كانت true، فسيتم تمكين وظيفة توجيه البريد الإلكتروني. وإذا كانت false، سيتم إيقاف الوظيفة.
إشعارات الارتداد
في حال true، يتم تفعيل Google Workspace لإرسال إشعارات بارتداد الرسائل إلى المُرسِل عند تعذُّر التسليم.
التعامل مع الحساب

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

  • allAccounts -- تسليم كل الرسائل الإلكترونية إلى هذه الوجهة.
  • provisionedAccounts -- تسليم البريد إلى هذه الوجهة إذا كان المستخدم موجودًا في Google Workspace.
  • unknownAccounts -- تسليم البريد إلى هذه الوجهة إذا لم يكن المستخدم موجودًا في Google Workspace. وهذا مماثل لإعداد "تسليم البريد الإلكتروني لـ" في وحدة تحكم المشرف. لمزيد من المعلومات حول المتطلبات الأساسية وكيفية استخدام توجيه البريد، راجع إعدادات النطاق لتوجيه البريد الإلكتروني. ~ لنشر هذا الطلب، أرسِل HTTP POST إلى عنوان URL لخلاصة توجيه البريد الإلكتروني، وضمِّن رأس Authorization كما هو موضّح في المصادقة على خدمة "إعدادات المشرف":

https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/emailrouting

تعرض الاستجابة الناجحة رمز حالة HTTP 200 OK، بالإضافة إلى خلاصة AtomPub التي تحتوي على معلومات الأرشيف.

وإذا تعذّر تنفيذ طلبك لسبب ما، يتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز الحالة في Google Data API، يُرجى الاطّلاع على رموز حالة HTTP.

انتهاء العمل بنقاط النهاية في 31 تشرين الأول (أكتوبر) 2018

تم إيقاف نقاط النهاية التالية كجزء من هذا الإعلان. كانت تُغرِق في 31 تشرين الأول (أكتوبر) 2018، ولم تعُد متوفرة.

  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/general/defaultLanguage
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/general/organizationName
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/general/currentNumberOfUsers
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/general/maximumNumberOfUsers
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/supportPIN
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/customerPIN
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/adminSecondaryEmail
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/edition
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/creationTime
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/accountInformation/countryCode
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/appearance/customLogo
  • https://apps-apis.google.com/a/feeds/domain/2.0/{domainName}/verification/mx