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 جميع الوحدات التنظيمية الفرعية والوحدة التنظيمية المحدّدة (الجذر إذا لم يتم تحديده)