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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

النوع

عمليات التعداد
ALL جميع الوحدات التنظيمية الفرعية
CHILDREN الأبناء المباشرون فقط (الإعداد التلقائي)
ALL_INCLUDING_PARENT جميع الوحدات التنظيمية الفرعية والوحدة التنظيمية المحدّدة (الوحدة الأساسية في حال عدم تحديدها)