Method: orgunits.list

لاسترداد قائمة بجميع الوحدات التنظيمية لحساب.

طلب HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/orgunits

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
customerId

string

المعرّف الفريد لحساب العميل على Google Workspace بصفتك مشرفًا للحساب، يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني my_customer لتمثيل النطاق customerId في حسابك. يتم أيضًا عرض customerId كجزء من مورد المستخدمين.

معلمات طلب البحث

المَعلمات
orgUnitPath

string

المسار الكامل للوحدة التنظيمية أو رقم تعريفها الفريد لعرض العناصر الثانوية للوحدة التنظيمية المحددة.
type

enum (Type)

تحديد ما إذا كان سيتم إرجاع جميع المؤسسات الفرعية أو المؤسسات الفرعية المباشرة فقط.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الوحدة التنظيمية، يكون النوع هو admin#directory#orgUnits.
etag

string

علامة ETag للمورد.
organizationUnits[]

object (OrgUnit)

قائمة بكائنات الوحدة التنظيمية.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://apps-apis.google.com/a/feeds/policies/
  • https://www.googleapis.com/auth/admin.directory.orgunit
  • https://www.googleapis.com/auth/admin.directory.orgunit.readonly

لمزيد من المعلومات، راجِع دليل التفويض.

Type

عمليات التعداد
ALL جميع الوحدات التنظيمية الفرعية.
CHILDREN الأطفال الفوريون فقط (الإعداد التلقائي)
ALL_INCLUDING_PARENT جميع الوحدات التنظيمية الفرعية والوحدة التنظيمية المحددة (الجذر في حال عدم تحديده).