نظرة عامة على Admin Settings API

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

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

تنفّذ واجهة برمجة التطبيقات لإعدادات المشرفين بروتوكول واجهة برمجة تطبيقات بيانات المستخدم على Google. تتوافق واجهة برمجة تطبيقات بيانات المستخدم على Google مع نموذج النشر والتعديل في Atom Publishing Protocol (AtomPub). تستخدم طلبات HTTP في AtomPub أسلوب تصميم Representational Set Transfer (RESTful) لخدمات الويب. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوّرين لواجهات برمجة تطبيقات بيانات المستخدم على Google.

الجمهور

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

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

البدء

لبدء استخدام واجهة برمجة التطبيقات لإعدادات المشرفين، عليك أولاً إعداد حسابك.

إنشاء حساب

تكون واجهة برمجة التطبيقات لإعدادات المشرفين مفعّلة لحسابات Google Workspace. يمكنك الاشتراك في حساب على Google Workspace لأغراض الاختبار. تستخدم خدمة "إعدادات المشرف" Google Accounts، لذا إذا كان لديك حساب على نطاق 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. لمزيد من المعلومات عن مفاتيح التوقيع في خدمة الدخول الموحّد (SSO) المستنِدة إلى SAML، يُرجى الاطّلاع على إنشاء المفاتيح والشهادات لخدمة الدخول الموحّد (SSO) في Google Workspace.
• التسجيل لدى Google: يمكنك استخدام إعدادات الدخول الموحّد (SSO) في واجهة برمجة التطبيقات لإعدادات المشرفين لتسجيل شهادة المفتاح العام لدى Google.
• إعداد إعدادات الدخول الموحّد (SSO): يمكنك استخدام إعدادات الدخول الموحّد (SSO) في واجهة برمجة التطبيقات لإعدادات المشرفين لضبط الإعدادات المستخدَمة للتواصل مع خوادم موفِّر الهوية في النطاق.

ملاحظة: بالنسبة إلى البروتوكولات التي لا تستخدم تدفق تسجيل الدخول المستنِد إلى الويب، مثل بعض برامج البريد الإلكتروني المستنِدة إلى POP/IMAP، يسجِّل المستخدمون الدخول مباشرةً باستخدام اسم المستخدم وكلمة المرور لحساب Google Workspace.

إعدادات المدخل

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

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

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

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

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

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

تنسيق XML لطلب PUT في AtomPub entry للغة التلقائية للنطاق هو:

<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)

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

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

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

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

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

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

يعرض تنسيق 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

العنوان الذي سيتم إرسال المستخدمين إليه عند تسجيل الخروج من تطبيق الويب.

changePasswordUri

العنوان الذي سيتم إرسال المستخدمين إليه عندما يريدون تغيير كلمة مرور الدخول الموحّد (SSO) لتطبيق الويب.

enableSSO

تفعيل خدمة الدخول الموحّد (SSO) المستنِدة إلى SAML لهذا النطاق. إذا سبق لك ضبط إعدادات الدخول الموحّد (SSO)، ثم ضبطت enableSSO على enableSSO=false، سيتم الاحتفاظ بالإعدادات التي أدخلتها سابقًا.

ssoWhitelist

قناع الشبكة هو عنوان IP بتنسيق التوجيه بين النطاقات بدون فئات (CIDR). يحدّد ssoWhitelist المستخدمين الذين يسجّلون الدخول باستخدام خدمة الدخول الموحّد (SSO) والمستخدمين الذين يسجّلون الدخول باستخدام صفحة مصادقة حساب Google Workspace. إذا لم يتم تحديد أي أقنعة، سيسجِّل جميع المستخدمين الدخول باستخدام خدمة الدخول الموحّد (SSO). لمزيد من المعلومات، يُرجى الاطّلاع على آلية عمل أقنعة الشبكة.

useDomainSpecificIssuer

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

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

تعديل إعدادات الدخول الموحّد (SSO)

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

عند تعديل إعدادات الدخول الموحّد (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 تتضمّن إعدادات الدخول الموحّد (SSO).

تنسيق 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، يُرجى الاطّلاع على رموز حالة HTTP.

لا يُسمح بإجراء تغييرات على إعدادات الدخول الموحّد (SSO) عندما يكون العميل المستهدَف قد فعّل ميزة "موافقة جهات متعددة" للإجراءات الحسّاسة. ستفشل الطلبات مع errorCode="1811" و reason="LegacyInboundSsoChangeNotAllowedWithMultiPartyApproval".

استرداد مفتاح التوقيع في خدمة الدخول الموحّد (SSO)

لاسترداد مفتاح التوقيع في خدمة الدخول الموحّد (SSO)، يمكنك إرسال طلب 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، يُرجى الاطّلاع على رموز حالة HTTP.

تعديل مفتاح التوقيع في خدمة الدخول الموحّد (SSO)

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

عند تعديل مفتاح التوقيع في خدمة الدخول الموحّد (SSO)، يمكنك إرسال طلب 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>

ملاحظة: يجب توفّر سمة signingKey لهذا الطلب.

لا يُسمح بإجراء تغييرات على إعدادات الدخول الموحّد (SSO) عندما يكون العميل المستهدَف قد فعّل ميزة "موافقة جهات متعددة" للإجراءات الحسّاسة. ستفشل الطلبات مع errorCode="1811" و reason="LegacyInboundSsoChangeNotAllowedWithMultiPartyApproval".

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

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

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

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

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

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

**ملاحظة:** يجب أن يكون لديك إصدار مؤهَّل من Google Workspace لاستخدام ميزة مدخل البريد الصادر في Google Workspace.

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

تعرض استجابة GET سمتَي smartHost وsmtpMode. لمزيد من المعلومات عن هاتَين السمتَين، يُرجى الاطّلاع على تعديل إعدادات مدخل البريد الإلكتروني الصادر settings.

في ما يلي مثال على استجابة محتمَلة:

<?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، يُرجى الاطّلاع على رموز حالة HTTP.

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

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

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

ملاحظة: يجب أن يكون لديك إصدار مؤهَّل من Google Workspace لاستخدام ميزة مدخل البريد الصادر في Google Workspace.

تنسيق 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>

سمات الطلب هي:

smartHost

عنوان IP أو اسم مضيف خادم SMTP. يوجه Google Workspace البريد الصادر إلى هذا الخادم.

smtpMode

القيمة التلقائية هي SMTP. تؤدي قيمة أخرى، وهي SMTP_TLS، إلى تأمين الاتصال باستخدام بروتوكول أمان طبقة النقل (TLS) عند تسليم الرسالة.

ملاحظة: يُرجى اتّباع تعليمات وكيل نقل البريد لإعداد البريد الإلكتروني المُعاد توجيهه والمرسَل من Google Workspace.

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

**ملاحظة:** يمكنك إرسال رسالة إلكترونية من Google Workspace إلى مستخدم خارج نطاقك للتحقّق من أنّ البريد الصادر المرسَل من خلال المدخل يعمل بعد إجراء التغييرات.

إذا تعذّر تنفيذ طلبك لسبب ما، سيتم عرض رمز حالة مختلف. لمزيد من المعلومات عن رموز حالة واجهة برمجة تطبيقات بيانات المستخدم على Google، يُرجى الاطّلاع على رموز حالة 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